Qore Programming Language - C/C++ Library  0.8.13.5
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
QoreLib.h
Go to the documentation of this file.
1 /* -*- mode: c++; indent-tabs-mode: nil -*- */
2 /*
3  QoreLib.h
4 
5  Qore Programming Language
6 
7  Copyright (C) 2003 - 2017 Qore Technologies, s.r.o.
8 
9  Permission is hereby granted, free of charge, to any person obtaining a
10  copy of this software and associated documentation files (the "Software"),
11  to deal in the Software without restriction, including without limitation
12  the rights to use, copy, modify, merge, publish, distribute, sublicense,
13  and/or sell copies of the Software, and to permit persons to whom the
14  Software is furnished to do so, subject to the following conditions:
15 
16  The above copyright notice and this permission notice shall be included in
17  all copies or substantial portions of the Software.
18 
19  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
22  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
23  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
24  FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
25  DEALINGS IN THE SOFTWARE.
26 
27  Note that the Qore library is released under a choice of three open-source
28  licenses: MIT (as above), LGPL 2+, or GPL 2+; see README-LICENSE for more
29  information.
30 */
31 
32 #ifndef _QORE_QORELIB_H
33 
34 #define _QORE_QORELIB_H
35 
36 #include <qore/common.h>
37 #include <qore/QoreThreadLock.h>
38 #include <qore/qore_bitopts.h>
39 #include <qore/safe_dslist>
40 
41 #include <time.h>
42 #include <string.h>
43 #include <strings.h>
44 #include <stdlib.h>
45 #include <stdio.h>
46 #include <ctype.h>
47 #include <sys/types.h>
48 
49 #include <vector>
50 
52 typedef std::vector<int> sig_vec_t;
53 
58 #undef _QORE_HAS_QORE_XMLNODE_CLASS
60 
62 #undef _QORE_HAS_QORE_XMLREADER_CLASS
63 
65 #undef _QORE_HAS_QORE_XMLDOC_CLASS
66 
68 #define _QORE_HAS_HARD_TYPING 1
69 
71 #define _QORE_HAS_DBI_EXECRAW 1
72 
74 #define _QORE_HAS_TIME_ZONES 1
75 
77 #define _QORE_HAS_THREAD_RESOURCE_IDS 1
78 
80 #define _QORE_HAS_PREPARED_STATMENT_API 1
81 
83 #define _QORE_HAS_DATASOURCE_ACTIVETRANSACTION 1
84 
86 #define _QORE_HAS_DBI_SELECT_ROW 1
87 
89 #define _QORE_HAS_NUMBER_TYPE 1
90 
92 #define _QORE_HAS_PATH_IS_READABLE 1
93 
95 #define _QORE_HAS_DBI_OPTIONS 1
96 
98 #define _QORE_HAS_FIND_CREATE_TIMEZONE 1
99 
101 #define _QORE_HAS_NUMBER_CONS_WITH_PREC 1
102 
104 #define _QORE_HAS_FILE_OBJECT_HELPER 1
105 
107 #define _QORE_HAS_QUEUE_OBJECT_HELPER 1
108 
110 #define _QORE_HAS_QOREHTTPCLIENTOBJECT 1
111 
113 #define _QORE_HAS_DBI_DESCRIBE 1
114 
116 #define _QORE_HAS_DBI_EVENTS 1
117 
119 #define _QORE_HAS_QUEUE_OBJECT 1
120 
122 #define _QORE_HAS_SOCKET_PERF_API 1
123 
125 #define _QORE_HAS_QL_MIT 1
126 
128 #define _QORE_HAS_DATETIME_ADD_SECONDS_TO 1
129 
130 // qore code flags
131 #define QC_NO_FLAGS 0
132 #define QC_NOOP (1 << 0)
133 #define QC_USES_EXTRA_ARGS (1 << 1)
134 #define QC_CONSTANT_INTERN (1 << 2)
135 #define QC_DEPRECATED (1 << 3)
136 #define QC_RET_VALUE_ONLY (1 << 4)
137 #define QC_RUNTIME_NOOP (1 << 5)
138 
139 // composite flags
140 #define QC_CONSTANT (QC_CONSTANT_INTERN | QC_RET_VALUE_ONLY)
141 
142 class BinaryNode;
143 class QoreStringNode;
144 class ExceptionSink;
145 
147 DLLEXPORT char* make_class_name(const char* fn);
148 
150 DLLEXPORT QoreStringNode* q_sprintf(const QoreListNode* params, int field, int offset, ExceptionSink* xsink);
151 
153 DLLEXPORT QoreStringNode* q_vsprintf(const QoreListNode* params, int field, int offset, ExceptionSink* xsink);
154 
156 DLLEXPORT QoreStringNode* q_sprintf(const QoreValueList* params, int field, int offset, ExceptionSink* xsink);
157 
159 DLLEXPORT QoreStringNode* q_vsprintf(const QoreValueList* params, int field, int offset, ExceptionSink* xsink);
160 
162 DLLEXPORT struct tm* q_localtime(const time_t* clock, struct tm* tms);
163 
165 DLLEXPORT struct tm* q_gmtime(const time_t* clock, struct tm* tms);
166 
168 DLLEXPORT int64 q_epoch();
169 
171 DLLEXPORT int64 q_epoch_us(int &us);
172 
174 DLLEXPORT int64 q_epoch_ns(int &us);
175 
177 DLLEXPORT char* q_basename(const char* path);
178 
180 DLLEXPORT char* q_basenameptr(const char* path);
181 
183 DLLEXPORT char* q_dirname(const char* path);
184 
186 DLLEXPORT void* q_realloc(void* ptr, size_t size);
187 
188 #ifndef _Q_WINDOWS
189 DLLEXPORT QoreHashNode* q_getpwuid(uid_t uid);
191 
193 DLLEXPORT QoreHashNode* q_getpwnam(const char* name);
194 
196 DLLEXPORT QoreHashNode* q_getgrgid(uid_t uid);
197 
199 DLLEXPORT QoreHashNode* q_getgrnam(const char* name);
200 
202 
207 int q_uname2uid(const char* name, uid_t &uid);
208 
210 
215 int q_gname2gid(const char* name, gid_t &gid);
216 #endif // ! windows
217 
219 DLLEXPORT void qore_setup_argv(int pos, int argc, char* argv[]);
220 
222 DLLEXPORT qore_license_t qore_get_license();
223 
225 DLLEXPORT void qore_exit_process(int rc);
226 
228 
230 class FeatureList : public safe_dslist<std::string> {
231 private:
233  DLLLOCAL FeatureList(const FeatureList&);
234 
236  DLLLOCAL FeatureList& operator=(const FeatureList&);
237 
238 public:
240  DLLLOCAL FeatureList();
241 
243  DLLLOCAL ~FeatureList();
244 };
245 
247 DLLEXPORT extern FeatureList qoreFeatureList;
248 
250 static inline char* strchrs(const char* str, const char* chars) {
251  while (*str) {
252  if (strchr(chars, *str))
253  return (char* )str;
254  str++;
255  }
256  return 0;
257 }
258 
260 static inline char* strnchr(const char* str, int len, char c) {
261  int i = 0;
262  while (i++ != len) {
263  if (*str == c)
264  return (char* )str;
265  ++str;
266  }
267  return 0;
268 }
269 
271 static inline void strtolower(char* str) {
272  while (*(str)) {
273  (*str) = tolower(*str);
274  str++;
275  }
276 }
277 
279 static inline char* strtoupper(char* str) {
280  char* p = str;
281  while (*(p)) {
282  *p = toupper(*p);
283  p++;
284  }
285  return str;
286 }
287 
289 DLLEXPORT int getSecZeroInt(const AbstractQoreNode* a);
290 
292 DLLEXPORT int64 getSecZeroBigInt(const AbstractQoreNode* a);
293 
295 DLLEXPORT int getSecMinusOneInt(const AbstractQoreNode* a);
296 
298 DLLEXPORT int64 getSecMinusOneBigInt(const AbstractQoreNode* a);
299 
301 DLLEXPORT int getMsZeroInt(const AbstractQoreNode* a);
302 
304 DLLEXPORT int64 getMsZeroBigInt(const AbstractQoreNode* a);
305 
307 DLLEXPORT int getMsMinusOneInt(const AbstractQoreNode* a);
308 
310 DLLEXPORT int64 getMsMinusOneBigInt(const AbstractQoreNode* a);
311 
313 DLLEXPORT int getMicroSecZeroInt(const AbstractQoreNode* a);
314 
316 DLLEXPORT int64 getMicroSecZeroInt64(const AbstractQoreNode* a);
317 
319 static inline bool is_nothing(const AbstractQoreNode* n) {
320  if (!n || n->getType() == NT_NOTHING)
321  return true;
322 
323  return false;
324 }
325 
327 static inline void discard(AbstractQoreNode* n, ExceptionSink* xsink) {
328  if (n)
329  n->deref(xsink);
330 }
331 
332 static inline const char* get_type_name(const AbstractQoreNode* n) {
333  return n ? n->getTypeName() : "nothing";
334 }
335 
337 
339 DLLEXPORT const char* get_full_type_name(const AbstractQoreNode* n);
340 
341 static inline qore_type_t get_node_type(const AbstractQoreNode* n) {
342  return n ? n->getType() : NT_NOTHING;
343 }
344 
345 typedef QoreStringNode* (*qore_uncompress_to_string_t)(const BinaryNode* b, const QoreEncoding* enc, ExceptionSink* xsink);
346 
348 DLLEXPORT BinaryNode* qore_deflate(void* ptr, unsigned long len, int level, ExceptionSink* xsink);
350 DLLEXPORT QoreStringNode* qore_inflate_to_string(const BinaryNode* b, const QoreEncoding* enc, ExceptionSink* xsink);
352 DLLEXPORT BinaryNode* qore_inflate_to_binary(const BinaryNode* b, ExceptionSink* xsink);
354 DLLEXPORT BinaryNode* qore_gzip(void* ptr, unsigned long len, int level, ExceptionSink* xsink);
356 DLLEXPORT QoreStringNode* qore_gunzip_to_string(const BinaryNode* bin, const QoreEncoding* enc, ExceptionSink* xsink);
358 DLLEXPORT BinaryNode* qore_gunzip_to_binary(const BinaryNode* bin, ExceptionSink* xsink);
360 DLLEXPORT BinaryNode* qore_bzip2(void* ptr, unsigned long len, int level, ExceptionSink* xsink);
362 DLLEXPORT QoreStringNode* qore_bunzip2_to_string(const BinaryNode* bin, const QoreEncoding* enc, ExceptionSink* xsink);
364 DLLEXPORT BinaryNode* qore_bunzip2_to_binary(const BinaryNode* bin, ExceptionSink* xsink);
365 
367 DLLEXPORT BinaryNode* parseBase64(const char* buf, int len, ExceptionSink* xsink);
368 
370 DLLEXPORT BinaryNode* parseHex(const char* buf, int len, ExceptionSink* xsink);
371 
372 class AbstractQoreZoneInfo;
373 
375 DLLEXPORT const AbstractQoreZoneInfo* findCreateOffsetZone(int seconds_east);
376 
378 
383 DLLEXPORT const AbstractQoreZoneInfo* find_create_timezone(const char* name, ExceptionSink* xsink);
384 
386 DLLEXPORT int tz_get_utc_offset(const AbstractQoreZoneInfo* tz, int64 epoch_offset, bool &is_dst, const char* &zone_name);
388 DLLEXPORT bool tz_has_dst(const AbstractQoreZoneInfo* tz);
390 DLLEXPORT const char* tz_get_region_name(const AbstractQoreZoneInfo* tz);
391 
393 #define QORE_OPT_ATOMIC_OPERATIONS "atomic operations"
394 #define QORE_OPT_STACK_GUARD "stack guard"
396 #define QORE_OPT_SIGNAL_HANDLING "signal handling"
398 #define QORE_OPT_RUNTIME_STACK_TRACE "runtime stack tracing"
400 #define QORE_OPT_LIBRARY_DEBUGGING "library debugging"
402 #define QORE_OPT_SHA "openssl sha"
404 #define QORE_OPT_SHA224 "openssl sha224"
406 #define QORE_OPT_SHA256 "openssl sha256"
408 #define QORE_OPT_SHA384 "openssl sha384"
410 #define QORE_OPT_SHA512 "openssl sha512"
412 #define QORE_OPT_MDC2 "openssl mdc2"
414 #define QORE_OPT_RC5 "openssl rc5"
416 #define QORE_OPT_MD2 "openssl md2"
418 #define QORE_OPT_DSS "openssl dss"
420 #define QORE_OPT_TERMIOS "termios"
422 #define QORE_OPT_FILE_LOCKING "file locking"
424 #define QORE_OPT_UNIX_USERMGT "unix user management"
426 #define QORE_OPT_UNIX_FILEMGT "unix file management"
428 #define QORE_OPT_DETERMINISTIC_GC "deterministic GC"
430 #define QORE_OPT_FUNC_ROUND "round()"
432 #define QORE_OPT_FUNC_TIMEGM "timegm()"
434 #define QORE_OPT_FUNC_SETEUID "seteuid()"
436 #define QORE_OPT_FUNC_SETEGID "setegid()"
438 #define QORE_OPT_FUNC_SYSTEM "system()"
440 #define QORE_OPT_FUNC_KILL "kill()"
442 #define QORE_OPT_FUNC_FORK "fork()"
444 #define QORE_OPT_FUNC_GETPPID "getppid()"
446 #define QORE_OPT_FUNC_STATVFS "statvfs()"
448 #define QORE_OPT_FUNC_SETSID "setsid()"
450 #define QORE_OPT_FUNC_IS_EXECUTABLE "is_executable()"
452 
454 #define QO_OPTION 0
455 #define QO_ALGORITHM 1
456 #define QO_FUNCTION 2
457 
460  const char* option;
461  const char* constant;
462  int type;
463  bool value;
464 };
465 
467 DLLEXPORT QoreStringNode* q_strerror(int errnum);
469 DLLEXPORT void q_strerror(QoreString &str, int errnum);
470 
472 DLLEXPORT extern const qore_option_s* qore_option_list;
474 DLLEXPORT extern size_t qore_option_list_size;
475 
477 
487 DLLEXPORT QoreStringNode* qore_reassign_signal(int sig, const char* name);
488 
490 
504 DLLEXPORT QoreStringNode* qore_reassign_signals(const sig_vec_t& sig_vec, const char* name);
505 
507 
519 DLLEXPORT int qore_release_signal(int sig, const char* name);
520 
522 
529 DLLEXPORT int qore_release_signals(const sig_vec_t& sig_vec, const char* name);
530 
532 #define QORE_MAX(a, b) ((a) > (b) ? (a) : (b))
533 
535 #define QORE_MIN(a, b) ((a) < (b) ? (a) : (b))
536 
537 #define QORE_PARAM_NO_ARG (NULL)
538 
539 // define QORE_PATH_MAX
540 #ifndef QORE_PATH_MAX
541 #ifdef _XOPEN_PATH_MAX
542 #define QORE_PATH_MAX _XOPEN_PATH_MAX
543 #else
544 #define QORE_PATH_MAX 1024
545 #endif
546 #endif
547 
549 
551 DLLEXPORT void parse_set_time_zone(const char* zone);
552 
554 DLLEXPORT int qore_usleep(int64 usecs);
555 
557 DLLEXPORT void qore_disable_gc();
558 
560 DLLEXPORT bool qore_is_gc_enabled();
561 
563 DLLEXPORT bool q_path_is_readable(const char* path);
564 
566 DLLEXPORT bool q_parse_bool(const AbstractQoreNode* n);
567 
569 DLLEXPORT bool q_parse_bool(const char* str);
570 
572 DLLEXPORT bool q_get_option_value(const char* opt);
573 
575 DLLEXPORT bool q_get_option_constant_value(const char* opt);
576 
578 DLLEXPORT const char* q_mode_to_perm(mode_t mode, QoreString& perm);
579 
581 int q_getcwd(QoreString& cwd);
582 
584 DLLEXPORT bool q_absolute_path_unix(const char* path);
585 
587 DLLEXPORT bool q_absolute_path_windows(const char* path);
588 
590 DLLEXPORT bool q_absolute_path(const char* path);
591 
593 DLLEXPORT void q_normalize_path(QoreString& path, const char* cwd = 0);
594 
596 DLLEXPORT int q_realpath(const QoreString& path, QoreString& rv, ExceptionSink* xsink = 0);
597 
599 DLLEXPORT void* q_memmem(const void* big, size_t big_len, const void* little, size_t little_len);
600 
602 
606 DLLEXPORT int q_env_subst(QoreString& str);
607 
609 
611 DLLEXPORT double q_strtod(const char* str);
612 
614 
616 DLLEXPORT bool q_libqore_shutdown();
617 
619 
628 DLLEXPORT QoreHashNode* q_get_thread_local_vars(int frame, ExceptionSink* xsink);
629 
631 
642 DLLEXPORT int q_set_thread_var_value(int frame, const char* name, const QoreValue& val, ExceptionSink* xsink);
643 
645 DLLEXPORT int q_get_data(const QoreValue& data, const char*& ptr, size_t& len);
646 
647 #endif // _QORE_QORELIB_H
DLLEXPORT const qore_option_s * qore_option_list
list of qore options
DLLEXPORT int qore_release_signal(int sig, const char *name)
releases the signal allocated to the given module
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 (&quot;+01:00&quot;) ...
STL-like list containing all presently-loaded Qore features.
Definition: QoreLib.h:230
int q_getcwd(QoreString &cwd)
returns the current working directory in the given string; -1 is returned if an error occurred...
defines string encoding functions in Qore
Definition: QoreEncoding.h:85
templated class for a double-ended singly-linked list that can be safely read from multiple threads w...
Definition: safe_dslist:137
DLLEXPORT BinaryNode * qore_deflate(void *ptr, unsigned long len, int level, ExceptionSink *xsink)
compresses data with the DEFLATE algorithm
DLLEXPORT int q_env_subst(QoreString &str)
performs environment variable substitution on the string argument
This is the hash or associative list container type in Qore, dynamically allocated only...
Definition: QoreHashNode.h:50
DLLEXPORT bool q_absolute_path_unix(const char *path)
returns true if the given string is an absolute path on UNIX systems
DLLEXPORT void qore_setup_argv(int pos, int argc, char *argv[])
sets up the Qore ARGV and QORE_ARGV values
DLLEXPORT int q_get_data(const QoreValue &data, const char *&ptr, size_t &len)
returns the pointer and size for string or binary data (return 0); no change for other data (return -...
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 &quot;exit()&quot;, 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...
This is the list container type in Qore, dynamically allocated only, reference counted.
Definition: QoreValueList.h:45
The base class for all value and parse types in Qore expression trees.
Definition: AbstractQoreNode.h:54
const qore_type_t NT_NOTHING
type value for QoreNothingNode
Definition: node_types.h:42
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 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:327
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...
DLLEXPORT QoreStringNode * q_vsprintf(const QoreListNode *params, int field, int offset, ExceptionSink *xsink)
a string formatting function that works with Qore data structures
bool value
the value of the option
Definition: QoreLib.h:463
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 bool q_libqore_shutdown()
returns true if the Qore library has been shut down
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&#39;s a stri...
DLLLOCAL FeatureList()
initialized by the library, constructor not exported
DLLEXPORT int q_realpath(const QoreString &path, QoreString &rv, ExceptionSink *xsink=0)
normalizes the given path and resolves any symlinks
DLLEXPORT int q_set_thread_var_value(int frame, const char *name, const QoreValue &val, ExceptionSink *xsink)
sets the value of the given thread-local variable (which may be a closure-bound variable as well) in ...
DLLEXPORT int qore_release_signals(const sig_vec_t &sig_vec, const char *name)
releases multiple signals allocated to the given module atomically
DLLEXPORT struct tm * q_localtime(const time_t *clock, struct tm *tms)
thread-safe version of &quot;localtime()&quot;
DLLEXPORT void qore_disable_gc()
this function will cause garbage collection to be disabled
DLLEXPORT const char * get_full_type_name(const AbstractQoreNode *n)
returns a string type description of the full type of the value contained (ex: &quot;nothing&quot; for a null A...
virtual DLLEXPORT const char * getTypeName() const =0
returns the type name as a c string
Qore&#39;s string type supported by the QoreEncoding class.
Definition: QoreString.h:82
Qore&#39;s string value type, reference counted, dynamically-allocated only.
Definition: QoreStringNode.h:50
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:460
DLLEXPORT int qore_usleep(int64 usecs)
use this function instead of usleep(), as usleep() is not signal-safe on some platforms (ex: Solaris ...
std::vector< int > sig_vec_t
signal vector
Definition: QoreLib.h:52
definition of the elements in the qore_option_list
Definition: QoreLib.h:459
static bool is_nothing(const AbstractQoreNode *n)
to check if an AbstractQoreNode object is NOTHING
Definition: QoreLib.h:319
DLLEXPORT struct tm * q_gmtime(const time_t *clock, struct tm *tms)
thread-safe version of &quot;gmtime()&quot;
This is the list container type in Qore, dynamically allocated only, reference counted.
Definition: QoreListNode.h:52
DLLEXPORT char * q_basename(const char *path)
thread-safe basename function (resulting pointer must be free()ed)
DLLEXPORT QoreStringNode * qore_reassign_signals(const sig_vec_t &sig_vec, const char *name)
allows a module to take over ownership of multiple signals atomically
DLLEXPORT QoreHashNode * q_get_thread_local_vars(int frame, ExceptionSink *xsink)
retrieves a hash of all thread local variables and their values for the given stack frame in the curr...
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:279
The main value class in Qore, designed to be passed by value.
Definition: QoreValue.h:112
qore_license_t
qore library and module license type identifiers
Definition: common.h:86
const char * constant
name of the constant for this option
Definition: QoreLib.h:461
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
DLLEXPORT QoreStringNode * q_sprintf(const QoreListNode *params, int field, int offset, ExceptionSink *xsink)
a string formatting function that works with Qore data structures
container for holding Qore-language exception information and also for registering a &quot;thread_exit&quot; ca...
Definition: ExceptionSink.h:47
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:271
DLLEXPORT void deref(ExceptionSink *xsink)
decrements the reference count and calls derefImpl() if there_can_be_only_one is false, otherwise does nothing
long long int64
64bit integer type, cannot use int64_t here since it breaks the API on some 64-bit systems due to equ...
Definition: common.h:241
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:462
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:296
DLLEXPORT void * q_memmem(const void *big, size_t big_len, const void *little, size_t little_len)
finds a memory sequence in a larger memory sequence
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:260
int16_t qore_type_t
used to identify unique Qore data and parse types (descendents of AbstractQoreNode) ...
Definition: common.h:71
DLLEXPORT int64 q_epoch()
returns the seconds from the epoch
DLLEXPORT bool q_absolute_path_windows(const char *path)
returns true if the given string is an absolute path on Windows systems
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 bool q_absolute_path(const char *path)
returns true if the given string is an absolute path on the current platform
DLLEXPORT const AbstractQoreZoneInfo * findCreateOffsetZone(int seconds_east)
returns a time zone for the given time zone UTC offset
DLLEXPORT double q_strtod(const char *str)
converts a string to a double in a locale-independent way
DLLEXPORT void q_normalize_path(QoreString &path, const char *cwd=0)
normalizes the given path for the current platform in place (makes absolute, removes &quot;...
DLLEXPORT bool qore_is_gc_enabled()
returns true if garbage collection is enabled, false if not
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:250
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:41
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...