forked from KolibriOS/kolibrios
set default newlib dir's structure
git-svn-id: svn://kolibrios.org@4874 a494cfbc-eb01-0410-851d-a64ba20cac60
This commit is contained in:
Sergey Semyonov (Serge)
333
contrib/sdk/sources/newlib/libc/time/strftime.c
Normal file
333
contrib/sdk/sources/newlib/libc/time/strftime.c
Normal file
@@ -0,0 +1,333 @@
|
||||
/* NOTE: This file defines both strftime() and wcsftime(). Take care when
|
||||
* making changes. See also wcsftime.c, and note the (small) overlap in the
|
||||
* manual description, taking care to edit both as needed. */
|
||||
/*
|
||||
* strftime.c
|
||||
* Original Author: G. Haley
|
||||
* Additions from: Eric Blake
|
||||
* Changes to allow dual use as wcstime, also: Craig Howland
|
||||
*
|
||||
* Places characters into the array pointed to by s as controlled by the string
|
||||
* pointed to by format. If the total number of resulting characters including
|
||||
* the terminating null character is not more than maxsize, returns the number
|
||||
* of characters placed into the array pointed to by s (not including the
|
||||
* terminating null character); otherwise zero is returned and the contents of
|
||||
* the array indeterminate.
|
||||
*/
|
||||
|
||||
/*
|
||||
FUNCTION
|
||||
<<strftime>>---convert date and time to a formatted string
|
||||
|
||||
INDEX
|
||||
strftime
|
||||
|
||||
ANSI_SYNOPSIS
|
||||
#include <time.h>
|
||||
size_t strftime(char *<[s]>, size_t <[maxsize]>,
|
||||
const char *<[format]>, const struct tm *<[timp]>);
|
||||
|
||||
TRAD_SYNOPSIS
|
||||
#include <time.h>
|
||||
size_t strftime(<[s]>, <[maxsize]>, <[format]>, <[timp]>)
|
||||
char *<[s]>;
|
||||
size_t <[maxsize]>;
|
||||
char *<[format]>;
|
||||
struct tm *<[timp]>;
|
||||
|
||||
DESCRIPTION
|
||||
<<strftime>> converts a <<struct tm>> representation of the time (at
|
||||
<[timp]>) into a null-terminated string, starting at <[s]> and occupying
|
||||
no more than <[maxsize]> characters.
|
||||
|
||||
You control the format of the output using the string at <[format]>.
|
||||
<<*<[format]>>> can contain two kinds of specifications: text to be
|
||||
copied literally into the formatted string, and time conversion
|
||||
specifications. Time conversion specifications are two- and
|
||||
three-character sequences beginning with `<<%>>' (use `<<%%>>' to
|
||||
include a percent sign in the output). Each defined conversion
|
||||
specification selects only the specified field(s) of calendar time
|
||||
data from <<*<[timp]>>>, and converts it to a string in one of the
|
||||
following ways:
|
||||
|
||||
o+
|
||||
o %a
|
||||
The abbreviated weekday name according to the current locale. [tm_wday]
|
||||
|
||||
o %A
|
||||
The full weekday name according to the current locale.
|
||||
In the default "C" locale, one of `<<Sunday>>', `<<Monday>>', `<<Tuesday>>',
|
||||
`<<Wednesday>>', `<<Thursday>>', `<<Friday>>', `<<Saturday>>'. [tm_wday]
|
||||
|
||||
o %b
|
||||
The abbreviated month name according to the current locale. [tm_mon]
|
||||
|
||||
o %B
|
||||
The full month name according to the current locale.
|
||||
In the default "C" locale, one of `<<January>>', `<<February>>',
|
||||
`<<March>>', `<<April>>', `<<May>>', `<<June>>', `<<July>>',
|
||||
`<<August>>', `<<September>>', `<<October>>', `<<November>>',
|
||||
`<<December>>'. [tm_mon]
|
||||
|
||||
o %c
|
||||
The preferred date and time representation for the current locale.
|
||||
[tm_sec, tm_min, tm_hour, tm_mday, tm_mon, tm_year, tm_wday]
|
||||
|
||||
o %C
|
||||
The century, that is, the year divided by 100 then truncated. For
|
||||
4-digit years, the result is zero-padded and exactly two characters;
|
||||
but for other years, there may a negative sign or more digits. In
|
||||
this way, `<<%C%y>>' is equivalent to `<<%Y>>'. [tm_year]
|
||||
|
||||
o %d
|
||||
The day of the month, formatted with two digits (from `<<01>>' to
|
||||
`<<31>>'). [tm_mday]
|
||||
|
||||
o %D
|
||||
A string representing the date, in the form `<<"%m/%d/%y">>'.
|
||||
[tm_mday, tm_mon, tm_year]
|
||||
|
||||
o %e
|
||||
The day of the month, formatted with leading space if single digit
|
||||
(from `<<1>>' to `<<31>>'). [tm_mday]
|
||||
|
||||
o %E<<x>>
|
||||
In some locales, the E modifier selects alternative representations of
|
||||
certain modifiers <<x>>. In newlib, it is ignored, and treated as %<<x>>.
|
||||
|
||||
o %F
|
||||
A string representing the ISO 8601:2000 date format, in the form
|
||||
`<<"%Y-%m-%d">>'. [tm_mday, tm_mon, tm_year]
|
||||
|
||||
o %g
|
||||
The last two digits of the week-based year, see specifier %G (from
|
||||
`<<00>>' to `<<99>>'). [tm_year, tm_wday, tm_yday]
|
||||
|
||||
o %G
|
||||
The week-based year. In the ISO 8601:2000 calendar, week 1 of the year
|
||||
includes January 4th, and begin on Mondays. Therefore, if January 1st,
|
||||
2nd, or 3rd falls on a Sunday, that day and earlier belong to the last
|
||||
week of the previous year; and if December 29th, 30th, or 31st falls
|
||||
on Monday, that day and later belong to week 1 of the next year. For
|
||||
consistency with %Y, it always has at least four characters.
|
||||
Example: "%G" for Saturday 2nd January 1999 gives "1998", and for
|
||||
Tuesday 30th December 1997 gives "1998". [tm_year, tm_wday, tm_yday]
|
||||
|
||||
o %h
|
||||
Synonym for "%b". [tm_mon]
|
||||
|
||||
o %H
|
||||
The hour (on a 24-hour clock), formatted with two digits (from
|
||||
`<<00>>' to `<<23>>'). [tm_hour]
|
||||
|
||||
o %I
|
||||
The hour (on a 12-hour clock), formatted with two digits (from
|
||||
`<<01>>' to `<<12>>'). [tm_hour]
|
||||
|
||||
o %j
|
||||
The count of days in the year, formatted with three digits
|
||||
(from `<<001>>' to `<<366>>'). [tm_yday]
|
||||
|
||||
o %k
|
||||
The hour (on a 24-hour clock), formatted with leading space if single
|
||||
digit (from `<<0>>' to `<<23>>'). Non-POSIX extension (c.p. %I). [tm_hour]
|
||||
|
||||
o %l
|
||||
The hour (on a 12-hour clock), formatted with leading space if single
|
||||
digit (from `<<1>>' to `<<12>>'). Non-POSIX extension (c.p. %H). [tm_hour]
|
||||
|
||||
o %m
|
||||
The month number, formatted with two digits (from `<<01>>' to `<<12>>').
|
||||
[tm_mon]
|
||||
|
||||
o %M
|
||||
The minute, formatted with two digits (from `<<00>>' to `<<59>>'). [tm_min]
|
||||
|
||||
o %n
|
||||
A newline character (`<<\n>>').
|
||||
|
||||
o %O<<x>>
|
||||
In some locales, the O modifier selects alternative digit characters
|
||||
for certain modifiers <<x>>. In newlib, it is ignored, and treated as %<<x>>.
|
||||
|
||||
o %p
|
||||
Either `<<AM>>' or `<<PM>>' as appropriate, or the corresponding strings for
|
||||
the current locale. [tm_hour]
|
||||
|
||||
o %P
|
||||
Same as '<<%p>>', but in lowercase. This is a GNU extension. [tm_hour]
|
||||
|
||||
o %r
|
||||
Replaced by the time in a.m. and p.m. notation. In the "C" locale this
|
||||
is equivalent to "%I:%M:%S %p". In locales which don't define a.m./p.m.
|
||||
notations, the result is an empty string. [tm_sec, tm_min, tm_hour]
|
||||
|
||||
o %R
|
||||
The 24-hour time, to the minute. Equivalent to "%H:%M". [tm_min, tm_hour]
|
||||
|
||||
o %S
|
||||
The second, formatted with two digits (from `<<00>>' to `<<60>>'). The
|
||||
value 60 accounts for the occasional leap second. [tm_sec]
|
||||
|
||||
o %t
|
||||
A tab character (`<<\t>>').
|
||||
|
||||
o %T
|
||||
The 24-hour time, to the second. Equivalent to "%H:%M:%S". [tm_sec,
|
||||
tm_min, tm_hour]
|
||||
|
||||
o %u
|
||||
The weekday as a number, 1-based from Monday (from `<<1>>' to
|
||||
`<<7>>'). [tm_wday]
|
||||
|
||||
o %U
|
||||
The week number, where weeks start on Sunday, week 1 contains the first
|
||||
Sunday in a year, and earlier days are in week 0. Formatted with two
|
||||
digits (from `<<00>>' to `<<53>>'). See also <<%W>>. [tm_wday, tm_yday]
|
||||
|
||||
o %V
|
||||
The week number, where weeks start on Monday, week 1 contains January 4th,
|
||||
and earlier days are in the previous year. Formatted with two digits
|
||||
(from `<<01>>' to `<<53>>'). See also <<%G>>. [tm_year, tm_wday, tm_yday]
|
||||
|
||||
o %w
|
||||
The weekday as a number, 0-based from Sunday (from `<<0>>' to `<<6>>').
|
||||
[tm_wday]
|
||||
|
||||
o %W
|
||||
The week number, where weeks start on Monday, week 1 contains the first
|
||||
Monday in a year, and earlier days are in week 0. Formatted with two
|
||||
digits (from `<<00>>' to `<<53>>'). [tm_wday, tm_yday]
|
||||
|
||||
o %x
|
||||
Replaced by the preferred date representation in the current locale.
|
||||
In the "C" locale this is equivalent to "%m/%d/%y".
|
||||
[tm_mon, tm_mday, tm_year]
|
||||
|
||||
o %X
|
||||
Replaced by the preferred time representation in the current locale.
|
||||
In the "C" locale this is equivalent to "%H:%M:%S". [tm_sec, tm_min, tm_hour]
|
||||
|
||||
o %y
|
||||
The last two digits of the year (from `<<00>>' to `<<99>>'). [tm_year]
|
||||
(Implementation interpretation: always positive, even for negative years.)
|
||||
|
||||
o %Y
|
||||
The full year, equivalent to <<%C%y>>. It will always have at least four
|
||||
characters, but may have more. The year is accurate even when tm_year
|
||||
added to the offset of 1900 overflows an int. [tm_year]
|
||||
|
||||
o %z
|
||||
The offset from UTC. The format consists of a sign (negative is west of
|
||||
Greewich), two characters for hour, then two characters for minutes
|
||||
(-hhmm or +hhmm). If tm_isdst is negative, the offset is unknown and no
|
||||
output is generated; if it is zero, the offset is the standard offset for
|
||||
the current time zone; and if it is positive, the offset is the daylight
|
||||
savings offset for the current timezone. The offset is determined from
|
||||
the TZ environment variable, as if by calling tzset(). [tm_isdst]
|
||||
|
||||
o %Z
|
||||
The time zone name. If tm_isdst is negative, no output is generated.
|
||||
Otherwise, the time zone name is based on the TZ environment variable,
|
||||
as if by calling tzset(). [tm_isdst]
|
||||
|
||||
o %%
|
||||
A single character, `<<%>>'.
|
||||
o-
|
||||
|
||||
RETURNS
|
||||
When the formatted time takes up no more than <[maxsize]> characters,
|
||||
the result is the length of the formatted string. Otherwise, if the
|
||||
formatting operation was abandoned due to lack of room, the result is
|
||||
<<0>>, and the string starting at <[s]> corresponds to just those
|
||||
parts of <<*<[format]>>> that could be completely filled in within the
|
||||
<[maxsize]> limit.
|
||||
|
||||
PORTABILITY
|
||||
ANSI C requires <<strftime>>, but does not specify the contents of
|
||||
<<*<[s]>>> when the formatted string would require more than
|
||||
<[maxsize]> characters. Unrecognized specifiers and fields of
|
||||
<<timp>> that are out of range cause undefined results. Since some
|
||||
formats expand to 0 bytes, it is wise to set <<*<[s]>>> to a nonzero
|
||||
value beforehand to distinguish between failure and an empty string.
|
||||
This implementation does not support <<s>> being NULL, nor overlapping
|
||||
<<s>> and <<format>>.
|
||||
|
||||
<<strftime>> requires no supporting OS subroutines.
|
||||
|
||||
BUGS
|
||||
<<strftime>> ignores the LC_TIME category of the current locale, hard-coding
|
||||
the "C" locale settings.
|
||||
*/
|
||||
|
||||
#include <newlib.h>
|
||||
#include <sys/config.h>
|
||||
#include <stddef.h>
|
||||
#include <stdio.h>
|
||||
#include <time.h>
|
||||
#include <string.h>
|
||||
#include <stdlib.h>
|
||||
#include <limits.h>
|
||||
#include <ctype.h>
|
||||
#include <wctype.h>
|
||||
|
||||
/* Defines to make the file dual use for either strftime() or wcsftime().
|
||||
* To get wcsftime, define MAKE_WCSFTIME.
|
||||
* To get strftime, do not define MAKE_WCSFTIME.
|
||||
* Names are kept friendly to strftime() usage. The biggest ugliness is the
|
||||
* use of the CQ() macro to make either regular character constants and
|
||||
* string literals or wide-character constants and wide-character-string
|
||||
* literals, as appropriate. */
|
||||
#if !defined(MAKE_WCSFTIME)
|
||||
# define CHAR char /* string type basis */
|
||||
# define CQ(a) a /* character constant qualifier */
|
||||
# define SFLG /* %s flag (null for normal char) */
|
||||
# define _ctloc(x) (ctloclen = strlen (ctloc = _CurrentTimeLocale->x), ctloc)
|
||||
# define TOLOWER(c) tolower((int)(unsigned char)(c))
|
||||
# define STRTOUL(c,p,b) strtoul((c),(p),(b))
|
||||
# define STRCPY(a,b) strcpy((a),(b))
|
||||
# define STRCHR(a,b) strchr((a),(b))
|
||||
# define STRLEN(a) strlen(a)
|
||||
# else
|
||||
# define strftime wcsftime /* Alternate function name */
|
||||
# define CHAR wchar_t /* string type basis */
|
||||
# define CQ(a) L##a /* character constant qualifier */
|
||||
# define snprintf swprintf /* wide-char equivalent function name */
|
||||
# define strncmp wcsncmp /* wide-char equivalent function name */
|
||||
# define TOLOWER(c) towlower((wint_t)(c))
|
||||
# define STRTOUL(c,p,b) wcstoul((c),(p),(b))
|
||||
# define STRCPY(a,b) wcscpy((a),(b))
|
||||
# define STRCHR(a,b) wcschr((a),(b))
|
||||
# define STRLEN(a) wcslen(a)
|
||||
# define SFLG "l" /* %s flag (l for wide char) */
|
||||
# ifdef __HAVE_LOCALE_INFO_EXTENDED__
|
||||
# define _ctloc(x) (ctloclen = wcslen (ctloc = _CurrentTimeLocale->w##x), \
|
||||
ctloc)
|
||||
# else
|
||||
# define CTLOCBUFLEN 256 /* Arbitrary big buffer size */
|
||||
const wchar_t *
|
||||
__ctloc (wchar_t *buf, const char *elem, size_t *len_ret)
|
||||
{
|
||||
buf[CTLOCBUFLEN - 1] = L'\0';
|
||||
*len_ret = mbstowcs (buf, elem, CTLOCBUFLEN - 1);
|
||||
if (*len_ret == (size_t) -1 )
|
||||
*len_ret = 0;
|
||||
return buf;
|
||||
}
|
||||
# define _ctloc(x) (ctloc = __ctloc (ctlocbuf, _CurrentTimeLocale->x, \
|
||||
&ctloclen))
|
||||
# endif
|
||||
#endif /* MAKE_WCSFTIME */
|
||||
|
||||
|
||||
size_t _DEFUN (strftime, (s, maxsize, format, tim_p),
|
||||
CHAR *s _AND
|
||||
size_t maxsize _AND
|
||||
_CONST CHAR *format _AND
|
||||
_CONST struct tm *tim_p)
|
||||
{
|
||||
|
||||
return 0;
|
||||
}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user