Annotation of parser3/src/main/pa_common.C, revision 1.329
1.15 paf 1: /** @file
1.16 paf 2: Parser: commonly functions.
3:
1.327 moko 4: Copyright (c) 2000-2023 Art. Lebedev Studio (http://www.artlebedev.com)
5: Authors: Konstantin Morshnev <moko@design.ru>, Alexandr Petrosian <paf@design.ru>
1.306 moko 6: */
1.210 paf 7:
1.1 paf 8: #include "pa_common.h"
1.4 paf 9: #include "pa_exception.h"
1.154 paf 10: #include "pa_hash.h"
1.14 paf 11: #include "pa_globals.h"
1.154 paf 12: #include "pa_charsets.h"
1.214 paf 13: #include "pa_http.h"
1.223 misha 14: #include "pa_request_charsets.h"
1.237 misha 15: #include "pcre.h"
1.241 misha 16: #include "pa_request.h"
1.98 paf 17:
1.283 moko 18: #include "pa_idna.h"
19: #include "pa_convert_utf.h"
20:
1.273 moko 21: #ifdef _MSC_VER
1.276 moko 22: #include <windows.h>
1.273 moko 23: #include <direct.h>
24: #endif
25:
1.277 moko 26: #ifdef _MSC_VER
27: #define pa_mkdir(path, mode) _mkdir(path)
28: #else
29: #define pa_mkdir(path, mode) mkdir(path, mode)
30: #endif
31:
1.329 ! moko 32: volatile const char * IDENT_PA_COMMON_C="$Id: pa_common.C,v 1.328 2023/11/16 00:40:42 moko Exp $" IDENT_PA_COMMON_H IDENT_PA_HASH_H IDENT_PA_ARRAY_H IDENT_PA_STACK_H;
1.267 moko 33:
1.93 paf 34: // some maybe-undefined constants
35:
1.82 paf 36: #ifndef _O_TEXT
37: # define _O_TEXT 0
38: #endif
39: #ifndef _O_BINARY
40: # define _O_BINARY 0
1.47 paf 41: #endif
1.80 paf 42:
1.138 paf 43: #ifdef HAVE_FTRUNCATE
44: # define PA_O_TRUNC 0
45: #else
46: # ifdef _O_TRUNC
47: # define PA_O_TRUNC _O_TRUNC
48: # else
49: # error you must have either ftruncate function or _O_TRUNC bit declared
50: # endif
1.154 paf 51: #endif
1.176 paf 52:
1.154 paf 53: // defines for globals
54:
55: #define FILE_STATUS_NAME "status"
56:
57: // globals
58:
59: const String file_status_name(FILE_STATUS_NAME);
60:
1.305 moko 61: String sql_bind_name(SQL_BIND_NAME);
62: String sql_limit_name(PA_SQL_LIMIT_NAME);
63: String sql_offset_name(PA_SQL_OFFSET_NAME);
64: String sql_default_name(SQL_DEFAULT_NAME);
65: String sql_distinct_name(SQL_DISTINCT_NAME);
66: String sql_value_type_name(SQL_VALUE_TYPE_NAME);
67:
1.301 moko 68: // forwards
69:
70: const UTF16* pa_utf16_encode(const char* in, Charset& source_charset);
71:
1.154 paf 72: // functions
1.127 paf 73:
1.301 moko 74: #ifdef _MSC_VER
75:
76: int pa_stat(const char *pathname, struct stat *buffer){
77: const UTF16* utf16name=pa_utf16_encode(pathname, pa_thread_request().charsets.source());
78: return _wstat64((const wchar_t *)utf16name, buffer);
79: }
80:
81: int pa_open(const char *pathname, int flags, int mode){
82: const UTF16* utf16name=pa_utf16_encode(pathname, pa_thread_request().charsets.source());
83: return _wopen((const wchar_t *)utf16name, flags, mode);
84: }
85:
86: FILE *pa_fopen(const char *pathname, const char *mode){
87: const UTF16* utf16name=pa_utf16_encode(pathname, pa_thread_request().charsets.source());
88: const UTF16* utf16mode=pa_utf16_encode(mode, pa_thread_request().charsets.source());
89: return _wfopen((const wchar_t *)utf16name, (const wchar_t *)utf16mode);
90: }
91:
92: #endif
93:
1.206 paf 94: /// these options were handled but not checked elsewhere, now check them
1.239 misha 95: int pa_get_valid_file_options_count(HashStringValue& options) {
1.206 paf 96: int result=0;
97: if(options.get(PA_SQL_LIMIT_NAME))
98: result++;
99: if(options.get(PA_SQL_OFFSET_NAME))
100: result++;
101: if(options.get(PA_COLUMN_SEPARATOR_NAME))
102: result++;
103: if(options.get(PA_COLUMN_ENCLOSER_NAME))
104: result++;
1.223 misha 105: if(options.get(PA_CHARSET_NAME))
106: result++;
1.206 paf 107: return result;
108: }
109:
1.123 paf 110: #ifndef DOXYGEN
111: struct File_read_action_info {
1.154 paf 112: char **data; size_t *data_size;
1.318 moko 113: char* buf; uint64_t offset; size_t limit;
1.126 paf 114: };
1.123 paf 115: #endif
1.271 moko 116:
1.289 moko 117: static void file_read_action(struct stat& finfo, int f, const String& file_spec, void *context) {
1.310 moko 118: File_read_action_info& info = *static_cast<File_read_action_info *>(context);
1.326 moko 119: size_t to_read_size = check_file_size(info.limit && info.limit < (size_t)finfo.st_size ? info.limit : (size_t)finfo.st_size, &file_spec);
1.271 moko 120: if(to_read_size) {
1.320 moko 121: if(info.offset)
122: pa_lseek(f, info.offset, SEEK_SET); // seek never fails as POSIX allows the file offset to be set beyond the EOF
1.310 moko 123: *info.data = info.buf ? info.buf : (char *)pa_malloc_atomic(to_read_size+1);
124: ssize_t result = read(f, *info.data, to_read_size);
1.271 moko 125: if(result<0)
126: throw Exception("file.read", &file_spec, "read failed: %s (%d)", strerror(errno), errno);
1.310 moko 127: *info.data_size = result;
1.123 paf 128: } else { // empty file
1.209 paf 129: // for both, text and binary: for text we need that terminator, for binary we need nonzero pointer to be able to save such files
1.310 moko 130: *info.data = (char *)pa_malloc_atomic(1);
131: *(char*)(*info.data) = 0;
132: *info.data_size = 0;
1.123 paf 133: return;
134: }
1.126 paf 135: }
1.241 misha 136:
1.318 moko 137: File_read_result file_read_binary(const String& file_spec, bool fail_on_read_problem, char* buf, uint64_t offset, size_t limit) {
1.310 moko 138: File_read_result result = {false, 0, 0, 0};
139: File_read_action_info info = {&result.str, &result.length, buf, offset, limit};
1.309 moko 140:
1.310 moko 141: result.success = file_read_action_under_lock(file_spec, "read", file_read_action, &info, 0, fail_on_read_problem);
1.309 moko 142: return result;
143: }
144:
1.154 paf 145: File_read_result file_read(Request_charsets& charsets, const String& file_spec,
1.310 moko 146: bool as_text, HashStringValue *options,
1.229 misha 147: bool fail_on_read_problem,
1.310 moko 148: size_t offset = 0, size_t limit = 0, bool transcode_text_result = true) {
149: File_read_result result = {false, 0, 0, 0};
150: if(options){
151: int valid_options = pa_get_valid_file_options_count(*options);
152: if(valid_options != options->count())
1.262 misha 153: throw Exception(PARSER_RUNTIME, 0, CALLED_WITH_INVALID_OPTION);
1.241 misha 154: }
1.203 paf 155:
1.310 moko 156: File_read_action_info info = {&result.str, &result.length, 0, offset, limit};
1.161 paf 157:
1.310 moko 158: result.success = file_read_action_under_lock(file_spec, "read", file_read_action, &info, as_text, fail_on_read_problem);
1.223 misha 159:
1.241 misha 160: if(as_text){
161: if(result.success){
1.310 moko 162: Charset* asked_charset = 0;
163: if(options)
164: if(Value* vcharset_name = options->get(PA_CHARSET_NAME))
165: asked_charset = &pa_charsets.get(vcharset_name->as_string());
1.263 misha 166:
1.310 moko 167: asked_charset = pa_charsets.checkBOM(result.str, result.length, asked_charset);
1.287 moko 168:
1.263 misha 169: if(result.length && transcode_text_result && asked_charset){ // length must be checked because transcode returns CONST string in case length==0, which contradicts hacking few lines below
1.310 moko 170: String::C body = String::C(result.str, result.length);
1.263 misha 171: body=Charset::transcode(body, *asked_charset, charsets.source());
1.236 misha 172:
1.310 moko 173: result.str = const_cast<char*>(body.str); // hacking a little
174: result.length = body.length;
1.131 paf 175: }
176: }
1.241 misha 177: if(result.length)
178: fix_line_breaks(result.str, result.length);
1.123 paf 179: }
1.241 misha 180:
181: return result;
182: }
183:
184: File_read_result file_load(Request& r, const String& file_spec,
1.310 moko 185: bool as_text, HashStringValue *options,
1.241 misha 186: bool fail_on_read_problem,
1.310 moko 187: bool transcode_text_result) {
188:
189: size_t offset = 0;
190: size_t limit = 0;
191:
192: if(options){
193: if(Value *voffset = (Value *)options->get(sql_offset_name))
194: offset = r.process(*voffset).as_int();
195: if(Value *vlimit = (Value *)options->get(sql_limit_name))
196: limit = r.process(*vlimit).as_int();
197: // no check on options count here
198: }
1.241 misha 199:
200: if(file_spec.starts_with("http://")) {
1.310 moko 201: if(offset || limit)
1.289 moko 202: throw Exception(PARSER_RUNTIME, 0, "offset and load options are not supported for HTTP:// file load");
1.241 misha 203:
204: // fail on read problem
1.310 moko 205: File_read_http_result http = pa_internal_file_read_http(r, file_spec, as_text, options, transcode_text_result);
206:
207: File_read_result result = {true, http.str, http.length, http.headers};
208: return result;
1.241 misha 209: } else
1.310 moko 210: return file_read(r.charsets, file_spec, as_text, options, fail_on_read_problem, offset, limit, transcode_text_result);
211: }
1.126 paf 212:
1.310 moko 213: char* file_read_text(Request_charsets& charsets, const String& file_spec, bool fail_on_read_problem) {
214: File_read_result file = file_read(charsets, file_spec, true, 0, fail_on_read_problem);
215: return file.success ? file.str : 0;
1.123 paf 216: }
217:
1.310 moko 218: char* file_load_text(Request& r, const String& file_spec, bool fail_on_read_problem, HashStringValue* options, bool transcode_result) {
219: File_read_result file = file_load(r, file_spec, true, options, fail_on_read_problem, transcode_result);
220: return file.success ? file.str : 0;
221: }
1.257 pretende 222:
1.154 paf 223: #ifdef PA_SAFE_MODE
1.259 misha 224: void check_safe_mode(struct stat finfo, const String& file_spec, const char* fname) {
1.154 paf 225: if(finfo.st_uid/*foreign?*/!=geteuid()
226: && finfo.st_gid/*foreign?*/!=getegid())
1.289 moko 227: throw Exception(PARSER_RUNTIME,
228: &file_spec,
229: "parser is in safe mode: reading files of foreign group and user disabled "
230: "[recompile parser with --disable-safe-mode configure option], "
231: "actual filename '%s', fuid(%d)!=euid(%d) or fgid(%d)!=egid(%d)",
232: fname, finfo.st_uid, geteuid(), finfo.st_gid, getegid()
233: );
1.259 misha 234: }
235: #else
236: void check_safe_mode(struct stat, const String&, const char*) {
237: }
1.257 pretende 238: #endif
1.259 misha 239:
1.257 pretende 240:
1.149 paf 241:
1.154 paf 242: bool file_read_action_under_lock(const String& file_spec,
1.126 paf 243: const char* action_name, File_read_action action, void *context,
244: bool as_text,
1.123 paf 245: bool fail_on_read_problem) {
1.247 misha 246: const char* fname=file_spec.taint_cstr(String::L_FILE_SPEC);
1.33 paf 247: int f;
248:
249: // first open, next stat:
1.45 paf 250: // directory update of NTFS hard links performed on open.
1.33 paf 251: // ex:
252: // a.html:^test[] and b.html hardlink to a.html
253: // user inserts ! before ^test in a.html
1.126 paf 254: // directory entry of b.html in NTFS not updated at once,
1.35 paf 255: // they delay update till open, so we would receive "!^test[" string
256: // if would do stat, next open.
1.123 paf 257: // later: it seems, even this does not help sometimes
1.301 moko 258: if((f=pa_open(fname, O_RDONLY|(as_text?_O_TEXT:_O_BINARY)))>=0) {
1.123 paf 259: try {
1.162 paf 260: if(pa_lock_shared_blocking(f)!=0)
1.289 moko 261: throw Exception("file.lock", &file_spec, "shared lock failed: %s (%d), actual filename '%s'", strerror(errno), errno, fname);
1.123 paf 262:
1.124 paf 263: struct stat finfo;
1.298 moko 264: if(pa_fstat(f, &finfo)!=0)
1.124 paf 265: throw Exception("file.missing", // hardly possible: we just opened it OK
1.289 moko 266: &file_spec, "stat failed: %s (%d), actual filename '%s'", strerror(errno), errno, fname);
1.124 paf 267:
1.149 paf 268: check_safe_mode(finfo, file_spec, fname);
1.32 paf 269:
1.289 moko 270: action(finfo, f, file_spec, context);
1.123 paf 271: } catch(...) {
1.162 paf 272: pa_unlock(f);close(f);
1.123 paf 273: if(fail_on_read_problem)
1.154 paf 274: rethrow;
1.289 moko 275: return false;
1.123 paf 276: }
1.87 paf 277:
1.162 paf 278: pa_unlock(f);close(f);
1.72 parser 279: return true;
1.229 misha 280: } else {
1.118 paf 281: if(fail_on_read_problem)
1.289 moko 282: throw Exception(errno==EACCES ? "file.access" : (errno==ENOENT || errno==ENOTDIR || errno==ENODEV) ? "file.missing" : 0,
283: &file_spec, "%s failed: %s (%d), actual filename '%s'", action_name, strerror(errno), errno, fname);
1.118 paf 284: return false;
285: }
1.8 paf 286: }
287:
1.202 paf 288: void create_dir_for_file(const String& file_spec) {
1.324 moko 289: const char *str=file_spec.taint_cstr(String::L_FILE_SPEC);
290: if(str[0]){
291: const char *pos=str+1;
292: while((pos=strchr(pos,'/')) && pos[1]) { // to avoid trailing /, see #1166
293: pa_mkdir(pa_strdup(str,pos-str), 0775);
294: pos++;
295: }
1.63 parser 296: }
297: }
298:
1.98 paf 299: bool file_write_action_under_lock(
1.28 paf 300: const String& file_spec,
1.225 misha 301: const char* action_name,
302: File_write_action action,
303: void *context,
1.126 paf 304: bool as_text,
305: bool do_append,
306: bool do_block,
1.110 paf 307: bool fail_on_lock_problem) {
1.247 misha 308: const char* fname=file_spec.taint_cstr(String::L_FILE_SPEC);
1.28 paf 309: int f;
1.80 paf 310: if(access(fname, W_OK)!=0) // no
1.126 paf 311: create_dir_for_file(file_spec);
1.50 paf 312:
1.301 moko 313: if((f=pa_open(fname,
1.80 paf 314: O_CREAT|O_RDWR
315: |(as_text?_O_TEXT:_O_BINARY)
1.138 paf 316: |(do_append?O_APPEND:PA_O_TRUNC), 0664))>=0) {
1.162 paf 317: if((do_block?pa_lock_exclusive_blocking(f):pa_lock_exclusive_nonblocking(f))!=0) {
1.289 moko 318: Exception e("file.lock", &file_spec, "shared lock failed: %s (%d), actual filename '%s'", strerror(errno), errno, fname);
1.126 paf 319: close(f);
1.110 paf 320: if(fail_on_lock_problem)
321: throw e;
1.98 paf 322: return false;
323: }
1.96 paf 324:
1.158 paf 325: try {
1.254 misha 326: #if (defined(HAVE_FCHMOD) && defined(PA_SAFE_MODE))
327: struct stat finfo;
1.298 moko 328: if(pa_fstat(f, &finfo)==0 && finfo.st_mode & 0111)
1.254 misha 329: fchmod(f, finfo.st_mode & 0666/*clear executable bits*/); // backward: ignore errors if any
330: #endif
331: action(f, context);
1.158 paf 332: } catch(...) {
1.138 paf 333: #ifdef HAVE_FTRUNCATE
1.104 paf 334: if(!do_append)
1.125 paf 335: ftruncate(f, lseek(f, 0, SEEK_CUR)); // one can not use O_TRUNC, read lower
1.138 paf 336: #endif
1.162 paf 337: pa_unlock(f);close(f);
1.154 paf 338: rethrow;
1.158 paf 339: }
1.80 paf 340:
1.138 paf 341: #ifdef HAVE_FTRUNCATE
1.104 paf 342: if(!do_append)
1.125 paf 343: ftruncate(f, lseek(f, 0, SEEK_CUR)); // O_TRUNC truncates even exclusevely write-locked file [thanks to Igor Milyakov <virtan@rotabanner.com> for discovering]
1.138 paf 344: #endif
1.162 paf 345: pa_unlock(f);close(f);
1.98 paf 346: return true;
1.80 paf 347: } else
1.289 moko 348: throw Exception(errno==EACCES ? "file.access" : 0, &file_spec, "%s failed: %s (%d), actual filename '%s'", action_name, strerror(errno), errno, fname);
1.96 paf 349: // here should be nothing, see rethrow above
350: }
351:
352: #ifndef DOXYGEN
353: struct File_write_action_info {
1.250 misha 354: const char* str;
355: size_t length;
1.126 paf 356: };
1.96 paf 357: #endif
1.271 moko 358:
1.96 paf 359: static void file_write_action(int f, void *context) {
1.126 paf 360: File_write_action_info& info=*static_cast<File_write_action_info *>(context);
1.154 paf 361: if(info.length) {
1.271 moko 362: ssize_t written=write(f, info.str, info.length);
1.116 paf 363: if(written<0)
1.271 moko 364: throw Exception("file.write", 0, "write failed: %s (%d)", strerror(errno), errno);
1.275 moko 365: if((size_t)written!=info.length)
1.271 moko 366: throw Exception("file.write", 0, "write failed: %u of %u bytes written", written, info.length);
1.113 paf 367: }
1.96 paf 368: }
1.271 moko 369:
1.96 paf 370: void file_write(
1.250 misha 371: Request_charsets& charsets,
372: const String& file_spec,
373: const char* data,
374: size_t size,
1.126 paf 375: bool as_text,
1.250 misha 376: bool do_append,
377: Charset* asked_charset) {
378:
379: if(as_text && asked_charset){
380: String::C body=String::C(data, size);
381: body=Charset::transcode(body, charsets.source(), *asked_charset);
382: data=body.str;
383: size=body.length;
384: };
385:
1.126 paf 386: File_write_action_info info={data, size};
1.225 misha 387:
1.98 paf 388: file_write_action_under_lock(
1.154 paf 389: file_spec,
1.225 misha 390: "write",
391: file_write_action,
392: &info,
1.154 paf 393: as_text,
394: do_append);
1.30 paf 395: }
396:
1.261 misha 397: static size_t get_dir(char* fname, size_t helper_length){
398: bool dir=false;
399: size_t pos=0;
400: for(pos=helper_length; pos; pos--){
401: char c=fname[pos-1];
402: if(c=='/' || c=='\\'){
403: fname[pos-1]=0;
404: dir=true;
405: } else if(dir) break;
406: }
407: return pos;
408: }
409:
1.312 moko 410: bool entry_exists(const char* fname, struct stat *afinfo) {
411: struct stat lfinfo;
412: bool result=pa_stat(fname, &lfinfo)==0;
413: if(afinfo)
414: *afinfo=lfinfo;
415: return result;
416: }
417:
418: bool entry_exists(const String& file_spec) {
419: return entry_exists(file_spec.taint_cstr(String::L_FILE_SPEC), 0);
420: }
421:
422: static bool entry_ifdir(char *fname, bool need_dir) {
1.261 misha 423: if(need_dir){
424: size_t size=strlen(fname);
425: while(size) {
426: char c=fname[size-1];
427: if(c=='/' || c=='\\')
428: fname[--size]=0;
429: else
430: break;
431: }
432: }
433:
434: struct stat finfo;
1.311 moko 435: if(entry_exists(fname, &finfo)) {
1.261 misha 436: bool is_dir=(finfo.st_mode&S_IFDIR) != 0;
437: return is_dir==need_dir;
438: }
439: return false;
440: }
441:
1.312 moko 442: static bool entry_ifdir(const String& file_spec, bool need_dir) {
443: return entry_ifdir(file_spec.taint_cstrm(String::L_FILE_SPEC), need_dir);
444: }
445:
1.63 parser 446: // throws nothing! [this is required in file_move & file_delete]
1.277 moko 447: static void rmdir(const String& file_spec, size_t pos_after) {
1.261 misha 448: char* dir_spec=file_spec.taint_cstrm(String::L_FILE_SPEC);
449: size_t length=strlen(dir_spec);
450: while( (length=get_dir(dir_spec, length)) && (length > pos_after) ){
1.274 moko 451: #ifdef _MSC_VER
1.312 moko 452: if(!entry_ifdir(dir_spec, true))
1.261 misha 453: break;
454: DWORD attrs=GetFileAttributes(dir_spec);
455: if(
456: (attrs==INVALID_FILE_ATTRIBUTES)
457: || !(attrs & FILE_ATTRIBUTE_DIRECTORY)
458: || (attrs & FILE_ATTRIBUTE_REPARSE_POINT)
459: )
460: break;
461: #endif
462: if( rmdir(dir_spec) )
463: break;
464: };
1.50 paf 465: }
1.239 misha 466:
1.269 misha 467: bool file_delete(const String& file_spec, bool fail_on_problem, bool keep_empty_dirs) {
1.247 misha 468: const char* fname=file_spec.taint_cstr(String::L_FILE_SPEC);
1.282 moko 469: if(unlink(fname)!=0) {
1.164 paf 470: if(fail_on_problem)
1.289 moko 471: throw Exception(errno==EACCES?"file.access":errno==ENOENT?"file.missing":0,
472: &file_spec, "unlink failed: %s (%d), actual filename '%s'", strerror(errno), errno, fname);
1.93 paf 473: else
474: return false;
1.282 moko 475: }
1.50 paf 476:
1.269 misha 477: if(!keep_empty_dirs)
478: rmdir(file_spec, 1);
479:
1.93 paf 480: return true;
1.60 parser 481: }
1.239 misha 482:
1.269 misha 483: void file_move(const String& old_spec, const String& new_spec, bool keep_empty_dirs) {
1.247 misha 484: const char* old_spec_cstr=old_spec.taint_cstr(String::L_FILE_SPEC);
485: const char* new_spec_cstr=new_spec.taint_cstr(String::L_FILE_SPEC);
1.63 parser 486:
1.126 paf 487: create_dir_for_file(new_spec);
1.63 parser 488:
1.60 parser 489: if(rename(old_spec_cstr, new_spec_cstr)!=0)
1.289 moko 490: throw Exception(errno==EACCES ? "file.access" : errno==ENOENT ? "file.missing" : 0,
491: &old_spec, "rename failed: %s (%d), actual filename '%s' to '%s'", strerror(errno), errno, old_spec_cstr, new_spec_cstr);
1.63 parser 492:
1.269 misha 493: if(!keep_empty_dirs)
494: rmdir(old_spec, 1);
1.31 paf 495: }
496:
1.51 paf 497:
1.215 paf 498: bool file_exist(const String& file_spec) {
1.312 moko 499: return entry_ifdir(file_spec, false);
1.51 paf 500: }
1.239 misha 501:
1.215 paf 502: bool dir_exists(const String& file_spec) {
1.312 moko 503: return entry_ifdir(file_spec, true);
1.65 parser 504: }
1.239 misha 505:
1.215 paf 506: const String* file_exist(const String& path, const String& name) {
1.154 paf 507: String& result=*new String(path);
1.270 moko 508: if(path.last_char() != '/')
509: result << "/";
1.154 paf 510: result << name;
1.215 paf 511: return file_exist(result)?&result:0;
1.43 paf 512: }
1.239 misha 513:
1.43 paf 514: bool file_executable(const String& file_spec) {
1.247 misha 515: return access(file_spec.taint_cstr(String::L_FILE_SPEC), X_OK)==0;
1.44 paf 516: }
517:
1.296 moko 518: bool file_stat(const String& file_spec, uint64_t& rsize, time_t& ratime, time_t& rmtime, time_t& rctime, bool fail_on_read_problem) {
1.247 misha 519: const char* fname=file_spec.taint_cstr(String::L_FILE_SPEC);
1.154 paf 520: struct stat finfo;
1.298 moko 521: if(pa_stat(fname, &finfo)!=0) {
1.64 parser 522: if(fail_on_read_problem)
1.289 moko 523: throw Exception("file.missing", &file_spec, "getting file size failed: %s (%d), real filename '%s'", strerror(errno), errno, fname);
1.64 parser 524: else
525: return false;
1.282 moko 526: }
1.58 parser 527: rsize=finfo.st_size;
1.299 moko 528: ratime=(time_t)finfo.st_atime;
529: rmtime=(time_t)finfo.st_mtime;
530: rctime=(time_t)finfo.st_ctime;
1.64 parser 531: return true;
1.18 paf 532: }
533:
1.313 moko 534: size_t check_file_size(uint64_t size, const String* file_spec){
1.319 moko 535: if(size > (uint64_t)pa_file_size_limit)
1.313 moko 536: throw Exception(PARSER_RUNTIME, file_spec, "content size of %.15g bytes exceeds the limit (%.15g bytes)", (double)size, (double)pa_file_size_limit);
1.300 moko 537: return (size_t)size;
538: }
539:
1.278 moko 540: /**
541: String related functions
542: */
543:
544: bool capitalized(const char* s){
545: bool upper=true;
546: for(const char* c=s; *c; c++){
547: if(*c != (upper ? toupper((unsigned char)*c) : tolower((unsigned char)*c)))
548: return false;
549: upper=strchr("-_ ", *c) != 0;
550: }
551: return true;
552: }
553:
554: const char* capitalize(const char* s){
555: if(!s || capitalized(s))
556: return s;
557:
558: char* result=pa_strdup(s);
559: if(result){
560: bool upper=true;
561: for(char* c=result; *c; c++){
562: *c=upper ? (char)toupper((unsigned char)*c) : (char)tolower((unsigned char)*c);
563: upper=strchr("-_ ", *c) != 0;
564: }
565: }
566: return (const char*)result;
567: }
568:
1.323 moko 569: char *str_lower(const char *s, size_t length){
570: char *result=pa_strdup(s, length);
1.290 moko 571: for(char* c=result; *c; c++)
572: *c=(char)tolower((unsigned char)*c);
573: return result;
574: }
575:
1.323 moko 576: char *str_upper(const char *s, size_t length){
577: char *result=pa_strdup(s, length);
1.290 moko 578: for(char* c=result; *c; c++)
579: *c=(char)toupper((unsigned char)*c);
580: return result;
581: }
582:
1.278 moko 583: void fix_line_breaks(char *str, size_t& length) {
584: //_asm int 3;
585: const char* const eob=str+length;
586: char* dest=str;
587: // fix DOS: \r\n -> \n
588: // fix Macintosh: \r -> \n
589: char* bol=str;
590: while(char* eol=(char*)memchr(bol, '\r', eob -bol)) {
591: size_t len=eol-bol;
592: if(dest!=bol)
593: memmove(dest, bol, len);
594: dest+=len;
595: *dest++='\n';
596:
597: if(&eol[1]<eob && eol[1]=='\n') { // \r, \n = DOS
598: bol=eol+2;
599: length--;
600: } else // \r, not \n = Macintosh
601: bol=eol+1;
602: }
603: // last piece without \r
604: if(dest!=bol)
605: memmove(dest, bol, eob-bol);
606: str[length]=0; // terminating
607: }
608:
609: /**
610: scans for @a delim[default \n] in @a *row_ref,
611: @return piece of line before it or end of string, if no @a delim found
612: assigns @a *row_ref to point right after delimiter if there were one
613: or to zero if no @a delim were found.
614: */
615:
1.126 paf 616: char* getrow(char* *row_ref, char delim) {
1.229 misha 617: char* result=*row_ref;
618: if(result) {
1.126 paf 619: *row_ref=strchr(result, delim);
1.8 paf 620: if(*row_ref)
621: *((*row_ref)++)=0;
622: else if(!*result)
623: return 0;
1.229 misha 624: }
625: return result;
1.8 paf 626: }
627:
1.126 paf 628: char* lsplit(char* string, char delim) {
1.229 misha 629: if(string) {
1.126 paf 630: char* v=strchr(string, delim);
1.8 paf 631: if(v) {
632: *v=0;
633: return v+1;
634: }
1.229 misha 635: }
636: return 0;
1.8 paf 637: }
638:
1.126 paf 639: char* lsplit(char* *string_ref, char delim) {
1.229 misha 640: char* result=*string_ref;
1.126 paf 641: char* next=lsplit(*string_ref, delim);
1.229 misha 642: *string_ref=next;
643: return result;
1.9 paf 644: }
645:
1.126 paf 646: char* rsplit(char* string, char delim) {
1.229 misha 647: if(string) {
1.126 paf 648: char* v=strrchr(string, delim);
1.18 paf 649: if(v) {
1.9 paf 650: *v=0;
651: return v+1;
652: }
1.229 misha 653: }
1.314 moko 654: return NULL;
655: }
656:
1.325 moko 657: void pa_strncpy(char *dst, const char *src, size_t n){
658: size_t left = n;
659:
660: if (left != 0 && src) {
661: while (--left != 0) {
662: if ((*dst++ = *src++) == '\0')
663: return;
664: }
665: }
666: if (n != 0)
667: *dst = '\0';
668: }
669:
1.314 moko 670: #define STRCAT_STEP(str, len) if(str) { memcpy(ptr, str, len); ptr += len; }
671:
672: char *pa_strcat(const char *a, const char *b, const char *c) {
673: size_t len_a = a ? strlen(a) : 0;
1.315 moko 674: size_t len_b = b ? strlen(b) : 0;
675: size_t len_c = c ? strlen(c) : 0;
1.314 moko 676: char *result=new(PointerFreeGC) char[len_a + len_b + len_c +1/*0*/];
677: char *ptr=result;
678: STRCAT_STEP(a, len_a);
679: STRCAT_STEP(b, len_b);
680: STRCAT_STEP(c, len_c);
681: *ptr='\0';
682: return result;
1.10 paf 683: }
684:
1.317 moko 685: const char *pa_filename(const char *path){
686: if(!path)
687: return NULL;
688: for(const char *c = path + strlen(path) - 1; c >= path; c--) {
689: if(*c == '/' || *c == '\\')
690: return c+1;
691: }
692: return path;
693: }
1.229 misha 694:
695: // format: %[flags][width][.precision]type http://msdn.microsoft.com/ru-ru/library/56e442dc(en-us,VS.80).aspx
696: // flags: '-', '+', ' ', '#', '0' http://msdn.microsoft.com/ru-ru/library/8aky45ct(en-us,VS.80).aspx
697: // width, precision: non negative decimal number
698: enum FormatType {
699: FormatInvalid,
700: FormatInt,
701: FormatUInt,
702: FormatDouble
703: };
1.272 moko 704: FormatType format_type(const char* fmt){
1.229 misha 705: enum FormatState {
706: Percent,
707: Flags,
708: Width,
709: Precision,
710: Done
711: } state=Percent;
712:
713: FormatType result=FormatInvalid;
714:
1.272 moko 715: const char* pos=fmt;
1.229 misha 716: while(char c=*(pos++)){
717: switch(state){
718: case Percent:
719: if(c=='%'){
720: state=Flags;
721: } else {
722: return FormatInvalid; // 1st char must be '%' only
723: }
724: break;
725: case Flags:
726: if(strchr("-+ #0", c)!=0){
727: break;
728: }
729: // go to the next step
730: case Width:
731: if(c=='.'){
732: state=Precision;
733: break;
734: }
735: // go to the next step
736: case Precision:
737: if(c>='0' && c<='9'){
738: if(state == Flags) state=Width; // no more flags
739: break;
740: } else if(c=='d' || c=='i'){
741: result=FormatInt;
742: } else if(strchr("feEgG", c)!=0){
743: result=FormatDouble;
744: } else if(strchr("uoxX", c)!=0){
745: result=FormatUInt;
746: } else {
747: return FormatInvalid; // invalid char
748: }
749: state=Done;
750: break;
751: case Done:
752: return FormatInvalid; // no chars allowed after 'type'
753: }
754: }
755: return result;
756: }
757:
758:
1.272 moko 759: const char* format(double value, const char* fmt) {
1.229 misha 760: char local_buf[MAX_NUMBER];
1.235 misha 761: int size=-1;
1.229 misha 762:
763: if(fmt && strlen(fmt)){
764: switch(format_type(fmt)){
765: case FormatDouble:
1.329 ! moko 766: size=snprintf(local_buf, sizeof(local_buf), fmt, value);
1.229 misha 767: break;
1.328 moko 768: case FormatUInt:
769: if(value >= 0){ // on Apple M1 (uint)<negative value> is 0
1.329 ! moko 770: size=snprintf(local_buf, sizeof(local_buf), fmt, clip2uint(value));
1.328 moko 771: break;
772: }
1.229 misha 773: case FormatInt:
1.329 ! moko 774: size=snprintf(local_buf, sizeof(local_buf), fmt, clip2int(value));
1.229 misha 775: break;
776: case FormatInvalid:
1.289 moko 777: throw Exception(PARSER_RUNTIME, 0, "Incorrect format string '%s' was specified.", fmt);
1.229 misha 778: }
779: } else
1.329 ! moko 780: size=snprintf(local_buf, sizeof(local_buf), "%d", clip2int(value));
1.229 misha 781:
782: if(size < 0 || size >= MAX_NUMBER-1){ // on win32 we manually reduce max size while printing
1.304 moko 783: throw Exception(PARSER_RUNTIME, 0, "Error occurred white executing snprintf with format string '%s'.", fmt);
1.229 misha 784: }
785:
1.235 misha 786: return pa_strdup(local_buf, (size_t)size);
1.12 paf 787: }
788:
1.36 paf 789: size_t stdout_write(const void *buf, size_t size) {
1.12 paf 790: #ifdef WIN32
1.187 paf 791: size_t to_write = size;
1.12 paf 792: do{
1.316 moko 793: int chunk_written=fwrite(buf, 1, min((size_t)8*0x400, size), stdout);
1.12 paf 794: if(chunk_written<=0)
795: break;
796: size-=chunk_written;
1.36 paf 797: buf=((const char*)buf)+chunk_written;
1.316 moko 798: } while(size>0);
1.12 paf 799:
1.316 moko 800: fflush(stdout);
1.187 paf 801: return to_write-size;
1.12 paf 802: #else
1.316 moko 803: size_t result=fwrite(buf, 1, size, stdout);
804: fflush(stdout);
805: return result;
1.12 paf 806: #endif
1.2 paf 807: }
1.14 paf 808:
1.229 misha 809: enum EscapeState {
810: EscapeRest,
811: EscapeFirst,
812: EscapeSecond,
813: EscapeUnicode
814: };
815:
1.236 misha 816: // @todo prescan for reduce required size (unescaped sting in 1 byte charset requires less memory usually)
1.258 misha 817: char* unescape_chars(const char* cp, int len, Charset* charset, bool js){
1.236 misha 818: char* s=new(PointerFreeGC) char[len+1]; // must be enough (%uXXXX==6 bytes, max utf-8 char length==6 bytes)
1.230 misha 819: char* dst=s;
1.229 misha 820: EscapeState escapeState=EscapeRest;
821: uint escapedValue=0;
822: int srcPos=0;
1.230 misha 823: short int jsCnt=0;
1.236 misha 824: while(srcPos<len){
1.229 misha 825: uchar c=(uchar)cp[srcPos];
1.258 misha 826: if(c=='%' || (c=='\\' && js)){
1.229 misha 827: escapeState=EscapeFirst;
828: } else {
829: switch(escapeState) {
830: case EscapeRest:
1.286 moko 831: if(c=='+' && !js){
1.230 misha 832: *dst++=' ';
1.229 misha 833: } else {
1.230 misha 834: *dst++=c;
1.229 misha 835: }
836: break;
837: case EscapeFirst:
1.232 misha 838: if(charset && c=='u'){
1.229 misha 839: // escaped unicode value: %u0430
840: jsCnt=0;
841: escapedValue=0;
842: escapeState=EscapeUnicode;
843: } else {
1.231 misha 844: if(isxdigit(c)){
1.229 misha 845: escapedValue=hex_value[c] << 4;
846: escapeState=EscapeSecond;
847: } else {
1.230 misha 848: *dst++=c;
1.229 misha 849: escapeState=EscapeRest;
850: }
851: }
852: break;
853: case EscapeSecond:
1.231 misha 854: if(isxdigit(c)){
1.229 misha 855: escapedValue+=hex_value[c];
1.230 misha 856: *dst++=(char)escapedValue;
1.229 misha 857: }
858: escapeState=EscapeRest;
859: break;
860: case EscapeUnicode:
1.231 misha 861: if(isxdigit(c)){
1.229 misha 862: escapedValue=(escapedValue << 4) + hex_value[c];
863: if(++jsCnt==4){
1.230 misha 864: // transcode utf8 char to client charset (we can lost some chars here)
1.232 misha 865: charset->store_Char((XMLByte*&)dst, (XMLCh)escapedValue, '?');
1.229 misha 866: escapeState=EscapeRest;
867: }
868: } else {
869: // not full unicode value
870: escapeState=EscapeRest;
871: }
872: break;
873: }
874: }
875:
876: srcPos++;
877: }
878:
1.230 misha 879: *dst=0; // zero-termination
1.229 misha 880: return s;
881: }
1.24 paf 882:
1.268 misha 883: char *search_stop(char*& current, char cstop_at) {
884: // sanity check
885: if(!current)
886: return 0;
887:
888: // skip leading WS
889: while(*current==' ' || *current=='\t')
890: current++;
891: if(!*current)
892: return current=0;
893:
894: char *result=current;
895: if(char *pstop_at=strchr(current, cstop_at)) {
896: *pstop_at=0;
897: current=pstop_at+1;
898: } else
899: current=0;
900: return result;
901: }
902:
1.24 paf 903: #ifdef WIN32
1.126 paf 904: void back_slashes_to_slashes(char* s) {
1.24 paf 905: if(s)
906: for(; *s; s++)
907: if(*s=='\\')
1.126 paf 908: *s='/';
1.24 paf 909: }
910: #endif
1.41 paf 911:
1.232 misha 912: size_t strpos(const char *str, const char *substr) {
913: const char *p = strstr(str, substr);
914: return (p==0)?STRING_NOT_FOUND:p-str;
915: }
916:
1.326 moko 917: size_t remove_crlf(char* start, char* end) {
1.226 misha 918: char* from=start;
919: char* to=start;
920: bool skip=false;
921: while(from < end){
922: switch(*from){
923: case '\n':
924: case '\r':
925: case '\t':
926: case ' ':
927: if(!skip){
928: *to=' ';
929: to++;
930: skip=true;
931: }
932: break;
933: default:
934: if(from != to)
935: *to=*from;
936: to++;
937: skip=false;
1.69 parser 938: }
1.226 misha 939: from++;
940: }
941: return to-start;
1.91 paf 942: }
943:
1.279 moko 944: const char* hex_digits="0123456789ABCDEF";
945:
1.278 moko 946: const char* hex_string(unsigned char* bytes, size_t size, bool upcase) {
947: char *bytes_hex=new(PointerFreeGC) char [size*2/*byte->hh*/+1/*for zero-teminator*/];
948: unsigned char *src=bytes;
949: unsigned char *end=bytes+size;
950: char *dest=bytes_hex;
951:
1.279 moko 952: const char *hex=upcase? hex_digits : "0123456789abcdef";
1.278 moko 953:
954: for(; src<end; src++) {
955: *dest++=hex[*src/0x10];
956: *dest++=hex[*src%0x10];
957: }
958: *dest=0;
959:
960: return bytes_hex;
961: }
1.91 paf 962:
1.321 moko 963: ssize_t file_block_read(const int f, void* buffer, const size_t size){
964: ssize_t nCount = read(f, buffer, size);
1.221 misha 965: if (nCount < 0)
1.289 moko 966: throw Exception("file.read", 0, "read failed: %s (%d)", strerror(errno), errno);
1.221 misha 967: return nCount;
968: }
969:
1.278 moko 970: static unsigned long crc32Table[256];
971: static void InitCrc32Table()
972: {
973: if(crc32Table[1] == 0){
974: // This is the official polynomial used by CRC32 in PKZip.
975: // Often times the polynomial shown reversed as 0x04C11DB7.
976: static const unsigned long dwPolynomial = 0xEDB88320;
977:
978: for(int i = 0; i < 256; i++)
979: {
980: unsigned long dwCrc = i;
981: for(int j = 8; j > 0; j--)
982: {
983: if(dwCrc & 1)
984: dwCrc = (dwCrc >> 1) ^ dwPolynomial;
985: else
986: dwCrc >>= 1;
987: }
988: crc32Table[i] = dwCrc;
989: }
990: }
991: }
992:
993: inline void CalcCrc32(const unsigned char byte, unsigned long &crc32)
994: {
995: crc32 = ((crc32) >> 8) ^ crc32Table[(byte) ^ ((crc32) & 0x000000FF)];
996: }
997:
998:
1.297 moko 999: unsigned long pa_crc32(const char *in, size_t in_size){
1.218 misha 1000: unsigned long crc32=0xFFFFFFFF;
1.220 misha 1001:
1.240 misha 1002: InitCrc32Table();
1.239 misha 1003: for(size_t i = 0; i<in_size; i++)
1004: CalcCrc32(in[i], crc32);
1.220 misha 1005:
1.218 misha 1006: return ~crc32;
1007: }
1008:
1.289 moko 1009: static void file_crc32_file_action(struct stat& finfo, int f, const String&, void *context) {
1.218 misha 1010: unsigned long& crc32=*static_cast<unsigned long *>(context);
1011: if(finfo.st_size) {
1012: InitCrc32Table();
1.220 misha 1013: int nCount=0;
1.218 misha 1014: do {
1.221 misha 1015: unsigned char buffer[FILE_BUFFER_SIZE];
1016: nCount = file_block_read(f, buffer, sizeof(buffer));
1.220 misha 1017: for(int i = 0; i < nCount; i++) CalcCrc32(buffer[i], crc32);
1018: } while(nCount > 0);
1.218 misha 1019: }
1020: }
1021:
1.297 moko 1022: unsigned long pa_crc32(const String& file_spec){
1.278 moko 1023: unsigned long crc32=0xFFFFFFFF;
1024: file_read_action_under_lock(file_spec, "crc32", file_crc32_file_action, &crc32);
1025: return ~crc32;
1026: }
1027:
1028: // content-type: xxx; charset=WE-NEED-THIS
1029: // content-type: xxx; charset="WE-NEED-THIS"
1030: // content-type: xxx; charset="WE-NEED-THIS";
1031: Charset* detect_charset(const char* content_type){
1032: if(content_type){
1.291 moko 1033: char* CONTENT_TYPE=str_upper(content_type);
1.278 moko 1034:
1035: if(const char* begin=strstr(CONTENT_TYPE, "CHARSET=")){
1036: begin+=8; // skip "CHARSET="
1037: char* end=0;
1038: if(*begin && (*begin=='"' || *begin =='\'')){
1039: char quote=*begin;
1040: begin++;
1041: end=(char*)strchr(begin, quote);
1042: }
1043: if(!end)
1044: end=(char*)strchr(begin, ';');
1045:
1046: if(end)
1047: *end=0; // terminator
1048:
1.295 moko 1049: return *begin ? &pa_charsets.get_direct(begin) : 0;
1.278 moko 1050: }
1051: }
1052: return 0;
1053: }
1054:
1.301 moko 1055: const UTF16* pa_utf16_encode(const char* in, Charset& source_charset){
1.302 moko 1056: if(!in)
1057: return 0;
1.301 moko 1058:
1.302 moko 1059: String::C sIn(in,strlen(in));
1.301 moko 1060:
1.302 moko 1061: UTF16* utf16=(UTF16*)pa_malloc_atomic(sIn.length*2+2);
1062: UTF16* utf16_end=utf16;
1.301 moko 1063:
1.302 moko 1064: if(!source_charset.isUTF8())
1065: sIn=Charset::transcode(sIn, source_charset, pa_UTF8_charset);
1.301 moko 1066:
1.302 moko 1067: int status=pa_convertUTF8toUTF16((const UTF8**)&sIn.str, (const UTF8*)(sIn.str+sIn.length), &utf16_end, utf16+sIn.length, strictConversion);
1068: if(status != conversionOK)
1069: throw Exception("utf-16 encode", new String(in), "utf-16 conversion failed (%d)", status);
1.301 moko 1070:
1.302 moko 1071: *utf16_end=0;
1.301 moko 1072:
1.302 moko 1073: return utf16;
1.301 moko 1074: }
1075:
1076: const char* pa_utf16_decode(const UTF16* in, Charset& asked_charset){
1077: if(!in)
1078: return 0;
1079:
1080: const UTF16* utf16_start=in;
1081: const UTF16* utf16_end;
1082:
1083: for(utf16_end=in; *utf16_end; utf16_end++);
1084:
1085: char *result = (char *)pa_malloc_atomic((utf16_end-in)*6+1);
1086: char *result_end = result;
1087:
1088: int status=pa_convertUTF16toUTF8(&utf16_start, utf16_end, (UTF8**)&result_end, (UTF8*)(result+(utf16_end-in)*6), strictConversion);
1089:
1090: if(status != conversionOK)
1091: throw Exception("utf-16 decode", 0, "utf conversion failed (%d)", status);
1092:
1093: *result_end='\0';
1094:
1.302 moko 1095: if(asked_charset.isUTF8())
1096: return result;
1.301 moko 1097:
1.302 moko 1098: return Charset::transcode(result, pa_UTF8_charset, asked_charset).cstr();
1.301 moko 1099: }
1.278 moko 1100:
1.283 moko 1101: static bool is_latin(const char *in){
1102: for(; *in; in++){
1103: if ((unsigned char)(*in) > 0x7F)
1104: return false;
1105: }
1106: return true;
1107: }
1108:
1109: #define MAX_IDNA_LENGTH 256
1110:
1.301 moko 1111: const char *pa_idna_encode(const char *in, Charset& source_charset){
1.283 moko 1112: if(!in || is_latin(in))
1113: return in;
1114:
1115: uint32_t utf32[MAX_IDNA_LENGTH];
1116: uint32_t *utf32_end=utf32;
1117:
1118: String::C sIn(in,strlen(in));
1119:
1120: if(!source_charset.isUTF8())
1.295 moko 1121: sIn=Charset::transcode(sIn, source_charset, pa_UTF8_charset);
1.283 moko 1122:
1123: int status=pa_convertUTF8toUTF32((const UTF8**)&sIn.str, (const UTF8*)(sIn.str+sIn.length), &utf32_end, utf32+MAX_IDNA_LENGTH-1, strictConversion);
1124: if(status != conversionOK)
1125: throw Exception("idna encode", new String(in), "utf conversion failed (%d)", status);
1126:
1127: *utf32_end=0;
1128:
1129: char *result = (char *)pa_malloc(MAX_IDNA_LENGTH);
1130: status=pa_idna_to_ascii_4z(utf32, result, MAX_IDNA_LENGTH, 0);
1131: if(status != IDNA_SUCCESS)
1132: throw Exception("idna encode", new String(in), "encode failed: %s", pa_idna_strerror(status));
1133:
1134: return result;
1135: }
1136:
1137: const char *pa_idna_decode(const char *in, Charset &asked_charset){
1138: if(!in || !(*in))
1139: return in;
1140:
1141: uint32_t utf32[MAX_IDNA_LENGTH];
1142: const uint32_t *utf32_start=utf32;
1143: uint32_t *utf32_end;
1144:
1145: int status=pa_idna_to_unicode_4z(in, utf32, MAX_IDNA_LENGTH, 0);
1146: if(status != IDNA_SUCCESS)
1147: throw Exception("idna decode", new String(in), "decode failed: %s", pa_idna_strerror(status));
1148:
1149: for(utf32_end=utf32; *utf32_end; utf32_end++);
1150:
1151: char *result = (char *)pa_malloc(MAX_IDNA_LENGTH);
1152: char *result_end = result;
1153:
1154: status=pa_convertUTF32toUTF8(&utf32_start, utf32_end, (UTF8**)&result_end, (UTF8*)(result+MAX_IDNA_LENGTH-1), strictConversion);
1155:
1156: if(status != conversionOK)
1157: throw Exception("idna decode", new String(in), "utf conversion failed (%d)", status);
1158:
1159: *result_end='\0';
1160:
1161: if(!asked_charset.isUTF8())
1.295 moko 1162: result = (char *)Charset::transcode(result, pa_UTF8_charset, asked_charset).cstr();
1.283 moko 1163:
1164: return result;
1165: }
1.292 moko 1166: /// must be last in this file
1167: #undef vsnprintf
1168: int pa_vsnprintf(char* b, size_t s, const char* f, va_list l) {
1169: if(!s)
1170: return 0;
1171:
1172: int r;
1173: // note: on win32 & maybe somewhere else
1174: // vsnprintf do not writes terminating 0 in 'buffer full' case, reducing
1175: // http://stackoverflow.com/questions/2915672/snprintf-and-visual-studio-2010
1176: --s;
1177:
1178: // clients do not check for negative 's', feature: ignore such prints
1179: if((ssize_t)s<0)
1180: return 0;
1181:
1182: #ifdef _MSC_VER
1183: // win32: if the number of bytes to write exceeds buffer, then count bytes are written and -1 is returned
1184: r=_vsnprintf(b, s, f, l);
1185: if(r<0)
1186: r=s;
1187: #else
1188: r=vsnprintf(b, s, f, l);
1189: /*
1190: solaris: man vsnprintf
1191:
1192: The snprintf() function returns the number of characters
1193: formatted, that is, the number of characters that would have
1194: been written to the buffer if it were large enough. If the
1195: value of n is 0 on a call to snprintf(), an unspecified
1196: value less than 1 is returned.
1197: */
1198:
1199: if(r<0)
1200: r=0;
1201: else if((size_t)r>s)
1202: r=s;
1203: #endif
1204: b[r]=0;
1205: return r;
1206: }
1207:
1208: int pa_snprintf(char* b, size_t s, const char* f, ...) {
1209: va_list l;
1210: va_start(l, f);
1211: int r=pa_vsnprintf(b, s, f, l);
1212: va_end(l);
1213: return r;
1214: }
1215:
E-mail: