This is the mail archive of the newlib@sources.redhat.com mailing list for the newlib project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

[PATCH] What is saprintf?


I think it should be 'asprintf'. This patch doesn't affect code, just documentation so that it *matches* the code.

--Chuck

2003-01-07 Charles Wilson <cwilson@ece.gatech.edu>

* libc/stdio/sprintf.c: fix typo
* libc/stdio/vfprintf.c: fix typo

Index: sprintf.c
===================================================================
RCS file: /cvs/src/src/newlib/libc/stdio/sprintf.c,v
retrieving revision 1.2
diff -u -r1.2 sprintf.c
--- sprintf.c	4 Jul 2002 18:56:17 -0000	1.2
+++ sprintf.c	7 Jan 2003 06:15:32 -0000
@@ -18,13 +18,13 @@
 /*
 
 FUNCTION
-        <<printf>>, <<fprintf>>, <<saprintf>>, <<sprintf>>, <<snprintf>>---format output
+        <<printf>>, <<fprintf>>, <<asprintf>>, <<sprintf>>, <<snprintf>>---format output
 INDEX
 	fprintf
 INDEX
 	printf
 INDEX
-	saprintf
+	asprintf
 INDEX
 	sprintf
 INDEX
@@ -36,7 +36,7 @@
         int printf(const char *<[format]> [, <[arg]>, ...]);
         int fprintf(FILE *<[fd]>, const char *<[format]> [, <[arg]>, ...]);
         int sprintf(char *<[str]>, const char *<[format]> [, <[arg]>, ...]);
-        int saprintf(char **<[strp]>, const char *<[format]> [, <[arg]>, ...]);
+        int asprintf(char **<[strp]>, const char *<[format]> [, <[arg]>, ...]);
         int snprintf(char *<[str]>, size_t <[size]>, const char *<[format]> [, <[arg]>, ...]);
 
 TRAD_SYNOPSIS
@@ -49,7 +49,7 @@
 	FILE *<[fd]>;
 	char *<[format]>;
 
-	int saprintf(<[strp]>, <[format]> [, <[arg]>, ...]);
+	int asprintf(<[strp]>, <[format]> [, <[arg]>, ...]);
 	char **<[strp]>;
 	char *<[format]>;
 
@@ -72,16 +72,16 @@
         If there are more arguments than the format requires, excess
         arguments are ignored.
 
-        <<fprintf>>, <<saprintf>>, <<sprintf>> and <<snprintf>> are identical 
+        <<fprintf>>, <<asprintf>>, <<sprintf>> and <<snprintf>> are identical 
 	to <<printf>>, other than the destination of the formatted output: 
 	<<fprintf>> sends the output to a specified file <[fd]>, while 
-	<<saprintf>> stores the output in a dynamically allocated buffer,
+	<<asprintf>> stores the output in a dynamically allocated buffer,
 	while <<sprintf>> stores the output in the specified char array 
 	<[str]> and <<snprintf>> limits number of characters written to 
 	<[str]> to at most <[size]> (including terminating <<0>>).  For 
 	<<sprintf>> and <<snprintf>>, the behavior is undefined if the 
 	output <<*<[str]>>> overlaps with one of the arguments. For
-	<<saprintf>>, <[strp]> points to a pointer to char which is filled
+	<<asprintf>>, <[strp]> points to a pointer to char which is filled
 	in with the dynamically allocated buffer.  <[format]> is a pointer 
 	to a charater string containing two types of objects: ordinary 
 	characters (other than <<%>>), which are copied unchanged to the 
@@ -282,11 +282,11 @@
 
 
 RETURNS
-<<sprintf>> and <<saprintf>> return the number of bytes in the output string,
+<<sprintf>> and <<asprintf>> return the number of bytes in the output string,
 save that the concluding <<NULL>> is not counted.
 <<printf>> and <<fprintf>> return the number of characters transmitted.
 If an error occurs, <<printf>> and <<fprintf>> return <<EOF>> and
-<<saprintf>> returns -1.  No error returns occur for <<sprintf>>.
+<<asprintf>> returns -1.  No error returns occur for <<sprintf>>.
 
 PORTABILITY
         The  ANSI C standard specifies that implementations must
Index: vfprintf.c
===================================================================
RCS file: /cvs/src/src/newlib/libc/stdio/vfprintf.c,v
retrieving revision 1.17
diff -u -r1.17 vfprintf.c
--- vfprintf.c	23 Aug 2002 01:56:03 -0000	1.17
+++ vfprintf.c	7 Jan 2003 06:17:37 -0000
@@ -91,7 +91,7 @@
 
 DESCRIPTION
 <<vprintf>>, <<vfprintf>>, <<vasprintf>>, <<vsprintf>> and <<vsnprintf>> are 
-(respectively) variants of <<printf>>, <<fprintf>>, <<saprintf>>, <<sprintf>>,
+(respectively) variants of <<printf>>, <<fprintf>>, <<asprintf>>, <<sprintf>>,
 and <<snprintf>>.  They differ only in allowing their caller to pass the 
 variable argument list as a <<va_list>> object (initialized by <<va_start>>) 
 rather than directly accepting a variable number of arguments.

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]