include/util-func.h

   1 /*
   2  * libslp-db-util
   3  *
   4  * Copyright (c) 2000 - 2011 Samsung Electronics Co., Ltd. All rights reserved.
   5  *
   6  * Contact: Hakjoo Ko <hakjoo.ko@samsung.com>
   7  *
   8  * Licensed under the Apache License, Version 2.0 (the "License");
   9  * you may not use this file except in compliance with the License.
  10  * You may obtain a copy of the License at
  11  *
  12  * http://www.apache.org/licenses/LICENSE-2.0
  13  *
  14  * Unless required by applicable law or agreed to in writing, software
  15  * distributed under the License is distributed on an "AS IS" BASIS,
  16  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  17  * See the License for the specific language governing permissions and
  18  * limitations under the License.
  19  *
  20  */
  21
  22 #ifndef __UTIL_FUNC_H__
  23 #define __UTIL_FUNC_H__
  24
  25 #ifdef __cplusplus
  26 extern "C" {
  27 #endif
  28
  29 #include <db-util-common.h>
  30
  31 #define DB_UTIL_REGISTER_HOOK_METHOD    0x00000001
  32 #define DB_UTIL_LUCENE_INDEX            0x00000002
  33
  34 /**
  35 * @defgroup StorageFW Storage Framework
  36 * In order to support applications using DB
  37 */
  38
  39 /**
  40  * @defgroup DB_UTIL
  41  * @ingroup StorageFW
  42  * @{
  43  */
  44
  45
  46
  47 /**
  48  * @brief invoke sqlite3_open with platform common configuration
  49  * @details register busy handler, create localized collation
  50  * @param [in] database file name (UTF-8)
  51  * @param [out] SQLite database handle
  52  * @param [in] option value
  53  * @return sqlite3 function return value will be returned
  54  * @see db_util_open_with_options()
  55  * @see db_util_close()
  56  *
  57  */
  58 EXPORT_API int db_util_open(const char *pszFilePath, sqlite3 **ppDB,
  59                                                 int nOption);
  60
  61 /**
  62  * @brief invoke sqlite3_open_v2 with platform common configuration
  63  * @details register busy handler, create localized collation
  64  * @param [in] database file name (UTF-8)
  65  * @param [out] SQLite database handle
  66  * @param [in] sqlite3_open_v2 flags
  67  * @param [in] Name of VFS module to use
  68  * @return sqlite3 function return value will be returned
  69  * @see db_util_open()
  70  * @see db_util_close()
  71  *
  72  */
  73 EXPORT_API int db_util_open_with_options(const char *pszFilePath,
  74                                                 sqlite3 **ppDB, int flags,
  75                                                 const char *zVfs);
  76
  77 /**
  78  * @brief closing a database connection
  79  * @param [in] SQLite database handle
  80  * @return sqlite3_close function return value will be returned
  81  * @see db_util_open()
  82  * @see db_util_open_with_options()
  83  *
  84  */
  85 EXPORT_API int db_util_close(sqlite3 *ppDB);
  86
  87 /**
  88 *@}
  89 */
  90
  91 #ifdef __cplusplus
  92 }
  93 #endif
  94 #endif  /* __UTIL_FUNC_H__ */