home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / rcs57pc3.zip / rcs / src / partime.h < prev    next >
C/C++ Source or Header  |  1995-06-16  |  2KB  |  72 lines
  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 *));
  72.