packages/language/c/libc/time/v2_0/include/timeutil.h

   1 #ifndef CYGONCE_LIBC_TIME_TIMEUTIL_H
   2 #define CYGONCE_LIBC_TIME_TIMEUTIL_H
   3 //========================================================================
   4 //
   5 //      timeutil.h
   6 //
   7 //      ISO C date and time implementation support functions
   8 //
   9 //========================================================================
  10 //####ECOSGPLCOPYRIGHTBEGIN####
  11 // -------------------------------------------
  12 // This file is part of eCos, the Embedded Configurable Operating System.
  13 // Copyright (C) 1998, 1999, 2000, 2001, 2002 Red Hat, Inc.
  14 //
  15 // eCos is free software; you can redistribute it and/or modify it under
  16 // the terms of the GNU General Public License as published by the Free
  17 // Software Foundation; either version 2 or (at your option) any later version.
  18 //
  19 // eCos is distributed in the hope that it will be useful, but WITHOUT ANY
  20 // WARRANTY; without even the implied warranty of MERCHANTABILITY or
  21 // FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  22 // for more details.
  23 //
  24 // You should have received a copy of the GNU General Public License along
  25 // with eCos; if not, write to the Free Software Foundation, Inc.,
  26 // 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
  27 //
  28 // As a special exception, if other files instantiate templates or use macros
  29 // or inline functions from this file, or you compile this file and link it
  30 // with other works to produce a work based on this file, this file does not
  31 // by itself cause the resulting work to be covered by the GNU General Public
  32 // License. However the source code for this file must still be made available
  33 // in accordance with section (3) of the GNU General Public License.
  34 //
  35 // This exception does not invalidate any other reasons why a work based on
  36 // this file might be covered by the GNU General Public License.
  37 //
  38 // Alternative licenses for eCos may be arranged by contacting Red Hat, Inc.
  39 // at http://sources.redhat.com/ecos/ecos-license/
  40 // -------------------------------------------
  41 //####ECOSGPLCOPYRIGHTEND####
  42 //========================================================================
  43 //#####DESCRIPTIONBEGIN####
  44 //
  45 // Author(s):    jlarmour
  46 // Contributors: jlarmour
  47 // Date:         1999-03-03
  48 // Purpose:      Provide declarations for support functions used by the
  49 //               ISO C date and time implementation
  50 // Description:
  51 // Usage:        #include <cyg/libc/time/timeutil.h>
  52 //
  53 //####DESCRIPTIONEND####
  54 //
  55 //========================================================================
  56
  57 // INCLUDES
  58
  59 #include <cyg/infra/cyg_type.h>    // Common type definitions and support
  60
  61 #ifdef __cplusplus
  62 extern "C" {
  63 #endif
  64
  65 // GLOBALS
  66
  67 // Strings of the days and month names
  68 // FIXME: should comment out "const" in multi-dimensional arrays until
  69 // PR 19440 is fixed
  70 extern const char cyg_libc_time_day_name[7][10];
  71 extern const cyg_uint8 cyg_libc_time_day_name_len[7];
  72 extern const char cyg_libc_time_month_name[12][10];
  73 extern const cyg_uint8 cyg_libc_time_month_name_len[12];
  74
  75 // number of days in each month, defined for normal and leap years
  76 extern const cyg_uint8 cyg_libc_time_month_lengths[2][12];
  77
  78
  79 // FUNCTION PROTOTYPES
  80
  81 ////////////////////////////////////////
  82 // cyg_libc_time_normalize_structtm() //
  83 ////////////////////////////////////////
  84 //
  85 // cyg_libc_time_normalize_structtm() will adjust the fields of a struct tm
  86 // so that they are within the normal ranges expected.
  87 // tm_wday, tm_yday, and tm_isdst are ignored
  88
  89 extern void
  90 cyg_libc_time_normalize_structtm( struct tm *__timeptr );
  91
  92 //////////////////////////
  93 // cyg_libc_time_itoa() //
  94 //////////////////////////
  95 //
  96 // This converts num to a string and puts it into s padding with
  97 // "0"'s if padzero is set, or spaces otherwise if necessary.
  98 // The number of chars written to s is returned
  99 //
 100
 101 extern cyg_ucount8
 102 cyg_libc_time_itoa( cyg_uint8 *__s, cyg_int32 __num, cyg_uint8 __width,
 103                     cyg_bool __padzero );
 104
 105 #ifdef __cplusplus
 106 } // extern "C"
 107 #endif
 108
 109 #endif // CYGONCE_LIBC_TIME_TIMEUTIL_H multiple inclusion protection
 110
 111 // EOF timeutil.h