mirror of
https://git.savannah.gnu.org/git/gnulib.git
synced 2025-08-17 12:41:05 +03:00
35 lines
1.1 KiB
Plaintext
35 lines
1.1 KiB
Plaintext
@node ctime_r
|
|
@section @code{ctime_r}
|
|
@findex ctime_r
|
|
|
|
POSIX specification: @url{http://www.opengroup.org/susv3xsh/ctime_r.html}
|
|
|
|
Gnulib module: ---
|
|
|
|
Portability problems fixed by Gnulib:
|
|
@itemize
|
|
@end itemize
|
|
|
|
Portability problems not fixed by Gnulib:
|
|
@itemize
|
|
@item
|
|
This function is missing on some platforms:
|
|
mingw.
|
|
@item
|
|
This function may put more than 26 bytes into the argument buffer if an
|
|
invalid year is passed.
|
|
@end itemize
|
|
|
|
@code{ctime_r} takes a pre-allocated buffer and length of the buffer,
|
|
and returns @code{NULL} on errors.
|
|
The input buffer should be at least 26 bytes in size. The output
|
|
string is locale-independent. However, years can have more than 4
|
|
digits if @code{time_t} is sufficiently wide, so the length of the
|
|
required output buffer is not easy to determine. Increasing the
|
|
buffer size when @code{ctime_r} returns @code{NULL} is not necessarily
|
|
sufficient. The @code{NULL} return value could mean some other error
|
|
condition, which will not go away by increasing the buffer size.
|
|
|
|
A more flexible function is @code{strftime}. However, note that it is
|
|
locale dependent.
|