mirror of
git://sourceware.org/git/glibc.git
synced 2025-03-06 20:58:33 +01:00
manual: Document generic printf error codes
Describe EOVERFLOW, ENOMEN, EILSEQ. Reviewed-by: Carlos O'Donell <carlos@redhat.com>
This commit is contained in:
parent
cf03971f7a
commit
0e16db440c
1 changed files with 23 additions and 0 deletions
|
@ -2356,6 +2356,29 @@ the easiest way to make sure you have all the right prototypes is to
|
|||
just include @file{stdio.h}.
|
||||
@pindex stdio.h
|
||||
|
||||
The @code{printf} family shares the error codes listed below.
|
||||
Individual functions may report additional @code{errno} values if they
|
||||
fail.
|
||||
|
||||
@table @code
|
||||
@item EOVERFLOW
|
||||
The number of written bytes would have exceeded @code{INT_MAX}, and thus
|
||||
could not be represented in the return type @code{int}.
|
||||
|
||||
@item ENOMEM
|
||||
The function could not allocate memory during processing. Long argument
|
||||
lists and certain floating point conversions may require memory
|
||||
allocation, as does initialization of an output stream upon first use.
|
||||
|
||||
@item EILSEQ
|
||||
POSIX specifies this error code should be used if a wide character is
|
||||
encountered that does not have a matching valid character. @Theglibc{}
|
||||
always performs transliteration, using a replacement character if
|
||||
necessary, so this error condition cannot occur on output. However,
|
||||
@theglibc{} uses @code{EILSEQ} to indicate that an input character
|
||||
sequence (wide or multi-byte) could not be converted successfully.
|
||||
@end table
|
||||
|
||||
@deftypefun int printf (const char *@var{template}, @dots{})
|
||||
@standards{ISO, stdio.h}
|
||||
@safety{@prelim{}@mtsafe{@mtslocale{}}@asunsafe{@asucorrupt{} @ascuheap{}}@acunsafe{@acsmem{} @aculock{} @acucorrupt{}}}
|
||||
|
|
Loading…
Add table
Reference in a new issue