Diff for /parser3/src/main/pa_common.C between versions 1.49 and 1.121

version 1.49, 2001/04/23 08:52:24 version 1.121, 2002/11/20 09:44:43
Line 1 Line 1
 /** @file  /** @file
         Parser: commonly functions.          Parser: commonly functions.
   
         Copyright(c) 2001 ArtLebedev Group(http://www.artlebedev.com)          Copyright(c) 2001, 2002 ArtLebedev Group (http://www.artlebedev.com)
           Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
         Author: Alexander Petrosyan <paf@design.ru>(http://design.ru/paf)  
   
         $Id$  
 */  */
   
 #include "pa_config_includes.h"  static const char* IDENT_COMMON_C="$Date$";
   
 #include "pa_common.h"  #include "pa_common.h"
 #include "pa_types.h"  
 #include "pa_exception.h"  #include "pa_exception.h"
 #include "pa_pool.h"  
 #include "pa_globals.h"  #include "pa_globals.h"
 #include "pa_value.h"  
 #include "pa_hash.h"  #ifdef WIN32
 #include "pa_string.h"  #       include <windows.h>
   
 #ifndef WIN32  
 #       ifndef _O_TEXT  
 #               define _O_TEXT 0  
 #       endif  
 #       ifndef _O_BINARY  
 #               define _O_BINARY 0  
 #       endif  
 #endif  #endif
   
 #if _MSC_VER  // some maybe-undefined constants
   
 int __vsnprintf(char *b, size_t s, const char *f, va_list l) {  #ifndef _O_TEXT
         int r=_vsnprintf(b, --s, f, l);  #       define _O_TEXT 0
         b[s]=0;  #endif
         return r;  #ifndef _O_BINARY
 }  #       define _O_BINARY 0
 int __snprintf(char *b, size_t s, const char *f, ...) {  #endif
         va_list l;  #ifndef O_TRUNC
     va_start(l, f);  #       define O_TRUNC 0
     int r=__vsnprintf(b, s, f, l);  #endif
     va_end(l);  
         return r;  // locking constants
 }  
   #ifdef HAVE_FLOCK
   
   static int lock_shared_blocking(int fd) { return flock(fd, LOCK_SH); }
   static int lock_exclusive_blocking(int fd) { return flock(fd, LOCK_EX); }
   static int lock_exclusive_nonblocking(int fd) { return flock(fd, LOCK_EX || LOCK_NB); }
   static int unlock(int fd) { return flock(fd, LOCK_UN); }
   
   #else
   #ifdef HAVE__LOCKING
   
   #define FLOCK(operation) lseek(fd, 0, SEEK_SET); return _locking(fd, operation, 1)
   static int lock_shared_blocking(int fd) { FLOCK(_LK_LOCK); }
   static int lock_exclusive_blocking(int fd) { FLOCK(_LK_LOCK); }
   static int lock_exclusive_nonblocking(int fd) { FLOCK(_LK_NBLCK); }
   static int unlock(int fd) { FLOCK(_LK_UNLCK); }
   
   #else
   #ifdef HAVE_FCNTL
   
   #define FLOCK(cmd, arg) struct flock ls={arg, SEEK_SET}; return fcntl(fd, cmd, &ls)
   static int lock_shared_blocking(int fd) { FLOCK(F_SETLKW, F_RDLCK); }
   static int lock_exclusive_blocking(int fd) { FLOCK(F_SETLKW, F_WRLCK); }
   static int lock_exclusive_nonblocking(int fd) { FLOCK(F_SETLK, F_RDLCK); }
   static int unlock(int fd) { FLOCK(F_SETLK, F_UNLCK); }
   
   #else
   #ifdef HAVE_LOCKF
   
   #define FLOCK(fd, operation) lseek(fd, 0, SEEK_SET); return lockf(fd, operation, 1)
   static int lock_shared_blocking(int fd) { FLOCK(F_LOCK); } // on intel solaris man doesn't have doc on shared blocking
   static int lock_exclusive_blocking(int fd) { FLOCK(F_LOCK); }
   static int lock_exclusive_nonblocking(int fd) { FLOCK(F_TLOCK); }
   static int unlock(int fd) { FLOCK(F_TLOCK); }
   
   #else
   
   #error unable to find file locking func
   
 #endif  #endif
   #endif
   #endif
   #endif
   
   static char *strnchr(char *buf, size_t size, char c) {
           // sanity check
           if(!buf)
                   return 0;
   
           for(; size-->0; buf++) {
                   if(*buf==c)
                           return buf;
           }
   
           return 0;
   }
   
   void fix_line_breaks(char *buf, size_t& size) {
           //_asm int 3;
           const char * const eob=buf+size;
           char *dest=buf;
           // fix DOS: \r\n -> \n
           // fix Macintosh: \r -> \n
           char *bol=buf;
           while(char *eol=strnchr(bol, eob -bol, '\r')) {
                   size_t len=eol-bol;
                   if(dest!=bol)
                           memcpy(dest, bol, len);
                   dest+=len;
                   *dest++='\n';
   
                   if(&eol[1]<eob && eol[1]=='\n') { // \r,\n = DOS
                           bol=eol+2;
                           size--;
                   } else // \r,not \n = Macintosh
                           bol=eol+1;
           }
           // last piece without \r, including terminating 0
           if(dest!=bol)
                   memcpy(dest, bol, eob-bol);
   }
   
 char *file_read_text(Pool& pool, const String& file_spec, bool fail_on_read_problem) {  char *file_read_text(Pool& pool, const String& file_spec, bool fail_on_read_problem) {
         void *result;          void *result;  size_t size;
         size_t size;          return file_read(pool, file_spec, result, size, true, fail_on_read_problem)?(char *)result:0;
         return file_read(pool, file_spec, result, size, true,   
                 fail_on_read_problem)?(char *)result:0;  
 }  }
 bool file_read(Pool& pool, const String& file_spec,   bool file_read(Pool& pool, const String& file_spec, 
                            void*& data, size_t& read_size, bool as_text,                             void*& data, size_t& data_size, bool as_text,
                            bool fail_on_read_problem,                             bool fail_on_read_problem,
                            size_t offset, size_t limit) {                             size_t offset, size_t limit) {
         const char *fname=file_spec.cstr(String::UL_FILE_NAME);          const char *fname=file_spec.cstr(String::UL_FILE_SPEC);
         int f;          int f;
     struct stat finfo;      struct stat finfo;
   
Line 67  bool file_read(Pool& pool, const String& Line 130  bool file_read(Pool& pool, const String&
         //   directory entry of b.html in NTFS not updated at once,          //   directory entry of b.html in NTFS not updated at once,
         //   they delay update till open, so we would receive "!^test[" string          //   they delay update till open, so we would receive "!^test[" string
         //   if would do stat, next open.          //   if would do stat, next open.
     if(      if((f=open(fname, O_RDONLY|(as_text?_O_TEXT:_O_BINARY)))>=0) {
                 (f=open(fname, O_RDONLY|(as_text?_O_TEXT:_O_BINARY)))>=0 &&                   if(lock_shared_blocking(f)!=0) {
                 stat(fname, &finfo)==0) {                          Exception e("file.lock",
                 /*if(exclusive)                                          &file_spec, 
                         flock(f, LOCK_EX);*/                                          "shared lock failed: %s (%d), actual filename '%s'", 
                 size_t max_size=limit?min(offset+limit, finfo.st_size)-offset:finfo.st_size;                                                  strerror(errno), errno, fname);
                           unlock(f);
                           close(f);
                           if(fail_on_read_problem)
                                   throw e;
                           return false;
                   }
                   if(stat(fname, &finfo)!=0) {
                           Exception e("file.missing",
                                           &file_spec, 
                                           "stat failed: %s (%d), actual filename '%s'", 
                                                   strerror(errno), errno, fname);
                           unlock(f);
                           close(f);
                           if(fail_on_read_problem)
                                   throw e;
                           return false;
                   }
   #ifdef NO_FOREIGN_GROUP_FILES
                   if(finfo.st_gid/*foreign?*/!=getegid()) {
                           Exception e("parser.runtime",
                                   &file_spec,
                                   "parser reading files of foreign group disabled [recompile parser without --disable-foreign-group-files configure option], actual filename '%s'", 
                                           fname);
                           unlock(f);
                           close(f);
                           if(fail_on_read_problem)
                                   throw e;
                           return false;
                   }
   #endif
                   size_t max_size=limit?min(offset+limit, (size_t)finfo.st_size)-offset:finfo.st_size;
                 if(!max_size) { // eof                  if(!max_size) { // eof
                         data=0;                          if(as_text) {
                         read_size=0;                                  data=pool.malloc(1);
                         return true;                                  *(char*)data=0;
                           } else 
                                   data=0;
                           data_size=0;
                   } else {
                           data=pool.malloc(max_size+(as_text?1:0), 3);
                           if(offset)
                                   lseek(f, offset, SEEK_SET);
                           data_size=read(f, data, max_size);
                 }                  }
                 data=pool.malloc(max_size+(as_text?1:0));                  unlock(f);
                 if(offset)  
                         lseek(f, offset, SEEK_SET);  
                 read_size=read(f, data, max_size);  
                 /*if(exclusive)  
                         flock(f, LOCK_UN);*/  
                 close(f);                  close(f);
                   if(!max_size) // eof
                           return true;
   
                 if(read_size>=0 && read_size<=max_size) {                  if(ssize_t(data_size)<0 || data_size>max_size)
                         if(as_text)                          throw Exception(0,
                                 ((char*&)data)[read_size]=0;  
                 } else  
                         PTHROW(0, 0,   
                                 &file_spec,                                   &file_spec, 
                                 "read failed: actually read %d bytes count not in [0..%lu] valid range",                                   "read failed: actually read %d bytes count not in [0..%lu] valid range", 
                                         read_size, (unsigned long)max_size); //never                                          data_size, (unsigned long)max_size); //never
                   
                 return true;//prepare_config(result, remove_empty_lines);                  if(as_text) {
     }                          fix_line_breaks((char *)data, data_size);
         if(fail_on_read_problem)                          // note: after fixing
                 PTHROW(0, 0,                           ((char*&)data)[data_size]=0;
                         &file_spec,                   }
                         "read failed: %s (%d)", strerror(errno), errno);                  return true;
     return false;      } else {
                   if(fail_on_read_problem)
                           throw Exception(errno==EACCES?"file.access":errno==ENOENT?"file.missing":0,
                                   &file_spec, 
                                   "read failed: %s (%d), actual filename '%s'", 
                                           strerror(errno), errno, fname);
                   return false;
           }
 }  }
   
 /// @test mkdirs  static void create_dir_for_file(const String& file_spec) {
 void file_write(Pool& pool,           size_t pos_after=1;
           int pos_before;
           while((pos_before=file_spec.pos("/", 1, pos_after))>=0) {
                   mkdir(file_spec.mid(0, pos_before).cstr(String::UL_FILE_SPEC), 0775);
                   pos_after=pos_before+1;
           }
   }
   
   bool file_write_action_under_lock(
                                 const String& file_spec,                                   const String& file_spec, 
                                 const void *data, size_t size,                                   const char *action_name, void (*action)(int, void *), void *context,
                                 bool as_text/*,                                   bool as_text,
                                 bool exclusive*/) {                                  bool do_append,
         const char *fname=file_spec.cstr(String::UL_FILE_NAME);                                  bool do_block,
                                   bool fail_on_lock_problem) {
           const char *fname=file_spec.cstr(String::UL_FILE_SPEC);
         int f;          int f;
         if(access(fname, F_OK)!=0) {/*no*/          if(access(fname, W_OK)!=0) // no
                 if((f=open(fname, O_WRONLY|O_CREAT|_O_BINARY, 0666))>0)                  create_dir_for_file(file_spec);
   
           if((f=open(fname, 
                   O_CREAT|O_RDWR
                   |(as_text?_O_TEXT:_O_BINARY)
                   |(do_append?O_APPEND:O_TRUNC), 0664))>=0) {
                   if((do_block?lock_exclusive_blocking(f):lock_exclusive_nonblocking(f))!=0) {
                           Exception e("file.lock",
                                   &file_spec, 
                                   "shared lock failed: %s (%d), actual filename '%s'", 
                                   strerror(errno), errno, fname);
                         close(f);                          close(f);
         }                          if(fail_on_lock_problem)
         if(access(fname, R_OK|W_OK)==0) {                                  throw e;
                 int mode=O_RDWR|(as_text?_O_TEXT:_O_BINARY)                          return false;
 #ifdef WIN32                  }
                         |O_TRUNC  
 #endif                  try {
                 ;                          action(f, context);
                 if((f=open(fname, mode, 0666))>=0) {                  } catch(...) {
                         /*if(exclusive)  #if O_TRUNC==0
                                 flock(f, LOCK_EX);*/                          if(!do_append)
                                                           ftruncate(f, tell(f));
                         if(size) write(f, data, size);  
 #ifndef WIN32  
                         ftruncate(f, size);  
 #endif  #endif
                         /*if(exclusive)                          unlock(f);
                                 flock(f, LOCK_UN);*/  
                         close(f);                          close(f);
                         return;                          /*re*/throw;
                 }                  }
                   
   #if O_TRUNC==0
                   if(!do_append)
                           ftruncate(f, tell(f));
   #endif
                   unlock(f);
                   close(f);
                   return true;
           } else
                   throw Exception(errno==EACCES?"file.access":0,
                           &file_spec, 
                           "%s failed: %s (%d), actual filename '%s'", 
                                   action_name, strerror(errno), errno, fname);
           // here should be nothing, see rethrow above
   }
   
   #ifndef DOXYGEN
   struct File_write_action_info {
           const void *data; size_t size;
   };
   #endif
   static void file_write_action(int f, void *context) {
           File_write_action_info& info=*static_cast<File_write_action_info *>(context);
           if(info.size) {
                   int written=write(f, info.data, info.size);
                   if(written<0)
                           throw Exception(0,
                                   0,
                                   "write failed: %s (%d)",  strerror(errno), errno);
         }          }
         PTHROW(0, 0,   }
                 &file_spec,   void file_write(
                 "write failed: %s (%d)", strerror(errno), errno);                                  const String& file_spec, 
                                   const void *data, size_t size, 
                                   bool as_text,
                                   bool do_append) {
           File_write_action_info info={data, size};
           file_write_action_under_lock(
                                   file_spec, 
                                   "write", file_write_action, &info,
                                   as_text,
                                   do_append);
 }  }
   
 void file_delete(Pool& pool, const String& file_spec) {  // throws nothing! [this is required in file_move & file_delete]
         if(unlink(file_spec.cstr(String::UL_FILE_NAME))!=0)  static void rmdir(const String& file_spec, size_t pos_after) {
                 PTHROW(0, 0,           int pos_before;
                         &file_spec,           if((pos_before=file_spec.pos("/", 1, pos_after))>=0)
                         "unlink failed: %s (%d)", strerror(errno), errno);                  rmdir(file_spec, pos_before+1);
           
           rmdir(file_spec.mid(0, pos_after-1/* / */).cstr(String::UL_FILE_SPEC));
   }
   bool file_delete(const String& file_spec, bool fail_on_read_problem) {
           const char *fname=file_spec.cstr(String::UL_FILE_SPEC);
           if(unlink(fname)!=0)
                   if(fail_on_read_problem)
                           throw Exception(errno==EACCES?"file.access":errno==ENOENT?"file.missing":0,
                                   &file_spec, 
                                   "unlink failed: %s (%d), actual filename '%s'", 
                                           strerror(errno), errno, fname);
                   else
                           return false;
   
           rmdir(file_spec, 1);
           return true;
   }
   void file_move(const String& old_spec, const String& new_spec) {
           const char *old_spec_cstr=old_spec.cstr(String::UL_FILE_SPEC);
           const char *new_spec_cstr=new_spec.cstr(String::UL_FILE_SPEC);
           
           create_dir_for_file(new_spec);
   
           if(rename(old_spec_cstr, new_spec_cstr)!=0)
                   throw Exception(errno==EACCES?"file.access":errno==ENOENT?"file.missing":0,
                           &old_spec, 
                           "rename failed: %s (%d), actual filename '%s' to '%s'", 
                                   strerror(errno), errno, old_spec_cstr, new_spec_cstr);
   
           rmdir(old_spec, 1);
   }
   
   
   bool entry_exists(const char *fname, struct stat *afinfo) {
           struct stat lfinfo;
           bool result=stat(fname, &lfinfo)==0;
           if(afinfo)
                   *afinfo=lfinfo;
           return result;
   }
   
   bool entry_exists(const String& file_spec) {
           const char *fname=file_spec.cstr(String::UL_FILE_SPEC);
           return entry_exists(fname, 0);
 }  }
   
   static bool entry_readable(const String& file_spec, bool need_dir) {
       char *fname=file_spec.cstr(String::UL_FILE_SPEC);
           if(need_dir) {
                   size_t size=strlen(fname);
                   while(size) {
                           char c=fname[size-1];
                           if(c=='/' || c=='\\')
                                   fname[--size]=0;
                           else
                                   break;
                   }
           }
           struct stat finfo;
           if(access(fname, R_OK)==0 && entry_exists(fname, &finfo)) {
                   bool is_dir=(finfo.st_mode&S_IFDIR) != 0;
                   return is_dir==need_dir;
           }
           return false;
   }
 bool file_readable(const String& file_spec) {  bool file_readable(const String& file_spec) {
     return access(file_spec.cstr(String::UL_FILE_NAME), R_OK)==0;          return entry_readable(file_spec, false);
   }
   bool dir_readable(const String& file_spec) {
           return entry_readable(file_spec, true);
   }
   String *file_readable(const String& path, const String& name) {
           String *result=new(path.pool()) String(path);
           *result << "/";
           *result << name;
           return file_readable(*result)?result:0;
 }  }
 bool file_executable(const String& file_spec) {  bool file_executable(const String& file_spec) {
     return access(file_spec.cstr(String::UL_FILE_NAME), X_OK)==0;      return access(file_spec.cstr(String::UL_FILE_SPEC), X_OK)==0;
 }  }
   
 size_t file_size(const String& file_spec) {  bool file_stat(const String& file_spec, 
                              size_t& rsize, 
                              time_t& ratime,
                              time_t& rmtime,
                              time_t& rctime,
                              bool fail_on_read_problem) {
         Pool& pool=file_spec.pool();          Pool& pool=file_spec.pool();
         const char *fname=file_spec.cstr(String::UL_FILE_NAME);          const char *fname=file_spec.cstr(String::UL_FILE_SPEC);
     struct stat finfo;      struct stat finfo;
         if(stat(fname, &finfo)!=0)          if(stat(fname, &finfo)!=0)
                 PTHROW(0, 0,                   if(fail_on_read_problem)
                         &file_spec,                           throw Exception("file.missing",
                         "write failed: %s (%d)", strerror(errno), errno);                                  &file_spec, 
         return finfo.st_size;                                  "getting file size failed: %s (%d), real filename '%s'", 
                                           strerror(errno), errno, fname);
                   else
                           return false;
           rsize=finfo.st_size;
           ratime=finfo.st_atime;
           rmtime=finfo.st_mtime;
           rctime=finfo.st_ctime;
           return true;
 }  }
   
 char *getrow(char **row_ref, char delim) {  char *getrow(char **row_ref, char delim) {
Line 209  char *rsplit(char *string, char delim) { Line 451  char *rsplit(char *string, char delim) {
   
 /// @todo less stupid type detection  /// @todo less stupid type detection
 char *format(Pool& pool, double value, char *fmt) {  char *format(Pool& pool, double value, char *fmt) {
         char *result=(char *)pool.malloc(MAX_NUMBER);          char local_buf[MAX_NUMBER];
           size_t size;
           
         if(fmt)          if(fmt)
                 if(strpbrk(fmt, "diouxX"))                  if(strpbrk(fmt, "diouxX"))
                         if(strpbrk(fmt, "ouxX"))                          if(strpbrk(fmt, "ouxX"))
                                 snprintf(result, MAX_NUMBER, fmt, (uint)value );                                  size=snprintf(local_buf, sizeof(local_buf), fmt, (uint)value);
                         else                          else
                                 snprintf(result, MAX_NUMBER, fmt, (int)value );                                  size=snprintf(local_buf, sizeof(local_buf), fmt, (int)value);
                 else                  else
                         snprintf(result, MAX_NUMBER, fmt, value);                          size=snprintf(local_buf, sizeof(local_buf), fmt, value);
         else          else
                 snprintf(result, MAX_NUMBER, "%d", (int)value);                  size=snprintf(local_buf, sizeof(local_buf), "%d", (int)value);
                   
         return result;          char *pool_buf=(char *)pool.malloc(size+1, 4);
           memcpy(pool_buf, local_buf, size+1);
           return pool_buf;
 }  }
   
 size_t stdout_write(const void *buf, size_t size) {  size_t stdout_write(const void *buf, size_t size) {
Line 240  size_t stdout_write(const void *buf, siz Line 486  size_t stdout_write(const void *buf, siz
 #endif  #endif
 }  }
   
 const char *unescape_chars(Pool& pool, const char *cp, int len) {  char *unescape_chars(Pool& pool, const char *cp, int len) {
         char *s=(char *)pool.malloc(len + 1);          char *s=(char *)pool.malloc(len + 1, 5);
         enum EscapeState {          enum EscapeState {
                 EscapeRest,                   EscapeRest, 
                 EscapeFirst,                   EscapeFirst, 
Line 278  const char *unescape_chars(Pool& pool, c Line 524  const char *unescape_chars(Pool& pool, c
         return s;          return s;
 }  }
   
 struct Attributed_meaning_info {  
         String::Untaint_lang lang;  
         String *header;  
 };  
 static void append_attribute_subattribute(const Hash::Key& akey, Hash::Val *avalue,   
                                                                                   void *info) {  
         if(akey==VALUE_NAME)  
                 return;  
   
         Attributed_meaning_info& ami=*static_cast<Attributed_meaning_info *>(info);  
   
         // ...; charset=windows1251  
         *ami.header << "; ";  
         ami.header->append(akey, ami.lang, true);  
         *ami.header << "=";  
         ami.header->append(static_cast<Value *>(avalue)->as_string(), ami.lang, true);  
 }  
 const String& attributed_meaning_to_string(Value& meaning,   
                                                                                    String::Untaint_lang lang) {  
         String &result=*new(meaning.pool()) String(meaning.pool());  
         if(Hash *hash=meaning.get_hash()) {  
                 // $value(value) $subattribute(subattribute value)  
                 if(Value *value=static_cast<Value *>(hash->get(*value_name)))  
                         result.append(value->as_string(), lang, true);  
   
                 Attributed_meaning_info attributed_meaning_info={  
                         lang,  
                         &result  
                 };  
                 hash->for_each(append_attribute_subattribute, &attributed_meaning_info);  
         } else // result value  
                 result.append(meaning.as_string(), lang, true);  
   
         return result;  
 }  
   
 #ifdef WIN32  #ifdef WIN32
 void back_slashes_to_slashes(char *s) {  void back_slashes_to_slashes(char *s) {
         if(s)          if(s)
Line 350  bool StrEqNc(const char *s1, const char Line 560  bool StrEqNc(const char *s1, const char
         }          }
 }  }
   
 char *unquote(char*& current, char stop_at) {  static bool isLeap(int year) {
         char *result=current;      return !(
         char *dest=current;               (year % 4) || ((year % 400) && !(year % 100))
         // skip leading WS              );
         while(*current==' ' || *current=='\t')  }
                 current++;  
         if(!*current)  int getMonthDays(int year, int month) {
                 return current=0;      int monthDays[]={
           31,
         bool quoted=*current=='"';          isLeap(year) ? 29 : 28,
         if(quoted)          31,
                 current++;          30,
           31,
         for(; *current; ) {          30,
                 if(quoted)          31,
                         switch(*current) {          31,
                         case '\\': // "...\c          30,
                                 if(current[1])          31,
                                         current++;          30,
                                 break;          31
                         case '"':      };
                                 current++;      return monthDays[month];
                                 goto break2;  }
                         }  
                 else  void remove_crlf(char *start, char *end) {
                         if(*current==stop_at)          for(char *p=start; p<end; p++)
                                 break;                  switch(*p) {
                           case '\n': *p='|'; break;
                           case '\r': *p=' '; break;
                   }
   }
   
                 *dest++=*current++;  
         }  /// must be last in this file
 break2:  #undef vsnprintf
         if(*current)  int __vsnprintf(char *b, size_t s, const char *f, va_list l) {
                 current++; // skip 'stop_at'          if(!s)
         *dest=0;                  return 0;
         return result;  
           int r;
           // note: on win32& maybe somewhere else
           // vsnprintf do not writes terminating 0 in 'buffer full' case, reducing
           --s;
   #if _MSC_VER
           /*
           win32: 
           mk:@MSITStore:C:\Program%20Files\Microsoft%20Visual%20Studio\MSDN\2001APR\1033\vccore.chm::/html/_crt__vsnprintf.2c_._vsnwprintf.htm
   
             if the number of bytes to write exceeds buffer, then count bytes are written and –1 is returned
           */
           r=_vsnprintf(b, s, f, l);
           if(r<0) 
                   r=s;
   #else
           r=vsnprintf(b, s, f, l);
           /*
           solaris: 
           man vsnprintf
   
             The snprintf() function returns  the  number  of  characters
           formatted, that is, the number of characters that would have
           been written to the buffer if it were large enough.  If  the
           value  of  n  is  0  on a call to snprintf(), an unspecified
           value less than 1 is returned.
           */
   
           if(r<0)
                   r=0;
           else if(r>s)
                   r=s;
   #endif
           b[r]=0;
           return r;
   }
   
   int __snprintf(char *b, size_t s, const char *f, ...) {
           va_list l;
       va_start(l, f);
       int r=__vsnprintf(b, s, f, l);
       va_end(l);
           return r;
   }
   
   int pa_sleep(unsigned long secs, unsigned long usecs) {
           for (; usecs >= 1000000; ++secs, usecs -= 1000000);
   
   #ifdef WIN32
           Sleep(secs * 1000 + usecs / 1000);
           return 0;
   #else
           struct timeval t;
           t.tv_sec = secs;
           t.tv_usec = usecs;
           return (select(0, NULL, NULL, NULL, &t) == -1 ? errno : 0);
   #endif
 }  }

Removed from v.1.49  
changed lines
  Added in v.1.121


E-mail: