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}.
|
just include @file{stdio.h}.
|
||||||
@pindex 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{})
|
@deftypefun int printf (const char *@var{template}, @dots{})
|
||||||
@standards{ISO, stdio.h}
|
@standards{ISO, stdio.h}
|
||||||
@safety{@prelim{}@mtsafe{@mtslocale{}}@asunsafe{@asucorrupt{} @ascuheap{}}@acunsafe{@acsmem{} @aculock{} @acucorrupt{}}}
|
@safety{@prelim{}@mtsafe{@mtslocale{}}@asunsafe{@asucorrupt{} @ascuheap{}}@acunsafe{@acsmem{} @aculock{} @acucorrupt{}}}
|
||||||
|
|
Loading…
Add table
Reference in a new issue