Diff for /parser3/src/main/pa_common.C between versions 1.55 and 1.112

version 1.55, 2001/06/28 07:41:59 version 1.112, 2002/08/01 11:41:18
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$  
 */  */
 static char *RCSId="$Id$";   
   static const char* IDENT_COMMON_C="$Date$";
   
 #include "pa_common.h"  #include "pa_common.h"
 #include "pa_types.h"  #include "pa_types.h"
Line 18  static char *RCSId="$Id$"; Line 16  static char *RCSId="$Id$";
 #include "pa_hash.h"  #include "pa_hash.h"
 #include "pa_string.h"  #include "pa_string.h"
   
 #ifndef WIN32  #ifdef WIN32
 #       ifndef _O_TEXT  #       include <windows.h>
 #               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);
   //printf("file_read(%s)\n", fname);
         int f;          int f;
     struct stat finfo;      struct stat finfo;
   
Line 67  bool file_read(Pool& pool, const String& Line 136  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(int(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);
                           // note: after fixing
                           ((char*&)data)[data_size]=0;
                   }
                   return true;
     }      }
         if(fail_on_read_problem)          if(fail_on_read_problem)
                 PTHROW(0, 0,                   throw Exception(errno==EACCES?"file.access":errno==ENOENT?"file.missing":0,
                         &file_spec,                           &file_spec, 
                         "read failed: %s (%d), actual filename '%s'",                           "read failed: %s (%d), actual filename '%s'", 
                                 strerror(errno), errno, fname);                                  strerror(errno), errno, fname);
     return false;      return false;
 }  }
   
 void file_write(Pool& pool,   static void create_dir_for_file(const String& file_spec) {
           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, W_OK)!=0) {/*no*/          if(access(fname, W_OK)!=0) // no
                 size_t pos_after=1;                  create_dir_for_file(file_spec);
                 int pos_before;  
                 while((pos_before=file_spec.pos("/", 1, pos_after))>=0) {  
                         mkdir(file_spec.mid(0, pos_before).cstr(String::UL_FILE_NAME), 0775);  
                         pos_after=pos_before+1;  
                 }  
   
                 if((f=open(fname, O_WRONLY|O_CREAT|_O_BINARY, 0666))>0)          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;
                 }                  }
         }                  
         PTHROW(0, 0,   #if O_TRUNC==0
                 &file_spec,                   if(!do_append)
                 "write failed: %s (%d), actual filename '%s'",                           ftruncate(f, tell(f));
                         strerror(errno), errno, fname);  #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) 
                   write(f, info.data, info.size);
   }
   void file_write(
                                   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);
 }  }
   
   // throws nothing! [this is required in file_move & file_delete]
 static void rmdir(const String& file_spec, size_t pos_after) {  static void rmdir(const String& file_spec, size_t pos_after) {
         int pos_before;          int pos_before;
         if((pos_before=file_spec.pos("/", 1, pos_after))>=0)          if((pos_before=file_spec.pos("/", 1, pos_after))>=0)
                 rmdir(file_spec, pos_before+1);                  rmdir(file_spec, pos_before+1);
                   
         rmdir(file_spec.mid(0, pos_after-1/* / */).cstr(String::UL_FILE_NAME));          rmdir(file_spec.mid(0, pos_after-1/* / */).cstr(String::UL_FILE_SPEC));
 }  }
 void file_delete(Pool& pool, const String& file_spec) {  bool file_delete(const String& file_spec, bool fail_on_read_problem) {
         const char *fname=file_spec.cstr(String::UL_FILE_NAME);          const char *fname=file_spec.cstr(String::UL_FILE_SPEC);
         if(unlink(fname)!=0)          if(unlink(fname)!=0)
                 PTHROW(0, 0,                   if(fail_on_read_problem)
                         &file_spec,                           throw Exception(errno==EACCES?"file.access":errno==ENOENT?"file.missing":0,
                         "unlink failed: %s (%d), actual filename '%s'",                                   &file_spec, 
                                 strerror(errno), errno, fname);                                  "unlink failed: %s (%d), actual filename '%s'", 
                                           strerror(errno), errno, fname);
                   else
                           return false;
   
         rmdir(file_spec, 1);          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);
 }  }
   
   
 static bool entry_readable(const String& file_spec, bool need_dir) {  static bool entry_readable(const String& file_spec, bool need_dir) {
     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(access(fname, R_OK)==0 && stat(fname, &finfo)==0) {          if(access(fname, R_OK)==0 && stat(fname, &finfo)==0) {
                 bool is_dir=(bool)(finfo.st_mode&S_IFDIR);                  bool is_dir=(finfo.st_mode&S_IFDIR) != 0;
                 return is_dir==need_dir;                  return is_dir==need_dir;
         }          }
         return false;          return false;
Line 183  bool file_readable(const String& file_sp Line 351  bool file_readable(const String& file_sp
 bool dir_readable(const String& file_spec) {  bool dir_readable(const String& file_spec) {
         return entry_readable(file_spec, true);          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",
                         "getting file size failed: %s (%d), real filename '%s'",                                   &file_spec, 
                                 strerror(errno), errno, fname);                                  "getting file size failed: %s (%d), real filename '%s'", 
         return finfo.st_size;                                          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 242  char *rsplit(char *string, char delim) { Line 428  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 273  size_t stdout_write(const void *buf, siz Line 463  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 325  static void append_attribute_subattribut Line 515  static void append_attribute_subattribut
   
         // ...; charset=windows1251          // ...; charset=windows1251
         *ami.header << "; ";          *ami.header << "; ";
         ami.header->append(akey, ami.lang, true);          ami.header->append(akey, ami.lang);
         *ami.header << "=";          *ami.header << "=";
         ami.header->append(static_cast<Value *>(avalue)->as_string(), ami.lang, true);          ami.header->append(static_cast<Value *>(avalue)->as_string(), ami.lang);
 }  }
 const String& attributed_meaning_to_string(Value& meaning,   const String& attributed_meaning_to_string(Value& meaning, 
                                                                                    String::Untaint_lang lang) {                                                                                     String::Untaint_lang lang) {
         String &result=*new(meaning.pool()) String(meaning.pool());          String &result=*new(meaning.pool()) String(meaning.pool());
         if(Hash *hash=meaning.get_hash()) {          if(Hash *hash=meaning.get_hash(0)) {
                 // $value(value) $subattribute(subattribute value)                  // $value(value) $subattribute(subattribute value)
                 if(Value *value=static_cast<Value *>(hash->get(*value_name)))                  if(Value *value=static_cast<Value *>(hash->get(*value_name)))
                         result.append(value->as_string(), lang, true);                          result.append(value->as_string(), lang, true);
Line 384  bool StrEqNc(const char *s1, const char Line 574  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.55  
changed lines
  Added in v.1.112


E-mail: