Annotation of parser3/src/include/pa_common.h, revision 1.74

1.15      paf         1: /** @file
1.16      paf         2:        Parser: commonly used functions.
                      3: 
1.73      paf         4:        Copyright (c) 2001, 2002 ArtLebedev Group (http://www.artlebedev.com)
1.74    ! paf         5:        Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
1.4       paf         6: 
1.74    ! paf         7:        $Id: pa_common.h,v 1.73 2002/02/08 07:27:43 paf Exp $
1.1       paf         8: */
                      9: 
                     10: #ifndef PA_COMMON_H
                     11: #define PA_COMMON_H
                     12: 
1.2       paf        13: #include "pa_pool.h"
1.33      paf        14: #include "pa_string.h"
1.1       paf        15: 
1.14      paf        16: class Value;
1.64      paf        17: 
                     18: // replace system s*nprintf with our versions
1.69      paf        19: #undef vsnprintf 
1.63      paf        20: int __vsnprintf(char *, size_t, const char *, va_list);
1.64      paf        21: #define vsnprintf __vsnprintf 
                     22: #undef snprintf
1.63      paf        23: int __snprintf(char *, size_t, const char *, ...);
1.64      paf        24: #define snprintf __snprintf
1.63      paf        25: 
1.21      paf        26: #if _MSC_VER
1.56      paf        27: /*
                     28: inline int open( const char *filename, int oflag ) { return _open(filename, oflag); }
                     29: inline int close( int handle ) { return _close(handle); }
                     30: inline int read( int handle, void *buffer, unsigned int count ) { return _read(handle,buffer,count); }
                     31: inline int write( int handle, const void *buffer, unsigned int count ) { return _write(handle,buffer,count); }
                     32: inline int stat( const char *path, struct _stat *buffer ) { return _stat(path, buffer); }
                     33: inline long lseek( int handle, long offset, int origin ) { return _lseek(handle, offset, origin); }
                     34: */
1.17      paf        35: 
                     36: //access
                     37: #define F_OK 0
                     38: #define X_OK 1
                     39: #define W_OK 2
                     40: #define R_OK 4
                     41: 
1.20      paf        42: #ifndef strcasecmp
                     43: #      define strcasecmp _stricmp
                     44: #endif
                     45: #ifndef strncasecmp
                     46: #      define strncasecmp _strnicmp
                     47: #endif
                     48: #ifndef mkdir
                     49: #      define mkdir(path, mode) _mkdir(path)
                     50: #endif
1.17      paf        51: 
1.20      paf        52: #ifndef putenv
                     53: #      define putenv _putenv
1.1       paf        54: #endif
1.2       paf        55: 
1.17      paf        56: #endif
1.59      paf        57: 
1.61      paf        58: #ifdef HAVE_TRUNC
                     59: #      ifndef trunc
                     60: extern "C" double trunc(double);
                     61: #      endif
                     62: #else
1.59      paf        63: inline double trunc(double param) { return param > 0? floor(param) : ceil(param); }
                     64: #endif
1.61      paf        65: 
                     66: #ifdef HAVE_ROUND
                     67: #      ifndef round
                     68: extern "C" double round(double);
                     69: #      endif
                     70: #else
1.59      paf        71: inline double round(double param) { return floor(param+0.5); }
                     72: #endif
1.61      paf        73: #ifdef HAVE_SIGN
                     74: #      ifndef sign
                     75: extern "C" double sign(double);
                     76: #      endif
                     77: #else
1.59      paf        78: inline double sign(double param) { return param > 0 ? 1 : ( param < 0 ? -1 : 0 ); }
                     79: #endif
                     80: 
1.72      paf        81: /// yields to OS for secs secs and usecs milliseconds
                     82: int pa_sleep(unsigned long secs, unsigned long usecs);
1.54      parser     83: 
                     84: /** under WIN32 "t" mode fixes DOS chars OK, 
                     85:        can't say that about other systems/ line break styles
                     86: */
1.57      paf        87: void fix_line_breaks(
1.62      paf        88:                                         char *buf,
                     89:                                         size_t& size ///< may change! used to speedup next actions
1.57      paf        90:                                         );
1.17      paf        91: 
1.15      paf        92: /**
1.19      paf        93:        read specified text file using pool, 
1.15      paf        94:        if fail_on_read_problem is true[default] throws an exception
                     95: */
1.19      paf        96: char *file_read_text(Pool& pool, 
1.25      paf        97:                                         const String& file_spec, 
1.19      paf        98:                                         bool fail_on_read_problem=true);
1.17      paf        99: 
                    100: /**
1.29      paf       101:        read specified file using pool, 
                    102:        if fail_on_read_problem is true[default] throws an exception
                    103: */
                    104: bool file_read(Pool& pool, const String& file_spec, 
                    105:                           void*& data, size_t& size, 
                    106:                           bool as_text,
1.37      paf       107:                           bool fail_on_read_problem=true,
                    108:                           size_t offset=0, size_t limit=0);
