gnu/usr.bin/rcs/lib/partime.h

   1 /* Parse a string, yielding a struct partime that describes it.  */
   2
   3 /* Copyright 1993, 1994, 1995 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 #define TM_UNDEFINED_ZONE ((long) -24 * 60 * 60)
  33 #define TM_LOCAL_ZONE (TM_UNDEFINED_ZONE - 1)
  34
  35 struct partime {
  36         /*
  37         * This structure describes the parsed time.
  38         * Only the following tm_* values in it are used:
  39         *       sec, min, hour, mday, mon, year, wday, yday.
  40         * If TM_UNDEFINED(value), the parser never found the value.
  41         * The tm_year field is the actual year, not the year - 1900;
  42         * but see ymodulus below.
  43         */
  44         struct tm tm;
  45
  46         /*
  47         * If !TM_UNDEFINED(ymodulus),
  48         * then tm.tm_year is actually modulo ymodulus.
  49         */
  50         int ymodulus;
  51
  52         /*
  53         * Week of year, ISO 8601 style.
  54         * If TM_UNDEFINED(yweek), the parser never found yweek.
  55         * Weeks start on Mondays.
  56         * Week 1 includes Jan 4.
  57         */
  58         int yweek;
  59
  60         /* Seconds east of UTC; or TM_LOCAL_ZONE or TM_UNDEFINED_ZONE.  */
  61         long zone;
  62 };
  63
  64 #if defined(__STDC__) || has_prototypes
  65 #       define __PARTIME_P(x) x
  66 #else
  67 #       define __PARTIME_P(x) ()
  68 #endif
  69
  70 char *partime __PARTIME_P((char const *, struct partime *));
  71 char *parzone __PARTIME_P((char const *, long *));