1 const char miscutil_rcs[] = "$Id: miscutil.c,v 1.37.2.1 2002/09/25 12:58:51 oes Exp $";
2 /*********************************************************************
4 * File : $Source: /cvsroot/ijbswa/current/Attic/miscutil.c,v $
6 * Purpose : zalloc, hash_string, safe_strerror, strcmpic,
7 * strncmpic, chomp, and MinGW32 strdup
9 * These are each too small to deserve their own file
10 * but don't really fit in any other file.
12 * Copyright : Written by and Copyright (C) 2001 the SourceForge
13 * Privoxy team. http://www.privoxy.org/
15 * Based on the Internet Junkbuster originally written
16 * by and Copyright (C) 1997 Anonymous Coders and
17 * Junkbusters Corporation. http://www.junkbusters.com
19 * This program is free software; you can redistribute it
20 * and/or modify it under the terms of the GNU General
21 * Public License as published by the Free Software
22 * Foundation; either version 2 of the License, or (at
23 * your option) any later version.
25 * This program is distributed in the hope that it will
26 * be useful, but WITHOUT ANY WARRANTY; without even the
27 * implied warranty of MERCHANTABILITY or FITNESS FOR A
28 * PARTICULAR PURPOSE. See the GNU General Public
29 * License for more details.
31 * The GNU General Public License should be included with
32 * this file. If not, you can view it at
33 * http://www.gnu.org/copyleft/gpl.html
34 * or write to the Free Software Foundation, Inc., 59
35 * Temple Place - Suite 330, Boston, MA 02111-1307, USA.
38 * $Log: miscutil.c,v $
39 * Revision 1.37.2.1 2002/09/25 12:58:51 oes
40 * Made strcmpic and strncmpic safe against NULL arguments
41 * (which are now treated as empty strings).
43 * Revision 1.37 2002/04/26 18:29:43 jongfoster
44 * Fixing this Visual C++ warning:
45 * miscutil.c(710) : warning C4090: '=' : different 'const' qualifiers
47 * Revision 1.36 2002/04/26 12:55:38 oes
48 * New function string_toupper
50 * Revision 1.35 2002/03/26 22:29:55 swa
51 * we have a new homepage!
53 * Revision 1.34 2002/03/24 13:25:43 swa
54 * name change related issues
56 * Revision 1.33 2002/03/07 03:46:53 oes
57 * Fixed compiler warnings etc
59 * Revision 1.32 2002/03/06 23:02:57 jongfoster
62 * Revision 1.31 2002/03/05 04:52:42 oes
63 * Deleted non-errlog debugging code
65 * Revision 1.30 2002/03/04 18:27:42 oes
66 * - Deleted deletePidFile
67 * - Made write_pid_file use the --pidfile option value
68 * (or no PID file, if the option was absent)
69 * - Played styleguide police
71 * Revision 1.29 2002/03/04 02:08:02 david__schmidt
72 * Enable web editing of actions file on OS/2 (it had been broken all this time!)
74 * Revision 1.28 2002/03/03 09:18:03 joergs
75 * Made jumbjuster work on AmigaOS again.
77 * Revision 1.27 2002/01/21 00:52:32 jongfoster
78 * Adding string_join()
80 * Revision 1.26 2001/12/30 14:07:32 steudten
81 * - Add signal handling (unix)
82 * - Add SIGHUP handler (unix)
83 * - Add creation of pidfile (unix)
84 * - Add action 'top' in rc file (RH)
85 * - Add entry 'SIGNALS' to manpage
86 * - Add exit message to logfile (unix)
88 * Revision 1.25 2001/11/13 00:16:38 jongfoster
89 * Replacing references to malloc.h with the standard stdlib.h
90 * (See ANSI or K&R 2nd Ed)
92 * Revision 1.24 2001/11/05 21:41:43 steudten
93 * Add changes to be a real daemon just for unix os.
94 * (change cwd to /, detach from controlling tty, set
95 * process group and session leader to the own process.
97 * Add some fatal-error log message for failed malloc().
98 * Add '-d' if compiled with 'configure --with-debug' to
99 * enable debug output.
101 * Revision 1.23 2001/10/29 03:48:10 david__schmidt
102 * OS/2 native needed a snprintf() routine. Added one to miscutil, brackedted
103 * by and __OS2__ ifdef.
105 * Revision 1.22 2001/10/26 17:39:38 oes
106 * Moved ijb_isspace and ijb_tolower to project.h
108 * Revision 1.21 2001/10/23 21:27:50 jongfoster
109 * Standardising error codes in string_append
110 * make_path() no longer adds '\\' if the dir already ends in '\\' (this
111 * is just copying a UNIX-specific fix to the Windows-specific part)
113 * Revision 1.20 2001/10/22 15:33:56 david__schmidt
114 * Special-cased OS/2 out of the Netscape-abort-on-404-in-js problem in
115 * filters.c. Added a FIXME in front of the offending code. I'll gladly
116 * put in a better/more robust fix for all parties if one is presented...
117 * It seems that just returning 200 instead of 404 would pretty much fix
118 * it for everyone, but I don't know all the history of the problem.
120 * Revision 1.19 2001/10/14 22:02:57 jongfoster
121 * New function string_append() which is like strsav(), but running
122 * out of memory isn't automatically FATAL.
124 * Revision 1.18 2001/09/20 13:33:43 steudten
126 * change long to int as return value in hash_string(). Remember the wraparound
127 * for int = long = sizeof(4) - thats maybe not what we want.
129 * Revision 1.17 2001/09/13 20:51:29 jongfoster
130 * Fixing potential problems with characters >=128 in simplematch()
131 * This was also a compiler warning.
133 * Revision 1.16 2001/09/10 10:56:59 oes
134 * Silenced compiler warnings
136 * Revision 1.15 2001/07/13 14:02:24 oes
137 * Removed vim-settings
139 * Revision 1.14 2001/06/29 21:45:41 oes
140 * Indentation, CRLF->LF, Tab-> Space
142 * Revision 1.13 2001/06/29 13:32:14 oes
143 * Removed logentry from cancelled commit
145 * Revision 1.12 2001/06/09 10:55:28 jongfoster
146 * Changing BUFSIZ ==> BUFFER_SIZE
148 * Revision 1.11 2001/06/07 23:09:19 jongfoster
149 * Cosmetic indentation changes.
151 * Revision 1.10 2001/06/07 14:51:38 joergs
152 * make_path() no longer adds '/' if the dir already ends in '/'.
154 * Revision 1.9 2001/06/07 14:43:17 swa
155 * slight mistake in make_path, unix path style is /.
157 * Revision 1.8 2001/06/05 22:32:01 jongfoster
158 * New function make_path() to splice directory and file names together.
160 * Revision 1.7 2001/06/03 19:12:30 oes
161 * introduced bindup()
163 * Revision 1.6 2001/06/01 18:14:49 jongfoster
164 * Changing the calls to strerr() to check HAVE_STRERR (which is defined
165 * in config.h if appropriate) rather than the NO_STRERR macro.
167 * Revision 1.5 2001/06/01 10:31:51 oes
168 * Added character class matching to trivimatch; renamed to simplematch
170 * Revision 1.4 2001/05/31 17:32:31 oes
172 * - Enhanced domain part globbing with infix and prefix asterisk
173 * matching and optional unanchored operation
175 * Revision 1.3 2001/05/29 23:10:09 oes
178 * - Introduced chomp()
179 * - Moved strsav() from showargs to miscutil
181 * Revision 1.2 2001/05/29 09:50:24 jongfoster
182 * Unified blocklist/imagelist/permissionslist.
183 * File format is still under discussion, but the internal changes
186 * Also modified interceptor behaviour:
187 * - We now intercept all URLs beginning with one of the following
188 * prefixes (and *only* these prefixes):
190 * * http://ijbswa.sf.net/config/
191 * * http://ijbswa.sourceforge.net/config/
192 * - New interceptors "home page" - go to http://i.j.b/ to see it.
193 * - Internal changes so that intercepted and fast redirect pages
194 * are not replaced with an image.
195 * - Interceptors now have the option to send a binary page direct
196 * to the client. (i.e. ijb-send-banner uses this)
197 * - Implemented show-url-info interceptor. (Which is why I needed
198 * the above interceptors changes - a typical URL is
199 * "http://i.j.b/show-url-info?url=www.somesite.com/banner.gif".
200 * The previous mechanism would not have intercepted that, and
201 * if it had been intercepted then it then it would have replaced
204 * Revision 1.1.1.1 2001/05/15 13:59:00 oes
205 * Initial import of version 2.9.3 source tree
208 *********************************************************************/
214 #include <sys/types.h>
216 #if !defined(_WIN32) && !defined(__OS2__)
218 #endif /* #if !defined(_WIN32) && !defined(__OS2__) */
224 #include "miscutil.h"
228 const char miscutil_h_rcs[] = MISCUTIL_H_VERSION;
230 /*********************************************************************
234 * Description : Malloc some memory and set it to '\0'.
235 * The way calloc() ought to be -acjc
238 * 1 : size = Size of memory chunk to return.
240 * Returns : Pointer to newly malloc'd memory chunk.
242 *********************************************************************/
243 void *zalloc(size_t size)
247 if ((ret = (void *)malloc(size)) != NULL)
249 memset(ret, 0, size);
258 /*********************************************************************
260 * Function : write_pid_file
262 * Description : Writes a pid file with the pid of the main process
268 *********************************************************************/
269 void write_pid_file(void)
274 * If no --pidfile option was given,
275 * we can live without one.
277 if (pidfile == NULL) return;
279 if ((fp = fopen(pidfile, "w")) == NULL)
281 log_error(LOG_LEVEL_INFO, "can't open pidfile '%s': %E", pidfile);
285 fprintf(fp, "%u\n", (unsigned int) getpid());
291 #endif /* def unix */
294 /*********************************************************************
296 * Function : hash_string
298 * Description : Take a string and compute a (hopefuly) unique numeric
299 * integer value. This has several uses, but being able
300 * to "switch" a string the one of my favorites.
303 * 1 : s : string to be hashed.
305 * Returns : an unsigned long variable with the hashed value.
307 *********************************************************************/
308 unsigned int hash_string( const char* s )
323 /*********************************************************************
327 * Description : For some reason (which is beyond me), gcc and WIN32
328 * don't like strdup. When a "free" is executed on a
329 * strdup'd ptr, it can at times freez up! So I just
330 * replaced it and problem was solved.
333 * 1 : s = string to duplicate
335 * Returns : Pointer to newly malloc'ed copy of the string.
337 *********************************************************************/
338 char *strdup( const char *s )
340 char * result = (char *)malloc( strlen(s)+1 );
350 #endif /* def __MINGW32__ */
354 /*********************************************************************
356 * Function : safe_strerror
358 * Description : Variant of the library routine strerror() which will
359 * work on systems without the library routine, and
360 * which should never return NULL.
363 * 1 : err = the `errno' of the last operation.
365 * Returns : An "English" string of the last `errno'. Allocated
366 * with strdup(), so caller frees. May be NULL if the
367 * system is out of memory.
369 *********************************************************************/
370 char *safe_strerror(int err)
373 char buf[BUFFER_SIZE];
378 #endif /* HAVE_STRERROR */
382 sprintf(buf, "(errno = %d)", err);
391 /*********************************************************************
393 * Function : strcmpic
395 * Description : Case insensitive string comparison
398 * 1 : s1 = string 1 to compare
399 * 2 : s2 = string 2 to compare
401 * Returns : 0 if s1==s2, Negative if s1<s2, Positive if s1>s2
403 *********************************************************************/
404 int strcmpic(const char *s1, const char *s2)
411 if ( ( *s1 != *s2 ) && ( ijb_tolower(*s1) != ijb_tolower(*s2) ) )
417 return(ijb_tolower(*s1) - ijb_tolower(*s2));
422 /*********************************************************************
424 * Function : strncmpic
426 * Description : Case insensitive string comparison (upto n characters)
429 * 1 : s1 = string 1 to compare
430 * 2 : s2 = string 2 to compare
431 * 3 : n = maximum characters to compare
433 * Returns : 0 if s1==s2, Negative if s1<s2, Positive if s1>s2
435 *********************************************************************/
436 int strncmpic(const char *s1, const char *s2, size_t n)
438 if (n <= 0) return(0);
444 if ( ( *s1 != *s2 ) && ( ijb_tolower(*s1) != ijb_tolower(*s2) ) )
453 return(ijb_tolower(*s1) - ijb_tolower(*s2));
458 /*********************************************************************
462 * Description : In-situ-eliminate all leading and trailing whitespace
466 * 1 : s : string to be chomped.
468 * Returns : chomped string
470 *********************************************************************/
471 char *chomp(char *string)
476 * strip trailing whitespace
478 p = string + strlen(string);
479 while (p > string && ijb_isspace(*(p-1)))
486 * find end of leading whitespace
489 while (*q && ijb_isspace(*q))
495 * if there was any, move the rest forwards
510 /*********************************************************************
514 * Description : Reallocate "old" and append text to it. This makes
515 * it easier to append to malloc'd strings.
516 * Running out of memory is a FATAL error.
519 * 1 : old = Old text that is to be extended. Will be
520 * free()d by this routine. May be NULL.
521 * 2 : text_to_append = Text to be appended to old.
524 * Returns : Pointer to newly malloc'ed appended string.
525 * If there is no text to append, return old. Caller
528 *********************************************************************/
529 char *strsav(char *old, const char *text_to_append)
531 size_t old_len, new_len = 0;
534 if ((text_to_append == NULL) || (*text_to_append == '\0'))
541 if ((p = strdup(text_to_append)) == NULL)
543 log_error(LOG_LEVEL_FATAL, "strdup() failed!");
544 /* Never get here - LOG_LEVEL_FATAL causes program exit */
549 old_len = strlen(old);
550 new_len = old_len + strlen(text_to_append) + 1;
552 if ((p = realloc(old, new_len)) == NULL)
554 log_error(LOG_LEVEL_FATAL, "realloc(%d) bytes failed!", new_len);
555 /* Never get here - LOG_LEVEL_FATAL causes program exit */
558 strcpy(p + old_len, text_to_append);
563 /*********************************************************************
565 * Function : string_append
567 * Description : Reallocate target_string and append text to it.
568 * This makes it easier to append to malloc'd strings.
569 * This is similar to the (removed) strsav(), but
570 * running out of memory isn't catastrophic.
574 * The following style provides sufficient error
575 * checking for this routine, with minimal clutter
576 * in the source code. It is recommended if you
577 * have many calls to this function:
579 * char * s = strdup(...); // don't check for error
580 * string_append(&s, ...); // don't check for error
581 * string_append(&s, ...); // don't check for error
582 * string_append(&s, ...); // don't check for error
583 * if (NULL == s) { ... handle error ... }
587 * char * s = strdup(...); // don't check for error
588 * string_append(&s, ...); // don't check for error
589 * string_append(&s, ...); // don't check for error
590 * if (string_append(&s, ...)) {... handle error ...}
593 * 1 : target_string = Pointer to old text that is to be
594 * extended. *target_string will be free()d by this
595 * routine. target_string must be non-NULL.
596 * If *target_string is NULL, this routine will
597 * do nothing and return with an error - this allows
598 * you to make many calls to this routine and only
599 * check for errors after the last one.
600 * 2 : text_to_append = Text to be appended to old.
603 * Returns : JB_ERR_OK on success, and sets *target_string
604 * to newly malloc'ed appended string. Caller
605 * must free(*target_string).
606 * JB_ERR_MEMORY on out-of-memory. (And free()s
607 * *target_string and sets it to NULL).
608 * JB_ERR_MEMORY if *target_string is NULL.
610 *********************************************************************/
611 jb_err string_append(char **target_string, const char *text_to_append)
616 assert(target_string);
617 assert(text_to_append);
619 if (*target_string == NULL)
621 return JB_ERR_MEMORY;
624 if (*text_to_append == '\0')
629 old_len = strlen(*target_string);
631 if (NULL == (new_string = realloc(*target_string,
632 strlen(text_to_append) + old_len + 1)))
634 free(*target_string);
636 *target_string = NULL;
637 return JB_ERR_MEMORY;
640 strcpy(new_string + old_len, text_to_append);
642 *target_string = new_string;
647 /*********************************************************************
649 * Function : string_join
651 * Description : Join two strings together. Frees BOTH the original
652 * strings. If either or both input strings are NULL,
653 * fails as if it had run out of memory.
655 * For comparison, string_append requires that the
656 * second string is non-NULL, and doesn't free it.
658 * Rationale: Too often, we want to do
659 * string_append(s, html_encode(s2)). That assert()s
660 * if s2 is NULL or if html_encode() runs out of memory.
661 * It also leaks memory. Proper checking is cumbersome.
662 * The solution: string_join(s, html_encode(s2)) is safe,
663 * and will free the memory allocated by html_encode().
666 * 1 : target_string = Pointer to old text that is to be
667 * extended. *target_string will be free()d by this
668 * routine. target_string must be non-NULL.
669 * 2 : text_to_append = Text to be appended to old.
671 * Returns : JB_ERR_OK on success, and sets *target_string
672 * to newly malloc'ed appended string. Caller
673 * must free(*target_string).
674 * JB_ERR_MEMORY on out-of-memory, or if
675 * *target_string or text_to_append is NULL. (In
676 * this case, frees *target_string and text_to_append,
677 * sets *target_string to NULL).
679 *********************************************************************/
680 jb_err string_join(char **target_string, char *text_to_append)
684 assert(target_string);
686 if (text_to_append == NULL)
688 freez(*target_string);
689 return JB_ERR_MEMORY;
692 err = string_append(target_string, text_to_append);
694 free(text_to_append);
700 /*********************************************************************
702 * Function : string_toupper
704 * Description : Produce a copy of string with all convertible
705 * characters converted to uppercase.
708 * 1 : string = string to convert
710 * Returns : Uppercase copy of string if possible,
711 * NULL on out-of-memory or if string was NULL.
713 *********************************************************************/
714 char *string_toupper(const char *string)
719 if (!string || ((result = (char *) zalloc(strlen(string) + 1)) == NULL))
729 *p++ = toupper(*q++);
737 /*********************************************************************
739 * Function : simplematch
741 * Description : String matching, with a (greedy) '*' wildcard that
742 * stands for zero or more arbitrary characters and
743 * character classes in [], which take both enumerations
747 * 1 : pattern = pattern for matching
748 * 2 : text = text to be matched
750 * Returns : 0 if match, else nonzero
752 *********************************************************************/
753 int simplematch(char *pattern, char *text)
755 unsigned char *pat = (unsigned char *) pattern;
756 unsigned char *txt = (unsigned char *) text;
757 unsigned char *fallback = pat;
760 unsigned char lastchar = 'a';
762 unsigned char charmap[32];
767 /* EOF pattern but !EOF text? */
773 /* '*' in the pattern? */
777 /* The pattern ends afterwards? Speed up the return. */
783 /* Else, set wildcard mode and remember position after '*' */
788 /* Character range specification? */
791 memset(charmap, '\0', sizeof(charmap));
793 while (*++pat != ']')
799 else if (*pat == '-')
801 if ((*++pat == ']') || *pat == '\0')
805 for(i = lastchar; i <= *pat; i++)
807 charmap[i / 8] |= (1 << (i % 8));
812 charmap[*pat / 8] |= (1 << (*pat % 8));
816 } /* -END- if Character range specification */
820 * Char match, or char range match?
823 || ((*pat == ']') && (charmap[*txt / 8] & (1 << (*txt % 8)))) )
833 * No match && no wildcard: No luck
837 else if (pat != fallback)
840 * Wildcard mode && nonmatch beyond fallback: Rewind pattern
848 /* Cut off extra '*'s */
849 if(*pat == '*') pat++;
851 /* If this is the pattern's end, fine! */
857 /*********************************************************************
861 * Description : Duplicate the first n characters of a string that may
862 * contain '\0' characters.
865 * 1 : string = string to be duplicated
866 * 2 : len = number of bytes to duplicate
868 * Returns : pointer to copy, or NULL if failiure
870 *********************************************************************/
871 char *bindup(const char *string, size_t len)
875 if (NULL == (duplicate = (char *)malloc(len)))
881 memcpy(duplicate, string, len);
889 /*********************************************************************
891 * Function : make_path
893 * Description : Takes a directory name and a file name, returns
894 * the complete path. Handles windows/unix differences.
895 * If the file name is already an absolute path, or if
896 * the directory name is NULL or empty, it returns
900 * 1 : dir: Name of directory or NULL for none.
901 * 2 : file: Name of file. Should not be NULL or empty.
903 * Returns : "dir/file" (Or on windows, "dir\file").
904 * It allocates the string on the heap. Caller frees.
905 * Returns NULL in error (i.e. NULL file or out of
908 *********************************************************************/
909 char * make_path(const char * dir, const char * file)
920 strncpy(path,dir+2,512);
924 strncpy(path,dir+1,512);
929 strncpy(path,dir,512);
935 if(AddPart(path,file,512))
941 #else /* ndef AMIGA */
943 if ((file == NULL) || (*file == '\0'))
945 return NULL; /* Error */
948 if ((dir == NULL) || (*dir == '\0') /* No directory specified */
949 #if defined(_WIN32) || defined(__OS2__)
950 || (*file == '\\') || (file[1] == ':') /* Absolute path (DOS) */
951 #else /* ifndef _WIN32 || __OS2__ */
952 || (*file == '/') /* Absolute path (U*ix) */
953 #endif /* ifndef _WIN32 || __OS2__ */
963 if ( *dir != '/' && basedir && *basedir )
965 path = malloc( strlen( basedir ) + strlen(dir) + strlen(file) + 3);
966 if (!path ) log_error(LOG_LEVEL_FATAL, "malloc failed!");
967 strcpy(path, basedir);
973 path = malloc(strlen(dir) + strlen(file) + 2);
974 if (!path ) log_error(LOG_LEVEL_FATAL, "malloc failed!");
979 path = malloc(strlen(dir) + strlen(file) + 2);
980 if (!path ) log_error(LOG_LEVEL_FATAL, "malloc failed!");
983 #endif /* defined unix */
985 #if defined(_WIN32) || defined(__OS2__)
986 if(path[strlen(path)-1] != '\\')
990 #else /* ifndef _WIN32 || __OS2__ */
991 if(path[strlen(path)-1] != '/')
995 #endif /* ifndef _WIN32 || __OS2__ */
1000 #endif /* ndef AMIGA */
1005 * What follows is a portable snprintf routine, written by Mark Martinec.
1006 * See: http://www.ijs.si/software/snprintf/
1007 * Anyone who needs it can add a define for themselves... so far, only
1008 * OS/2 (native) lacks snprintf.
1011 - a portable implementation of snprintf,
1012 including vsnprintf.c, asnprintf, vasnprintf, asprintf, vasprintf
1014 snprintf is a routine to convert numeric and string arguments to
1015 formatted strings. It is similar to sprintf(3) provided in a system's
1016 C library, yet it requires an additional argument - the buffer size -
1017 and it guarantees never to store anything beyond the given buffer,
1018 regardless of the format or arguments to be formatted. Some newer
1019 operating systems do provide snprintf in their C library, but many do
1020 not or do provide an inadequate (slow or idiosyncratic) version, which
1021 calls for a portable implementation of this routine.
1025 Mark Martinec <mark.martinec@ijs.si>, April 1999, June 2000
1026 Copyright © 1999, Mark Martinec
1032 #define PORTABLE_SNPRINTF_VERSION_MAJOR 2
1033 #define PORTABLE_SNPRINTF_VERSION_MINOR 2
1035 #if defined(NEED_ASPRINTF) || defined(NEED_ASNPRINTF) || defined(NEED_VASPRINTF) || defined(NEED_VASNPRINTF)
1036 # if defined(NEED_SNPRINTF_ONLY)
1037 # undef NEED_SNPRINTF_ONLY
1039 # if !defined(PREFER_PORTABLE_SNPRINTF)
1040 # define PREFER_PORTABLE_SNPRINTF
1044 #if defined(SOLARIS_BUG_COMPATIBLE) && !defined(SOLARIS_COMPATIBLE)
1045 #define SOLARIS_COMPATIBLE
1048 #if defined(HPUX_BUG_COMPATIBLE) && !defined(HPUX_COMPATIBLE)
1049 #define HPUX_COMPATIBLE
1052 #if defined(DIGITAL_UNIX_BUG_COMPATIBLE) && !defined(DIGITAL_UNIX_COMPATIBLE)
1053 #define DIGITAL_UNIX_COMPATIBLE
1056 #if defined(PERL_BUG_COMPATIBLE) && !defined(PERL_COMPATIBLE)
1057 #define PERL_COMPATIBLE
1060 #if defined(LINUX_BUG_COMPATIBLE) && !defined(LINUX_COMPATIBLE)
1061 #define LINUX_COMPATIBLE
1064 #include <sys/types.h>
1075 #define isdigit(c) ((c) >= '0' && (c) <= '9')
1077 /* For copying strings longer or equal to 'breakeven_point'
1078 * it is more efficient to call memcpy() than to do it inline.
1079 * The value depends mostly on the processor architecture,
1080 * but also on the compiler and its optimization capabilities.
1081 * The value is not critical, some small value greater than zero
1082 * will be just fine if you don't care to squeeze every drop
1083 * of performance out of the code.
1085 * Small values favor memcpy, large values favor inline code.
1087 #if defined(__alpha__) || defined(__alpha)
1088 # define breakeven_point 2 /* AXP (DEC Alpha) - gcc or cc or egcs */
1090 #if defined(__i386__) || defined(__i386)
1091 # define breakeven_point 12 /* Intel Pentium/Linux - gcc 2.96 */
1094 # define breakeven_point 10 /* HP-PA - gcc */
1096 #if defined(__sparc__) || defined(__sparc)
1097 # define breakeven_point 33 /* Sun Sparc 5 - gcc 2.8.1 */
1100 /* some other values of possible interest: */
1101 /* #define breakeven_point 8 */ /* VAX 4000 - vaxc */
1102 /* #define breakeven_point 19 */ /* VAX 4000 - gcc 2.7.0 */
1104 #ifndef breakeven_point
1105 # define breakeven_point 6 /* some reasonable one-size-fits-all value */
1108 #define fast_memcpy(d,s,n) \
1109 { register size_t nn = (size_t)(n); \
1110 if (nn >= breakeven_point) memcpy((d), (s), nn); \
1111 else if (nn > 0) { /* proc call overhead is worth only for large strings*/\
1112 register char *dd; register const char *ss; \
1113 for (ss=(s), dd=(d); nn>0; nn--) *dd++ = *ss++; } }
1115 #define fast_memset(d,c,n) \
1116 { register size_t nn = (size_t)(n); \
1117 if (nn >= breakeven_point) memset((d), (int)(c), nn); \
1118 else if (nn > 0) { /* proc call overhead is worth only for large strings*/\
1119 register char *dd; register const int cc=(int)(c); \
1120 for (dd=(d); nn>0; nn--) *dd++ = cc; } }
1124 #if defined(NEED_ASPRINTF)
1125 int asprintf (char **ptr, const char *fmt, /*args*/ ...);
1127 #if defined(NEED_VASPRINTF)
1128 int vasprintf (char **ptr, const char *fmt, va_list ap);
1130 #if defined(NEED_ASNPRINTF)
1131 int asnprintf (char **ptr, size_t str_m, const char *fmt, /*args*/ ...);
1133 #if defined(NEED_VASNPRINTF)
1134 int vasnprintf (char **ptr, size_t str_m, const char *fmt, va_list ap);
1137 #if defined(HAVE_SNPRINTF)
1138 /* declare our portable snprintf routine under name portable_snprintf */
1139 /* declare our portable vsnprintf routine under name portable_vsnprintf */
1141 /* declare our portable routines under names snprintf and vsnprintf */
1142 #define portable_snprintf snprintf
1143 #if !defined(NEED_SNPRINTF_ONLY)
1144 #define portable_vsnprintf vsnprintf
1148 #if !defined(HAVE_SNPRINTF) || defined(PREFER_PORTABLE_SNPRINTF)
1149 int portable_snprintf(char *str, size_t str_m, const char *fmt, /*args*/ ...);
1150 #if !defined(NEED_SNPRINTF_ONLY)
1151 int portable_vsnprintf(char *str, size_t str_m, const char *fmt, va_list ap);
1157 static char credits[] = "\n\
1158 @(#)snprintf.c, v2.2: Mark Martinec, <mark.martinec@ijs.si>\n\
1159 @(#)snprintf.c, v2.2: Copyright 1999, Mark Martinec. Frontier Artistic License applies.\n\
1160 @(#)snprintf.c, v2.2: http://www.ijs.si/software/snprintf/\n";
1162 #if defined(NEED_ASPRINTF)
1163 int asprintf(char **ptr, const char *fmt, /*args*/ ...) {
1169 va_start(ap, fmt); /* measure the required size */
1170 str_l = portable_vsnprintf(NULL, (size_t)0, fmt, ap);
1172 assert(str_l >= 0); /* possible integer overflow if str_m > INT_MAX */
1173 *ptr = (char *) malloc(str_m = (size_t)str_l + 1);
1174 if (*ptr == NULL) { errno = ENOMEM; str_l = -1; }
1178 str_l2 = portable_vsnprintf(*ptr, str_m, fmt, ap);
1180 assert(str_l2 == str_l);
1186 #if defined(NEED_VASPRINTF)
1187 int vasprintf(char **ptr, const char *fmt, va_list ap) {
1193 va_copy(ap2, ap); /* don't consume the original ap, we'll need it again */
1194 str_l = portable_vsnprintf(NULL, (size_t)0, fmt, ap2);/*get required size*/
1197 assert(str_l >= 0); /* possible integer overflow if str_m > INT_MAX */
1198 *ptr = (char *) malloc(str_m = (size_t)str_l + 1);
1199 if (*ptr == NULL) { errno = ENOMEM; str_l = -1; }
1201 int str_l2 = portable_vsnprintf(*ptr, str_m, fmt, ap);
1202 assert(str_l2 == str_l);
1208 #if defined(NEED_ASNPRINTF)
1209 int asnprintf (char **ptr, size_t str_m, const char *fmt, /*args*/ ...) {
1214 va_start(ap, fmt); /* measure the required size */
1215 str_l = portable_vsnprintf(NULL, (size_t)0, fmt, ap);
1217 assert(str_l >= 0); /* possible integer overflow if str_m > INT_MAX */
1218 if ((size_t)str_l + 1 < str_m) str_m = (size_t)str_l + 1; /* truncate */
1219 /* if str_m is 0, no buffer is allocated, just set *ptr to NULL */
1220 if (str_m == 0) { /* not interested in resulting string, just return size */
1222 *ptr = (char *) malloc(str_m);
1223 if (*ptr == NULL) { errno = ENOMEM; str_l = -1; }
1227 str_l2 = portable_vsnprintf(*ptr, str_m, fmt, ap);
1229 assert(str_l2 == str_l);
1236 #if defined(NEED_VASNPRINTF)
1237 int vasnprintf (char **ptr, size_t str_m, const char *fmt, va_list ap) {
1242 va_copy(ap2, ap); /* don't consume the original ap, we'll need it again */
1243 str_l = portable_vsnprintf(NULL, (size_t)0, fmt, ap2);/*get required size*/
1246 assert(str_l >= 0); /* possible integer overflow if str_m > INT_MAX */
1247 if ((size_t)str_l + 1 < str_m) str_m = (size_t)str_l + 1; /* truncate */
1248 /* if str_m is 0, no buffer is allocated, just set *ptr to NULL */
1249 if (str_m == 0) { /* not interested in resulting string, just return size */
1251 *ptr = (char *) malloc(str_m);
1252 if (*ptr == NULL) { errno = ENOMEM; str_l = -1; }
1254 int str_l2 = portable_vsnprintf(*ptr, str_m, fmt, ap);
1255 assert(str_l2 == str_l);
1263 * If the system does have snprintf and the portable routine is not
1264 * specifically required, this module produces no code for snprintf/vsnprintf.
1266 #if !defined(HAVE_SNPRINTF) || defined(PREFER_PORTABLE_SNPRINTF)
1268 #if !defined(NEED_SNPRINTF_ONLY)
1269 int portable_snprintf(char *str, size_t str_m, const char *fmt, /*args*/ ...) {
1274 str_l = portable_vsnprintf(str, str_m, fmt, ap);
1280 #if defined(NEED_SNPRINTF_ONLY)
1281 int portable_snprintf(char *str, size_t str_m, const char *fmt, /*args*/ ...) {
1283 int portable_vsnprintf(char *str, size_t str_m, const char *fmt, va_list ap) {
1286 #if defined(NEED_SNPRINTF_ONLY)
1290 const char *p = fmt;
1292 /* In contrast with POSIX, the ISO C99 now says
1293 * that str can be NULL and str_m can be 0.
1294 * This is more useful than the old: if (str_m < 1) return -1; */
1296 #if defined(NEED_SNPRINTF_ONLY)
1302 /* if (str_l < str_m) str[str_l++] = *p++; -- this would be sufficient */
1303 /* but the following code achieves better performance for cases
1304 * where format string is long and contains few conversions */
1305 const char *q = strchr(p+1,'%');
1306 size_t n = !q ? strlen(p) : (q-p);
1307 if (str_l < str_m) {
1308 size_t avail = str_m-str_l;
1309 fast_memcpy(str+str_l, p, (n>avail?avail:n));
1313 const char *starting_p;
1314 size_t min_field_width = 0, precision = 0;
1315 int zero_padding = 0, precision_specified = 0, justify_left = 0;
1316 int alternate_form = 0, force_sign = 0;
1317 int space_for_positive = 1; /* If both the ' ' and '+' flags appear,
1318 the ' ' flag should be ignored. */
1319 char length_modifier = '\0'; /* allowed values: \0, h, l, L */
1320 char tmp[32];/* temporary buffer for simple numeric->string conversion */
1322 const char *str_arg; /* string address in case of string argument */
1323 size_t str_arg_l; /* natural field width of arg without padding
1325 unsigned char uchar_arg;
1326 /* unsigned char argument value - only defined for c conversion.
1327 N.B. standard explicitly states the char argument for
1328 the c conversion is unsigned */
1330 size_t number_of_zeros_to_pad = 0;
1331 /* number of zeros to be inserted for numeric conversions
1332 as required by the precision or minimal field width */
1334 size_t zero_padding_insertion_ind = 0;
1335 /* index into tmp where zero padding is to be inserted */
1337 char fmt_spec = '\0';
1338 /* current conversion specifier character */
1340 str_arg = credits;/* just to make compiler happy (defined but not used)*/
1342 starting_p = p; p++; /* skip '%' */
1344 while (*p == '0' || *p == '-' || *p == '+' ||
1345 *p == ' ' || *p == '#' || *p == '\'') {
1347 case '0': zero_padding = 1; break;
1348 case '-': justify_left = 1; break;
1349 case '+': force_sign = 1; space_for_positive = 0; break;
1350 case ' ': force_sign = 1;
1351 /* If both the ' ' and '+' flags appear, the ' ' flag should be ignored */
1352 #ifdef PERL_COMPATIBLE
1353 /* ... but in Perl the last of ' ' and '+' applies */
1354 space_for_positive = 1;
1357 case '#': alternate_form = 1; break;
1362 /* If the '0' and '-' flags both appear, the '0' flag should be ignored. */
1364 /* parse field width */
1367 p++; j = va_arg(ap, int);
1368 if (j >= 0) min_field_width = j;
1369 else { min_field_width = -j; justify_left = 1; }
1370 } else if (isdigit((int)(*p))) {
1371 /* size_t could be wider than unsigned int;
1372 make sure we treat argument like common implementations do */
1373 unsigned int uj = *p++ - '0';
1374 while (isdigit((int)(*p))) uj = 10*uj + (unsigned int)(*p++ - '0');
1375 min_field_width = uj;
1377 /* parse precision */
1379 p++; precision_specified = 1;
1381 int j = va_arg(ap, int);
1383 if (j >= 0) precision = j;
1385 precision_specified = 0; precision = 0;
1387 * Solaris 2.6 man page claims that in this case the precision
1388 * should be set to 0. Digital Unix 4.0, HPUX 10 and BSD man page
1389 * claim that this case should be treated as unspecified precision,
1390 * which is what we do here.
1393 } else if (isdigit((int)(*p))) {
1394 /* size_t could be wider than unsigned int;
1395 make sure we treat argument like common implementations do */
1396 unsigned int uj = *p++ - '0';
1397 while (isdigit((int)(*p))) uj = 10*uj + (unsigned int)(*p++ - '0');
1401 /* parse 'h', 'l' and 'll' length modifiers */
1402 if (*p == 'h' || *p == 'l') {
1403 length_modifier = *p; p++;
1404 if (length_modifier == 'l' && *p == 'l') { /* double l = long long */
1405 #ifdef SNPRINTF_LONGLONG_SUPPORT
1406 length_modifier = '2'; /* double l encoded as '2' */
1408 length_modifier = 'l'; /* treat it as a single 'l' */
1414 /* common synonyms: */
1416 case 'i': fmt_spec = 'd'; break;
1417 case 'D': fmt_spec = 'd'; length_modifier = 'l'; break;
1418 case 'U': fmt_spec = 'u'; length_modifier = 'l'; break;
1419 case 'O': fmt_spec = 'o'; length_modifier = 'l'; break;
1422 /* get parameter value, do initial processing */
1424 case '%': /* % behaves similar to 's' regarding flags and field widths */
1425 case 'c': /* c behaves similar to 's' regarding flags and field widths */
1427 length_modifier = '\0'; /* wint_t and wchar_t not supported */
1428 /* the result of zero padding flag with non-numeric conversion specifier*/
1429 /* is undefined. Solaris and HPUX 10 does zero padding in this case, */
1430 /* Digital Unix and Linux does not. */
1431 #if !defined(SOLARIS_COMPATIBLE) && !defined(HPUX_COMPATIBLE)
1432 zero_padding = 0; /* turn zero padding off for string conversions */
1439 int j = va_arg(ap, int);
1440 uchar_arg = (unsigned char) j; /* standard demands unsigned char */
1441 str_arg = (const char *) &uchar_arg;
1445 str_arg = va_arg(ap, const char *);
1446 if (!str_arg) str_arg_l = 0;
1447 /* make sure not to address string beyond the specified precision !!! */
1448 else if (!precision_specified) str_arg_l = strlen(str_arg);
1449 /* truncate string if necessary as requested by precision */
1450 else if (precision == 0) str_arg_l = 0;
1452 /* memchr on HP does not like n > 2^31 !!! */
1453 const char *q = memchr(str_arg, '\0',
1454 precision <= 0x7fffffff ? precision : 0x7fffffff);
1455 str_arg_l = !q ? precision : (q-str_arg);
1461 case 'd': case 'u': case 'o': case 'x': case 'X': case 'p': {
1462 /* NOTE: the u, o, x, X and p conversion specifiers imply
1463 the value is unsigned; d implies a signed value */
1466 /* 0 if numeric argument is zero (or if pointer is NULL for 'p'),
1467 +1 if greater than zero (or nonzero for unsigned arguments),
1468 -1 if negative (unsigned argument is never negative) */
1470 int int_arg = 0; unsigned int uint_arg = 0;
1471 /* only defined for length modifier h, or for no length modifiers */
1473 long int long_arg = 0; unsigned long int ulong_arg = 0;
1474 /* only defined for length modifier l */
1476 void *ptr_arg = NULL;
1477 /* pointer argument value -only defined for p conversion */
1479 #ifdef SNPRINTF_LONGLONG_SUPPORT
1480 long long int long_long_arg = 0;
1481 unsigned long long int ulong_long_arg = 0;
1482 /* only defined for length modifier ll */
1484 if (fmt_spec == 'p') {
1485 /* HPUX 10: An l, h, ll or L before any other conversion character
1486 * (other than d, i, u, o, x, or X) is ignored.
1488 * not specified, but seems to behave as HPUX does.
1489 * Solaris: If an h, l, or L appears before any other conversion
1490 * specifier (other than d, i, u, o, x, or X), the behavior
1491 * is undefined. (Actually %hp converts only 16-bits of address
1492 * and %llp treats address as 64-bit data which is incompatible
1493 * with (void *) argument on a 32-bit system).
1495 #ifdef SOLARIS_COMPATIBLE
1496 # ifdef SOLARIS_BUG_COMPATIBLE
1497 /* keep length modifiers even if it represents 'll' */
1499 if (length_modifier == '2') length_modifier = '\0';
1502 length_modifier = '\0';
1504 ptr_arg = va_arg(ap, void *);
1505 if (ptr_arg != NULL) arg_sign = 1;
1506 } else if (fmt_spec == 'd') { /* signed */
1507 switch (length_modifier) {
1510 /* It is non-portable to specify a second argument of char or short
1511 * to va_arg, because arguments seen by the called function
1512 * are not char or short. C converts char and short arguments
1513 * to int before passing them to a function.
1515 int_arg = va_arg(ap, int);
1516 if (int_arg > 0) arg_sign = 1;
1517 else if (int_arg < 0) arg_sign = -1;
1520 long_arg = va_arg(ap, long int);
1521 if (long_arg > 0) arg_sign = 1;
1522 else if (long_arg < 0) arg_sign = -1;
1524 #ifdef SNPRINTF_LONGLONG_SUPPORT
1526 long_long_arg = va_arg(ap, long long int);
1527 if (long_long_arg > 0) arg_sign = 1;
1528 else if (long_long_arg < 0) arg_sign = -1;
1532 } else { /* unsigned */
1533 switch (length_modifier) {
1536 uint_arg = va_arg(ap, unsigned int);
1537 if (uint_arg) arg_sign = 1;
1540 ulong_arg = va_arg(ap, unsigned long int);
1541 if (ulong_arg) arg_sign = 1;
1543 #ifdef SNPRINTF_LONGLONG_SUPPORT
1545 ulong_long_arg = va_arg(ap, unsigned long long int);
1546 if (ulong_long_arg) arg_sign = 1;
1551 str_arg = tmp; str_arg_l = 0;
1553 * For d, i, u, o, x, and X conversions, if precision is specified,
1554 * the '0' flag should be ignored. This is so with Solaris 2.6,
1555 * Digital UNIX 4.0, HPUX 10, Linux, FreeBSD, NetBSD; but not with Perl.
1557 #ifndef PERL_COMPATIBLE
1558 if (precision_specified) zero_padding = 0;
1560 if (fmt_spec == 'd') {
1561 if (force_sign && arg_sign >= 0)
1562 tmp[str_arg_l++] = space_for_positive ? ' ' : '+';
1563 /* leave negative numbers for sprintf to handle,
1564 to avoid handling tricky cases like (short int)(-32768) */
1565 #ifdef LINUX_COMPATIBLE
1566 } else if (fmt_spec == 'p' && force_sign && arg_sign > 0) {
1567 tmp[str_arg_l++] = space_for_positive ? ' ' : '+';
1569 } else if (alternate_form) {
1570 if (arg_sign != 0 && (fmt_spec == 'x' || fmt_spec == 'X') )
1571 { tmp[str_arg_l++] = '0'; tmp[str_arg_l++] = fmt_spec; }
1572 /* alternate form should have no effect for p conversion, but ... */
1573 #ifdef HPUX_COMPATIBLE
1574 else if (fmt_spec == 'p'
1575 /* HPUX 10: for an alternate form of p conversion,
1576 * a nonzero result is prefixed by 0x. */
1577 #ifndef HPUX_BUG_COMPATIBLE
1578 /* Actually it uses 0x prefix even for a zero value. */
1581 ) { tmp[str_arg_l++] = '0'; tmp[str_arg_l++] = 'x'; }
1584 zero_padding_insertion_ind = str_arg_l;
1585 if (!precision_specified) precision = 1; /* default precision is 1 */
1586 if (precision == 0 && arg_sign == 0
1587 #if defined(HPUX_BUG_COMPATIBLE) || defined(LINUX_COMPATIBLE)
1589 /* HPUX 10 man page claims: With conversion character p the result of
1590 * converting a zero value with a precision of zero is a null string.
1591 * Actually HP returns all zeroes, and Linux returns "(nil)". */
1594 /* converted to null string */
1595 /* When zero value is formatted with an explicit precision 0,
1596 the resulting formatted string is empty (d, i, u, o, x, X, p). */
1598 char f[5]; int f_l = 0;
1599 f[f_l++] = '%'; /* construct a simple format string for sprintf */
1600 if (!length_modifier) { }
1601 else if (length_modifier=='2') { f[f_l++] = 'l'; f[f_l++] = 'l'; }
1602 else f[f_l++] = length_modifier;
1603 f[f_l++] = fmt_spec; f[f_l++] = '\0';
1604 if (fmt_spec == 'p') str_arg_l += sprintf(tmp+str_arg_l, f, ptr_arg);
1605 else if (fmt_spec == 'd') { /* signed */
1606 switch (length_modifier) {
1608 case 'h': str_arg_l+=sprintf(tmp+str_arg_l, f, int_arg); break;
1609 case 'l': str_arg_l+=sprintf(tmp+str_arg_l, f, long_arg); break;
1610 #ifdef SNPRINTF_LONGLONG_SUPPORT
1611 case '2': str_arg_l+=sprintf(tmp+str_arg_l,f,long_long_arg); break;
1614 } else { /* unsigned */
1615 switch (length_modifier) {
1617 case 'h': str_arg_l+=sprintf(tmp+str_arg_l, f, uint_arg); break;
1618 case 'l': str_arg_l+=sprintf(tmp+str_arg_l, f, ulong_arg); break;
1619 #ifdef SNPRINTF_LONGLONG_SUPPORT
1620 case '2': str_arg_l+=sprintf(tmp+str_arg_l,f,ulong_long_arg);break;
1624 /* include the optional minus sign and possible "0x"
1625 in the region before the zero padding insertion point */
1626 if (zero_padding_insertion_ind < str_arg_l &&
1627 tmp[zero_padding_insertion_ind] == '-') {
1628 zero_padding_insertion_ind++;
1630 if (zero_padding_insertion_ind+1 < str_arg_l &&
1631 tmp[zero_padding_insertion_ind] == '0' &&
1632 (tmp[zero_padding_insertion_ind+1] == 'x' ||
1633 tmp[zero_padding_insertion_ind+1] == 'X') ) {
1634 zero_padding_insertion_ind += 2;
1637 { size_t num_of_digits = str_arg_l - zero_padding_insertion_ind;
1638 if (alternate_form && fmt_spec == 'o'
1639 #ifdef HPUX_COMPATIBLE /* ("%#.o",0) -> "" */
1642 #ifdef DIGITAL_UNIX_BUG_COMPATIBLE /* ("%#o",0) -> "00" */
1644 /* unless zero is already the first character */
1645 && !(zero_padding_insertion_ind < str_arg_l
1646 && tmp[zero_padding_insertion_ind] == '0')
1648 ) { /* assure leading zero for alternate-form octal numbers */
1649 if (!precision_specified || precision < num_of_digits+1) {
1650 /* precision is increased to force the first character to be zero,
1651 except if a zero value is formatted with an explicit precision
1653 precision = num_of_digits+1; precision_specified = 1;
1656 /* zero padding to specified precision? */
1657 if (num_of_digits < precision)
1658 number_of_zeros_to_pad = precision - num_of_digits;
1660 /* zero padding to specified minimal field width? */
1661 if (!justify_left && zero_padding) {
1662 int n = min_field_width - (str_arg_l+number_of_zeros_to_pad);
1663 if (n > 0) number_of_zeros_to_pad += n;
1667 default: /* unrecognized conversion specifier, keep format string as-is*/
1668 zero_padding = 0; /* turn zero padding off for non-numeric convers. */
1669 #ifndef DIGITAL_UNIX_COMPATIBLE
1670 justify_left = 1; min_field_width = 0; /* reset flags */
1672 #if defined(PERL_COMPATIBLE) || defined(LINUX_COMPATIBLE)
1673 /* keep the entire format string unchanged */
1674 str_arg = starting_p; str_arg_l = p - starting_p;
1675 /* well, not exactly so for Linux, which does something inbetween,
1676 * and I don't feel an urge to imitate it: "%+++++hy" -> "%+y" */
1678 /* discard the unrecognized conversion, just keep *
1679 * the unrecognized conversion character */
1680 str_arg = p; str_arg_l = 0;
1682 if (*p) str_arg_l++; /* include invalid conversion specifier unchanged
1683 if not at end-of-string */
1686 if (*p) p++; /* step over the just processed conversion specifier */
1687 /* insert padding to the left as requested by min_field_width;
1688 this does not include the zero padding in case of numerical conversions*/
1689 if (!justify_left) { /* left padding with blank or zero */
1690 int n = min_field_width - (str_arg_l+number_of_zeros_to_pad);
1692 if (str_l < str_m) {
1693 size_t avail = str_m-str_l;
1694 fast_memset(str+str_l, (zero_padding?'0':' '), (n>avail?avail:n));
1699 /* zero padding as requested by the precision or by the minimal field width
1700 * for numeric conversions required? */
1701 if (number_of_zeros_to_pad <= 0) {
1702 /* will not copy first part of numeric right now, *
1703 * force it to be copied later in its entirety */
1704 zero_padding_insertion_ind = 0;
1706 /* insert first part of numerics (sign or '0x') before zero padding */
1707 int n = zero_padding_insertion_ind;
1709 if (str_l < str_m) {
1710 size_t avail = str_m-str_l;
1711 fast_memcpy(str+str_l, str_arg, (n>avail?avail:n));
1715 /* insert zero padding as requested by the precision or min field width */
1716 n = number_of_zeros_to_pad;
1718 if (str_l < str_m) {
1719 size_t avail = str_m-str_l;
1720 fast_memset(str+str_l, '0', (n>avail?avail:n));
1725 /* insert formatted string
1726 * (or as-is conversion specifier for unknown conversions) */
1727 { int n = str_arg_l - zero_padding_insertion_ind;
1729 if (str_l < str_m) {
1730 size_t avail = str_m-str_l;
1731 fast_memcpy(str+str_l, str_arg+zero_padding_insertion_ind,
1737 /* insert right padding */
1738 if (justify_left) { /* right blank padding to the field width */
1739 int n = min_field_width - (str_arg_l+number_of_zeros_to_pad);
1741 if (str_l < str_m) {
1742 size_t avail = str_m-str_l;
1743 fast_memset(str+str_l, ' ', (n>avail?avail:n));
1750 #if defined(NEED_SNPRINTF_ONLY)
1753 if (str_m > 0) { /* make sure the string is null-terminated
1754 even at the expense of overwriting the last character
1755 (shouldn't happen, but just in case) */
1756 str[str_l <= str_m-1 ? str_l : str_m-1] = '\0';
1758 /* Return the number of characters formatted (excluding trailing null
1759 * character), that is, the number of characters that would have been
1760 * written to the buffer if it were large enough.
1762 * The value of str_l should be returned, but str_l is of unsigned type
1763 * size_t, and snprintf is int, possibly leading to an undetected
1764 * integer overflow, resulting in a negative return value, which is illegal.
1765 * Both XSH5 and ISO C99 (at least the draft) are silent on this issue.
1766 * Should errno be set to EOVERFLOW and EOF returned in this case???
1771 #endif /* __OS2__ */