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]

Re: [PATCH] What is saprintf?


Charles Wilson wrote:
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


Patch checked in.

-- Jeff J.

------------------------------------------------------------------------

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]