lib/time_r.h

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