/usr/include/KDb3/KDbGlobal.h is in libkdb3-dev 3.1.0-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 | /* This file is part of the KDE project
Copyright (C) 2003-2015 Jarosław Staniek <staniek@kde.org>
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public License
along with this program; see the file COPYING. If not, write to
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef KDBGLOBAL_H
#define KDBGLOBAL_H
#include "kdb_version.h"
#include <QString>
/*! @file KDbGlobal.h
Global public definitions
*/
/**
* @brief Make a number from the major, minor and release number of a KDb version
*
* This function can be used for preprocessing when KDB_IS_VERSION is not
* appropriate.
*/
#define KDB_MAKE_VERSION( a,b,c ) (((a) << 16) | ((b) << 8) | (c))
/**
* @brief Check if the KDb version matches a certain version or is higher
*
* This macro is typically used to compile conditionally a part of code:
* @code
* #if KDB_IS_VERSION(3, 1, 0)
* // Code for KDb 3.1
* #else
* // Code for KDb older than 3.1
* #endif
* @endcode
*
* @warning Especially during development phases of KDb, be careful
* when choosing the version number that you are checking against.
* Otherwise you might risk to break the next KDb release.
* Therefore be careful that development version have a
* version number lower than the released version, so do not check
* e.g. for KDb 3.1 with KDB_IS_VERSION(3, 1, 0)
* but with the actual version number at a time a needed feature was introduced,
* e.g. KDB_IS_VERSION(3, 0, 90) for beta 3.1
*/
#define KDB_IS_VERSION(a,b,c) ( KDB_VERSION >= KDB_MAKE_VERSION(a,b,c) )
/*! @namespace KDb
@brief A database connectivity and creation framework
KDb is consisted of a general-purpose C++ Qt library and set of plugins delivering support
for various database vendors.
@section Framework
KDbDriverManager
KDbDriverMetaData
KDbDriver
Database access
- KDbConnection
- KDbConnectionData
- KDbTransaction
- KDbRecordEditBuffer
- KDbPreparedStatement
Database structure
- Schema
- KDbTableSchema
- KDbQuerySchema
- KDbQuerySchemaParameter
- KDbQueryColumnInfo
- KDbTableOrQuerySchema
- KDbIndexSchema
- KDbFieldList
- KDbLookupFieldSchema
- KDbRelationship
- KDbParser
- KDbExpression
Data representation
- KDbField
- KDbRecordData
- KDbTableViewData
- KDbTableViewColumn
Tools
- KDbObject
- KDbEscapedString
- KDbMessageHandler
- KDbProperties
- KDbAdmin
- KDbAlter
- KDbValidator
- KDbUtils
@section Drivers
Drivers are loaded as plugins on demand by KDbDriverManager. The IDs, descriptions
and other details about drivers are given in their metadata by KDbDriverManager::driverMetaData().
The metadata is accessible without actually loading any driver.
KDb supports two families of databases, file and network-based while providing a single
uniform API.
Each database driver implements of three main classes KDbDriver, KDbConnection, KDbCursor.
The driver classes handle database-related specifics such as data types, naming and hide
them behind a general purpose API. The connection classes act as a proxy between the KDb API
and the native database. The cursor classes implement cursor functionality specific to
the native database at record level.
*/
namespace KDb
{
/*! Object types set like table or query. */
enum ObjectType {
UnknownObjectType = -1, //!< helper
AnyObjectType = 0, //!< helper
TableObjectType = 1,
QueryObjectType = 2,
LastObjectType = 2, //ALWAYS UPDATE THIS
KDbSystemTableObjectType = 128, //!< helper, not used in storage
//!< (allows to select KDb system tables
//!< may be or'd with TableObjectType)
IndexObjectType = 256 //!< special
};
//! Escaping type for identifiers.
enum IdentifierEscapingType {
DriverEscaping, //!< Identifiers are escaped by driver
KDbEscaping //!< Identifiers are escaped using KDb's generic convention
};
//! A property of numeric values
enum Signedness
{
Signed = 0, //!< Values can be both positive and negative
Unsigned = 1 //!< Values can be both non-negative
};
}
//! Macros for marking future Qt tr() translations.
#ifndef futureTr
# define futureTr QString
# define futureTr2(a,b) QString(b)
#endif
//! Macros for marking future QT_TR_NOOP translations.
#ifndef FUTURE_TR_NOOP
# define FUTURE_TR_NOOP(x) (x)
#endif
#ifndef WARNING
#ifdef _MSC_VER
/* WARNING preprocessor directive
Reserved: preprocessor needs two indirections to replace __LINE__ with actual
string
*/
#define _MSG0(msg) #msg
/* Preprocessor needs two indirections to replace __LINE__ or __FILE__
with actual string. */
#define _MSG1(msg) _MSG0(msg)
/*! Creates message prolog with the name of the source file and the line
number where a preprocessor message has been inserted.
Example:
#pragma KMESSAGE(Your message)
Output:
C:\MyCode.cpp(111) : Your message
*/
# define _MSGLINENO __FILE__ "(" _MSG1(__LINE__) ") : warning: "
# define KDB_WARNING(msg) message(_MSGLINENO #msg)
#endif /*_MSC_VER*/
#endif /*WARNING*/
#endif
|