contrib/patch/partime.h

   1 /* Parse a string, yielding a struct partime that describes it.  */
   2
   3 /* Copyright 1993, 1994, 1995, 1997 Paul Eggert
   4    Distributed under license by the Free Software Foundation, Inc.
   5
   6    This file is part of RCS.
   7
   8    RCS is free software; you can redistribute it and/or modify
   9    it under the terms of the GNU General Public License as published by
  10    the Free Software Foundation; either version 2, or (at your option)
  11    any later version.
  12
  13    RCS is distributed in the hope that it will be useful,
  14    but WITHOUT ANY WARRANTY; without even the implied warranty of
  15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16    GNU General Public License for more details.
  17
  18    You should have received a copy of the GNU General Public License
  19    along with RCS; see the file COPYING.
  20    If not, write to the Free Software Foundation,
  21    59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  22
  23    Report problems and direct all questions to:
  24
  25    rcs-bugs@cs.purdue.edu
  26
  27  */
  28
  29 #define TM_UNDEFINED (-1)
  30 #define TM_DEFINED(x) (0 <= (x))
  31
  32 /* #include <limits.h> if you want to use these symbols.  */
  33 #define TM_LOCAL_ZONE LONG_MIN
  34 #define TM_UNDEFINED_ZONE (LONG_MIN + 1)
  35
  36 struct partime
  37   {
  38     /* This structure describes the parsed time.
  39        Only the following tm_* values in it are used:
  40                 sec, min, hour, mday, mon, year, wday, yday.
  41        If TM_UNDEFINED (value), the parser never found the value.
  42        The tm_year field is the actual year, not the year - 1900;
  43        but see ymodulus below.  */
  44     struct tm tm;
  45
  46     /* If !TM_UNDEFINED (ymodulus),
  47        then tm.tm_year is actually modulo ymodulus.  */
  48     int ymodulus;
  49
  50     /* Week of year, ISO 8601 style.
  51        If TM_UNDEFINED (yweek), the parser never found yweek.
  52        Weeks start on Mondays.
  53        Week 1 includes Jan 4.  */
  54     int yweek;
  55
  56     /* Seconds east of UTC; or TM_LOCAL_ZONE or TM_UNDEFINED_ZONE.  */
  57     long zone;
  58   };
  59
  60 #if defined __STDC__ || has_prototypes
  61 # define __PARTIME_P(x) x
  62 #else
  63 # define __PARTIME_P(x) ()
  64 #endif
  65
  66 char *partime __PARTIME_P ((char const *, struct partime *));
  67 char *parzone __PARTIME_P ((char const *, long *));