1.29      paf       109: 
                    110: /**
1.71      paf       111:        lock specified file exclusively, 
                    112:        do actions under lock.
                    113:        throws an exception in case of problems
1.72      paf       114:        
                    115:        if block=false does non-blocking lock
                    116:        @returns true if locked OK, or false if non-blocking locking failed
1.71      paf       117: */
1.72      paf       118: bool file_write_action_under_lock(
1.71      paf       119:                                const String& file_spec, 
                    120:                                const char *action_name, void (*action)(int, void *), void *context=0,
                    121:                                bool as_text=false,
1.72      paf       122:                                bool do_append=false,
                    123:                                bool do_block=true);
1.71      paf       124: 
                    125: /**
                    126:        write data to specified file, 
1.17      paf       127:        throws an exception in case of problems
                    128: */
1.70      paf       129: void file_write(
1.25      paf       130:                                const String& file_spec,
1.29      paf       131:                                const void *data, size_t size, 
1.58      paf       132:                                bool as_text,
1.67      paf       133:                                bool do_append=false);
1.26      paf       134: 
                    135: /**
                    136:        delete specified file 
                    137:        throws an exception in case of problems
                    138: */
1.70      paf       139: bool file_delete(const String& file_spec, bool fail_on_read_problem=true);
1.47      parser    140: /**
                    141:        move specified file 
                    142:        throws an exception in case of problems
                    143: */
1.70      paf       144: void file_move(const String& old_spec, const String& new_spec);
1.27      paf       145: 
                    146: bool file_readable(const String& file_spec);
1.41      paf       147: bool dir_readable(const String& file_spec);
1.49      parser    148: String *file_readable(const String& path, const String& name);
1.36      paf       149: bool file_executable(const String& file_spec);
1.37      paf       150: 
1.48      parser    151: bool file_stat(const String& file_spec, 
1.46      parser    152:                           size_t& rsize, 
                    153:                           time_t& ratime,
                    154:                           time_t& rmtime,
1.48      parser    155:                           time_t& rctime,
                    156:                           bool fail_on_read_problem=true);
1.15      paf       157: 
                    158: /**
1.18      paf       159:        scans for @a delim[default \n] in @a *row_ref, 
                    160:        @return piece of line before it or end of string, if no @a delim found
                    161:        assigns @a *row_ref to point right after delimiter if there were one
                    162:        or to zero if no @a delim were found.
1.15      paf       163: */
1.7       paf       164: char *getrow(char **row_ref,char delim='\n');
1.22      paf       165: //char *lsplit(char *string, char delim);
1.7       paf       166: char *lsplit(char **string_ref,char delim);
1.8       paf       167: char *rsplit(char *string, char delim);
1.9       paf       168: char *format(Pool& pool, double value, char *fmt);
1.10      paf       169: 
                    170: #ifndef max
                    171: inline int max(int a,int b) { return a>b?a:b; }
                    172: inline int min(int a,int b){ return a<b?a:b; }
                    173: #endif
                    174: 
1.30      paf       175: size_t stdout_write(const void *buf, size_t size);
1.14      paf       176: 
1.55      parser    177: char *unescape_chars(Pool& pool, const char *cp, int len);
1.14      paf       178: 
1.24      paf       179: /**
                    180:        $content-type[text/html] -> 
1.32      paf       181:                content-type: text/html
1.24      paf       182:        $content-type[$value[text/html] charset[windows-1251]] -> 
1.32      paf       183:                content-type: text/html; charset=windows-1251
1.24      paf       184: */
1.33      paf       185: const String& attributed_meaning_to_string(Value& meaning, String::Untaint_lang lang);
1.23      paf       186: 
                    187: #ifdef WIN32
                    188: void back_slashes_to_slashes(char *s);
1.35      paf       189: //void slashes_to_back_slashes(char *s);
1.23      paf       190: #endif
                    191: 
1.28      paf       192: #ifndef _qsort
                    193: #      define _qsort(names,cnt,sizeof_names,func_addr) \
                    194:                qsort(names,cnt,sizeof_names,func_addr)
                    195: #endif
1.34      paf       196: 
1.40      paf       197: bool StrEqNc(const char *s1, const char *s2, bool strict=true);
1.45      parser    198: 
                    199: #define SECS_PER_DAY (60*60*24)
                    200: int getMonthDays(int year, int month);
1.52      parser    201: 
                    202: void remove_crlf(char *start, char *end);
1.1       paf       203: 
                    204: #endif

E-mail: