annotate lib/time_r.h @ 6912:314715e0260d

Merge from coreutils.
author Paul Eggert <eggert@cs.ucla.edu>
date Mon, 03 Jul 2006 08:32:46 +0000
parents 76553bca8ed8
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4621
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
1 /* Reentrant time functions like localtime_r.
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
2
6700
76553bca8ed8 * time_r.h (asctime_r, ctime_r): Remove. These functions can
Paul Eggert <eggert@cs.ucla.edu>
parents: 5979
diff changeset
3 Copyright (C) 2003, 2005, 2006 Free Software Foundation, Inc.
4621
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
4
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
5 This program is free software; you can redistribute it and/or modify
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
6 it under the terms of the GNU General Public License as published by
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
7 the Free Software Foundation; either version 2, or (at your option)
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
8 any later version.
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
9
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
10 This program is distributed in the hope that it will be useful,
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
13 GNU General Public License for more details.
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
14
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
15 You should have received a copy of the GNU General Public License along
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
16 with this program; if not, write to the Free Software Foundation,
5848
a48fb0e98c8c *** empty log message ***
Paul Eggert <eggert@cs.ucla.edu>
parents: 4621
diff changeset
17 Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */
4621
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
18
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
19 /* Written by Paul Eggert. */
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
20
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
21 #ifndef _TIME_R_H
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
22 #define _TIME_R_H
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
23
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
24 /* Include <time.h> first, since it may declare these functions with
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
25 signatures that disagree with POSIX, and we don't want to rename
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
26 those declarations. */
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
27 #include <time.h>
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
28
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
29 #if !HAVE_TIME_R_POSIX
6700
76553bca8ed8 * time_r.h (asctime_r, ctime_r): Remove. These functions can
Paul Eggert <eggert@cs.ucla.edu>
parents: 5979
diff changeset
30
76553bca8ed8 * time_r.h (asctime_r, ctime_r): Remove. These functions can
Paul Eggert <eggert@cs.ucla.edu>
parents: 5979
diff changeset
31 /* Don't bother with asctime_r and ctime_r, since these functions are
76553bca8ed8 * time_r.h (asctime_r, ctime_r): Remove. These functions can
Paul Eggert <eggert@cs.ucla.edu>
parents: 5979
diff changeset
32 not safe (like asctime and ctime, they can overrun their 26-byte
76553bca8ed8 * time_r.h (asctime_r, ctime_r): Remove. These functions can
Paul Eggert <eggert@cs.ucla.edu>
parents: 5979
diff changeset
33 output buffers when given outlandish struct tm values), and we
76553bca8ed8 * time_r.h (asctime_r, ctime_r): Remove. These functions can
Paul Eggert <eggert@cs.ucla.edu>
parents: 5979
diff changeset
34 don't want to encourage applications to use unsafe functions. Use
76553bca8ed8 * time_r.h (asctime_r, ctime_r): Remove. These functions can
Paul Eggert <eggert@cs.ucla.edu>
parents: 5979
diff changeset
35 strftime or even sprintf instead. */
76553bca8ed8 * time_r.h (asctime_r, ctime_r): Remove. These functions can
Paul Eggert <eggert@cs.ucla.edu>
parents: 5979
diff changeset
36
4621
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
37 # undef gmtime_r
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
38 # undef localtime_r
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
39
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
40 # define gmtime_r rpl_gmtime_r
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
41 # define localtime_r rpl_localtime_r
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
42
5979
5cc92ab8ce76 Use shortcut links to the POSIX specification.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
43 /* See the POSIX:2001 specification
5cc92ab8ce76 Use shortcut links to the POSIX specification.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
44 <http://www.opengroup.org/susv3xsh/gmtime.html>. */
4621
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
45 struct tm *gmtime_r (time_t const * restrict, struct tm * restrict);
5979
5cc92ab8ce76 Use shortcut links to the POSIX specification.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
46
5cc92ab8ce76 Use shortcut links to the POSIX specification.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
47 /* See the POSIX:2001 specification
5cc92ab8ce76 Use shortcut links to the POSIX specification.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
48 <http://www.opengroup.org/susv3xsh/localtime.html>. */
4621
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
49 struct tm *localtime_r (time_t const * restrict, struct tm * restrict);
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
50 #endif
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
51
3d28ad4e18e2 Add time_r module. Change timegm, mktime, and strftime to use localtime_r
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
52 #endif