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

/*	$NetBSD: partime.h,v 1.2 1996/10/15 07:00:10 veego Exp $	*/

/* Parse a string, yielding a struct partime that describes it.  */

/* Copyright 1993, 1994, 1995 Paul Eggert
   Distributed under license by the Free Software Foundation, Inc.

This file is part of RCS.

RCS is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.

RCS is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with RCS; see the file COPYING.
If not, write to the Free Software Foundation,
59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

Report problems and direct all questions to:

    rcs-bugs@cs.purdue.edu

*/

#define TM_UNDEFINED (-1)
#define TM_DEFINED(x) (0 <= (x))

#define TM_UNDEFINED_ZONE ((long) -24 * 60 * 60)
#define TM_LOCAL_ZONE (TM_UNDEFINED_ZONE - 1)

struct partime {
	/*
	* This structure describes the parsed time.
	* Only the following tm_* values in it are used:
	*	sec, min, hour, mday, mon, year, wday, yday.
	* If TM_UNDEFINED(value), the parser never found the value.
	* The tm_year field is the actual year, not the year - 1900;
	* but see ymodulus below.
	*/
	struct tm tm;

	/*
	* If !TM_UNDEFINED(ymodulus),
	* then tm.tm_year is actually modulo ymodulus.
	*/
	int ymodulus;

	/*
	* Week of year, ISO 8601 style.
	* If TM_UNDEFINED(yweek), the parser never found yweek.
	* Weeks start on Mondays.
	* Week 1 includes Jan 4.
	*/
	int yweek;

	/* Seconds east of UTC; or TM_LOCAL_ZONE or TM_UNDEFINED_ZONE.  */
	long zone;
};

#if defined(__STDC__) || has_prototypes
#	define __PARTIME_P(x) x
#else
#	define __PARTIME_P(x) ()
#endif

char *partime __PARTIME_P((char const *, struct partime *));
char *parzone __PARTIME_P((char const *, long *));