24 #ifndef _QORE_QORELIB_H
26 #define _QORE_QORELIB_H
29 #include <qore/QoreThreadLock.h>
30 #include <qore/qore_bitopts.h>
31 #include <qore/safe_dslist>
39 #include <sys/types.h>
45 #undef _QORE_HAS_QORE_XMLNODE_CLASS
49 #undef _QORE_HAS_QORE_XMLREADER_CLASS
52 #undef _QORE_HAS_QORE_XMLDOC_CLASS
55 #define _QORE_HAS_HARD_TYPING 1
58 #define _QORE_HAS_DBI_EXECRAW 1
61 #define _QORE_HAS_TIME_ZONES 1
64 #define _QORE_HAS_THREAD_RESOURCE_IDS 1
67 #define _QORE_HAS_PREPARED_STATMENT_API 1
70 #define _QORE_HAS_DATASOURCE_ACTIVETRANSACTION 1
73 #define _QORE_HAS_DBI_SELECT_ROW 1
76 #define _QORE_HAS_NUMBER_TYPE 1
79 #define _QORE_HAS_PATH_IS_READABLE 1
82 #define _QORE_HAS_DBI_OPTIONS 1
85 #define _QORE_HAS_FIND_CREATE_TIMEZONE 1
88 #define _QORE_HAS_NUMBER_CONS_WITH_PREC 1
91 #define _QORE_HAS_FILE_OBJECT_HELPER 1
94 #define _QORE_HAS_QUEUE_OBJECT_HELPER 1
97 #define _QORE_HAS_QOREHTTPCLIENTOBJECT 1
100 #define _QORE_HAS_DBI_DESCRIBE 1
103 #define _QORE_HAS_DBI_EVENTS 1
106 #define QC_NO_FLAGS 0
107 #define QC_NOOP (1 << 0)
108 #define QC_USES_EXTRA_ARGS (1 << 1)
109 #define QC_CONSTANT_INTERN (1 << 2)
110 #define QC_DEPRECATED (1 << 3)
111 #define QC_RET_VALUE_ONLY (1 << 4)
112 #define QC_RUNTIME_NOOP (1 << 5)
115 #define QC_CONSTANT (QC_CONSTANT_INTERN | QC_RET_VALUE_ONLY)
127 DLLEXPORT
struct tm *
q_localtime(
const time_t *clock,
struct tm *tms);
130 DLLEXPORT
struct tm *
q_gmtime(
const time_t *clock,
struct tm *tms);
148 DLLEXPORT
char *
q_dirname(
const char *path);
151 DLLEXPORT
void *
q_realloc(
void *ptr,
size_t size);
153 #if (!defined _WIN32 && !defined __WIN32__) || defined __CYGWIN__
201 DLLLOCAL FeatureList& operator=(
const FeatureList&);
215 static inline char *
strchrs(
const char *str,
const char *chars) {
217 if (strchr(chars, *str))
225 static inline char *
strnchr(
const char *str,
int len,
char c) {
238 (*str) = tolower(*str);
334 class AbstractQoreZoneInfo;
348 DLLEXPORT
int tz_get_utc_offset(
const AbstractQoreZoneInfo* tz, int64 epoch_offset,
bool &is_dst,
const char *&zone_name);
350 DLLEXPORT
bool tz_has_dst(
const AbstractQoreZoneInfo* tz);
355 #define QORE_OPT_ATOMIC_OPERATIONS "atomic operations"
356 #define QORE_OPT_STACK_GUARD "stack guard"
358 #define QORE_OPT_SIGNAL_HANDLING "signal handling"
360 #define QORE_OPT_RUNTIME_STACK_TRACE "runtime stack tracing"
362 #define QORE_OPT_LIBRARY_DEBUGGING "library debugging"
364 #define QORE_OPT_SHA224 "openssl sha224"
366 #define QORE_OPT_SHA256 "openssl sha256"
368 #define QORE_OPT_SHA384 "openssl sha384"
370 #define QORE_OPT_SHA512 "openssl sha512"
372 #define QORE_OPT_MDC2 "openssl mdc2"
374 #define QORE_OPT_RC5 "openssl rc5"
376 #define QORE_OPT_MD2 "openssl md2"
378 #define QORE_OPT_TERMIOS "termios"
380 #define QORE_OPT_FILE_LOCKING "file locking"
382 #define QORE_OPT_UNIX_USERMGT "unix user management"
384 #define QORE_OPT_UNIX_FILEMGT "unix file management"
386 #define QORE_OPT_FUNC_ROUND "round()"
388 #define QORE_OPT_FUNC_TIMEGM "timegm()"
390 #define QORE_OPT_FUNC_SETEUID "seteuid()"
392 #define QORE_OPT_FUNC_SETEGID "setegid()"
394 #define QORE_OPT_FUNC_SYSTEM "system()"
396 #define QORE_OPT_FUNC_KILL "kill()"
398 #define QORE_OPT_FUNC_FORK "fork()"
400 #define QORE_OPT_FUNC_GETPPID "getppid()"
402 #define QORE_OPT_FUNC_STATVFS "statvfs()"
404 #define QORE_OPT_FUNC_SETSID "setsid()"
406 #define QORE_OPT_FUNC_IS_EXECUTABLE "is_executable()"
411 #define QO_ALGORITHM 1
412 #define QO_FUNCTION 2
440 #define QORE_MAX(a, b) ((a) > (b) ? (a) : (b))
443 #define QORE_MIN(a, b) ((a) < (b) ? (a) : (b))
445 #define QORE_PARAM_NO_ARG (NULL)
448 #ifndef QORE_PATH_MAX
449 #ifdef _XOPEN_PATH_MAX
450 #define QORE_PATH_MAX _XOPEN_PATH_MAX
452 #define QORE_PATH_MAX 1024
482 #endif // _QORE_QORELIB_H
DLLEXPORT const qore_option_s * qore_option_list
list of qore options
DLLEXPORT int64 q_epoch_us(int &us)
returns the seconds and microseconds from the epoch
DLLEXPORT const AbstractQoreZoneInfo * find_create_timezone(const char *name, ExceptionSink *xsink)
returns a time zone for the given region name or UTC offset given as a string ("+01:00") ...
STL-like list containing all presently-loaded Qore features.
Definition: QoreLib.h:195
defines string encoding functions in Qore
Definition: QoreEncoding.h:72
templated class for a double-ended singly-linked list that can be safely read from multiple threads w...
Definition: safe_dslist:129
DLLEXPORT BinaryNode * qore_deflate(void *ptr, unsigned long len, int level, ExceptionSink *xsink)
compresses data with the DEFLATE algorithm
This is the hash or associative list container type in Qore, dynamically allocated only...
Definition: QoreHashNode.h:41
DLLEXPORT void qore_setup_argv(int pos, int argc, char *argv[])
sets up the Qore ARGV and QORE_ARGV values
DLLEXPORT bool tz_has_dst(const AbstractQoreZoneInfo *tz)
returns true if the zone has daylight savings time ever
DLLEXPORT void qore_exit_process(int rc)
instead of calling "exit()", call qore_exit_process() to exit without risking a crash if other thread...
DLLEXPORT char * make_class_name(const char *fn)
function to try and make a class name out of a file path, returns a new string that must be free()ed ...
DLLEXPORT int getSecMinusOneInt(const AbstractQoreNode *a)
for getting an integer number of seconds, with -1 as the default, from either a relative time value o...
The base class for all value and parse types in Qore expression trees.
Definition: AbstractQoreNode.h:47
const qore_type_t NT_NOTHING
type value for QoreNothingNode
Definition: node_types.h:34
DLLEXPORT QoreStringNode * qore_gunzip_to_string(const BinaryNode *bin, const QoreEncoding *enc, ExceptionSink *xsink)
gunzips compressed data to a string
DLLEXPORT QoreHashNode * q_getgrnam(const char *name)
thread-safe version of getgrnam(): returns a Qore hash of the group information from the group name i...
DLLEXPORT QoreStringNode * q_vsprintf(const class QoreListNode *params, int field, int offset, class ExceptionSink *xsink)
a string formatting function that works with Qore data structures
DLLEXPORT BinaryNode * qore_bunzip2_to_binary(const BinaryNode *bin, ExceptionSink *xsink)
decompresses bzip2 data to a binary
DLLEXPORT int getMicroSecZeroInt(const AbstractQoreNode *a)
for getting an integer number of microseconds, with 0 as the default, from either a relative time val...
static void discard(AbstractQoreNode *n, ExceptionSink *xsink)
to deref an AbstractQoreNode (when the pointer may be 0)
Definition: QoreLib.h:292
DLLEXPORT int64 getSecZeroBigInt(const AbstractQoreNode *a)
for getting an integer number of seconds, with 0 as the default, from either a relative time value or...
bool value
the value of the option
Definition: QoreLib.h:419
DLLEXPORT BinaryNode * parseBase64(const char *buf, int len, ExceptionSink *xsink)
parses a string of base64-encoded data and returns a BinaryNode
DLLEXPORT const char * tz_get_region_name(const AbstractQoreZoneInfo *tz)
returns the reion name for the given time zone
DLLEXPORT QoreStringNode * qore_bunzip2_to_string(const BinaryNode *bin, const QoreEncoding *enc, ExceptionSink *xsink)
decompresses bzip2 data to a string
DLLEXPORT int64 q_epoch_ns(int &us)
returns the seconds and nanoseconds from the epoch
DLLEXPORT BinaryNode * qore_gzip(void *ptr, unsigned long len, int level, ExceptionSink *xsink)
gzips data
DLLEXPORT bool q_parse_bool(const AbstractQoreNode *n)
tries to parse a boolean value - standard conversion or uses q_parse_bool(const char*) if it's a stri...
DLLLOCAL FeatureList()
initialized by the library, constructor not exported
DLLEXPORT struct tm * q_localtime(const time_t *clock, struct tm *tms)
thread-safe version of "localtime()"
signed short qore_type_t
used to identify unique Qore data and parse types (descendents of AbstractQoreNode) ...
Definition: common.h:59
virtual DLLEXPORT const char * getTypeName() const =0
returns the type name as a c string
Qore's string type supported by the QoreEncoding class.
Definition: QoreString.h:42
Qore's string value type, reference counted, dynamically-allocated only.
Definition: QoreStringNode.h:40
DLLEXPORT int getMsZeroInt(const AbstractQoreNode *a)
for getting an integer number of milliseconds, with 0 as the default, from either a relative time val...
const char * option
name of the option
Definition: QoreLib.h:416
DLLEXPORT int qore_usleep(int64 usecs)
use this function instead of usleep(), as usleep() is not signal-safe on some platforms (ex: Solaris ...
definition of the elements in the qore_option_list
Definition: QoreLib.h:415
static bool is_nothing(const AbstractQoreNode *n)
to check if an AbstractQoreNode object is NOTHING
Definition: QoreLib.h:284
DLLEXPORT struct tm * q_gmtime(const time_t *clock, struct tm *tms)
thread-safe version of "gmtime()"
This is the list container type in Qore, dynamically allocated only, reference counted.
Definition: QoreListNode.h:44
DLLEXPORT char * q_basename(const char *path)
thread-safe basename function (resulting pointer must be free()ed)
DLLEXPORT QoreStringNode * q_sprintf(const class QoreListNode *params, int field, int offset, class ExceptionSink *xsink)
a string formatting function that works with Qore data structures
DLLEXPORT QoreHashNode * q_getpwuid(uid_t uid)
thread-safe version of getpwuid(): returns a Qore hash of the passwd information from the uid if poss...
DLLEXPORT QoreStringNode * qore_reassign_signal(int sig, const char *name)
allows a module to take over ownership of a signal
DLLEXPORT QoreHashNode * q_getgrgid(uid_t uid)
thread-safe version of getgrgid(): returns a Qore hash of the group information from the gid if possi...
DLLEXPORT char * q_dirname(const char *path)
thread-safe dirname function (resulting pointer must be free()ed)
DLLEXPORT int getSecZeroInt(const AbstractQoreNode *a)
for getting an integer number of seconds, with 0 as the default, from either a relative time value or...
DLLEXPORT int64 getMsZeroBigInt(const AbstractQoreNode *a)
for getting an integer number of milliseconds, with 0 as the default, from either a relative time val...
static char * strtoupper(char *str)
convert a string to upper-case in place
Definition: QoreLib.h:244
qore_license_t
qore library and module license type identifiers
Definition: common.h:74
const char * constant
name of the constant for this option
Definition: QoreLib.h:417
DLLEXPORT bool q_get_option_value(const char *opt)
returns the boolean value of qore library the given option name; false if the option is unknown ...
DLLEXPORT int64 getMicroSecZeroInt64(const AbstractQoreNode *a)
for getting an integer number of microseconds, with 0 as the default, from either a relative time val...
DLLEXPORT BinaryNode * qore_bzip2(void *ptr, unsigned long len, int level, ExceptionSink *xsink)
compresses data with bzip2
container for holding Qore-language exception information and also for registering a "thread_exit" ca...
Definition: ExceptionSink.h:35
DLLEXPORT bool q_path_is_readable(const char *path)
platform-independent API that tells if the given path is readable by the current user ...
DLLEXPORT QoreStringNode * q_strerror(int errnum)
returns the error string as a QoreStringNode
DLLEXPORT const char * q_mode_to_perm(mode_t mode, QoreString &perm)
concatenates UNIX-style permissions to perm and from mode and returns a string giving the file type ...
DLLEXPORT BinaryNode * qore_gunzip_to_binary(const BinaryNode *bin, ExceptionSink *xsink)
gunzips compressed data to a binary
static void strtolower(char *str)
convert a string to lower-case in place
Definition: QoreLib.h:236
DLLEXPORT void deref(ExceptionSink *xsink)
decrements the reference count and calls derefImpl() if there_can_be_only_one is false, otherwise does nothing
DLLEXPORT qore_license_t qore_get_license()
returns the license type that the library has been initialized under
DLLEXPORT int64 getMsMinusOneBigInt(const AbstractQoreNode *a)
for getting an integer number of milliseconds, with -1 as the default, from either a relative time va...
DLLEXPORT int64 getSecMinusOneBigInt(const AbstractQoreNode *a)
for getting an integer number of seconds, with -1 as the default, from either a relative time value o...
int q_uname2uid(const char *name, uid_t &uid)
thread-safe way to lookup a uid from a username
DLLEXPORT void parse_set_time_zone(const char *zone)
to set the time zone from the command line
int type
the type of the option
Definition: QoreLib.h:418
DLLEXPORT QoreStringNode * qore_inflate_to_string(const BinaryNode *b, const QoreEncoding *enc, ExceptionSink *xsink)
decompresses data compressed with the DEFLATE algorithm to a string
DLLLOCAL qore_type_t getType() const
returns the data type
Definition: AbstractQoreNode.h:286
DLLEXPORT int getMsMinusOneInt(const AbstractQoreNode *a)
for getting an integer number of milliseconds, with -1 as the default, from either a relative time va...
static char * strnchr(const char *str, int len, char c)
find a character in a string up to len
Definition: QoreLib.h:225
DLLEXPORT int64 q_epoch()
returns the seconds from the epoch
int q_gname2gid(const char *name, gid_t &gid)
thread-safe way to lookup a gid from a group name
DLLLOCAL ~FeatureList()
destructor not exported
DLLEXPORT const AbstractQoreZoneInfo * findCreateOffsetZone(int seconds_east)
returns a time zone for the given time zone UTC offset
DLLEXPORT char * q_basenameptr(const char *path)
returns a pointer within the same string
DLLEXPORT bool q_get_option_constant_value(const char *opt)
returns the boolean value of qore library the given name of the constant for the option; false if the...
DLLEXPORT BinaryNode * parseHex(const char *buf, int len, ExceptionSink *xsink)
parses a string of hex characters and returns a BinaryNode
DLLEXPORT void * q_realloc(void *ptr, size_t size)
frees memory if there is an allocation error
DLLEXPORT QoreHashNode * q_getpwnam(const char *name)
thread-safe version of getpwnam(): returns a Qore hash of the passwd information from the username if...
static char * strchrs(const char *str, const char *chars)
find one of any characters in a string
Definition: QoreLib.h:215
DLLEXPORT BinaryNode * qore_inflate_to_binary(const BinaryNode *b, ExceptionSink *xsink)
decompresses data compressed with the DEFLATE algorithm to a binary
DLLEXPORT size_t qore_option_list_size
number of elements in the option list
DLLEXPORT FeatureList qoreFeatureList
list of qore features
holds arbitrary binary data
Definition: BinaryNode.h:33
DLLEXPORT int tz_get_utc_offset(const AbstractQoreZoneInfo *tz, int64 epoch_offset, bool &is_dst, const char *&zone_name)
returns the UTC offset and local time zone name for the given time given as seconds from the epoch (1...