home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 1 / RISC_DISC_1.iso / pd_share / code / gcc / !GCC / patches / DeskLib / h / Time < prev    next >
Encoding:
Text File  |  1994-10-03  |  4.0 KB  |  112 lines
  1. /*
  2.     ####             #    #     # #
  3.     #   #            #    #       #          The FreeWare C library for
  4.     #   #  ##   ###  #  # #     # ###             RISC OS machines
  5.     #   # #  # #     # #  #     # #  #   ___________________________________
  6.     #   # ####  ###  ##   #     # #  #
  7.     #   # #        # # #  #     # #  #    Please refer to the accompanying
  8.     ####   ### ####  #  # ##### # ###    documentation for conditions of use
  9.     ________________________________________________________________________
  10.  
  11.     File:    Desklib:Time.h
  12.     Author:  Copyright © 1992, 1993, 1994 Jason Williams, Jason Howat
  13.     Version: 1.02 (22 May 1994)
  14.     Purpose: time handling
  15. */
  16.  
  17.  
  18. #ifndef __dl_time_h
  19. #define __dl_time_h
  20.  
  21. #ifndef __dl_core_h
  22. #include "DeskLib:/Core.h"
  23. #endif
  24.  
  25.  
  26.   /*  Time_Monotonic
  27.    *  Veneer for the OS_ReadMonotonicTime SWI
  28.    *  Returns an integer representing the time since the computer was switched
  29.    *  on, in centiseconds.
  30.    *  Used with Wimp_PollIdle to poll every now and then, as in:
  31.    *    time = Time_Monotonic();
  32.    *    Wimp_PollIdle(mask, block, time + 100);  // Pollidle for 1 sec (100cs)
  33.    *
  34.    *  Can also be used to time things, i.e.
  35.    *    time = Time_Monotonic();
  36.    *    while (Time_Monotonic < time+100) |* wait *| ;    // Wait for 1 second
  37.    */
  38. extern int Time_Monotonic(void);
  39.  
  40. #ifdef __cplusplus
  41. extern "C" {
  42. #endif
  43.  
  44.  
  45. /* Time_ConvertDateAndTime -------------------------------------------------
  46.  * Veneer for the OS_ConvertDateAndTime SWI.
  47.  * Uses the format string to convert the given time to text.
  48.  * Format codes:                             Field size:
  49.  *   CS      Centiseconds                        2
  50.  *   SE      Seconds                             2
  51.  *   MI      Minutes                             2
  52.  *   12      Hours (12hr format)                 2
  53.  *   24      Hours (24hr format)                 2
  54.  *   AM      'am' or 'pm'                        2
  55.  *   PM      ditto                               2
  56.  *   WE      Weekday                           varies
  57.  *   W3      Weekday (3 chars)                   3
  58.  *   WN      Weekday as number                   1
  59.  *   DY      Day of the month                    2
  60.  *   ST      'st', 'nd', 'rd' or 'th'            2
  61.  *   MO      Month name                        varies
  62.  *   M3      Month name (3 chars)                3
  63.  *   MN      Month as number                     2
  64.  *   CE      Century                             2
  65.  *   YR      Year within century                 2
  66.  *   WK      Week number (Mon-Sun)               2
  67.  *   DN      Day of year                         3
  68.  *   0       Insert an ASCII 0 byte              1
  69.  *   %       Insert a '%'                        1
  70.  */
  71. extern os_error *Time_ConvertDateAndTime(char *fivebyteblock, char *buffer,
  72.                                          int bufflen, char *format);
  73.  
  74.   /*  Six time formats for ConvertDateAndTime are pre-defined for you:
  75.    *
  76.    *  1. Time_CTIME is equal to ctime() found in ANSI C <time.h> without
  77.    *     the automatic \n inserted
  78.    *
  79.    *  2. Time_STANDARD is the default setting found on most Arcs and not
  80.    *     the system variable <Sys$DateFormat>
  81.    *
  82.    *  3. Time_FANCYDATE is Sunday, 16th of January, 1994.
  83.    *
  84.    *  4. Time_SHORTTIME is 11:30pm
  85.    *
  86.    *  5. Time_LONGTIME is 11:30:12pm
  87.    *
  88.    *  6. Time_EUROTIME is 23:30:12
  89.    */
  90.  
  91. #define Time_CTIME     "%W3 %M3 %DY %z24:%MI:%SE %CE%YR"
  92. #define Time_STANDARD  "%24:%mi:%se %dy-%m3-%ce%yr"
  93. #define Time_FANCYDATE "%WE, %zDY%ST of %MO, %CE%YR"
  94. #define Time_SHORTTIME "%z12:%MI%pm"
  95. #define Time_LONGTIME  "%z12:%MI:%SE%pm"
  96. #define Time_EUROTIME  "%z24:%MI:%SE"
  97.  
  98.  
  99. /* Time_ConvertStandardDateAndTime -----------------------------------------
  100.  * Veneer for the OS_ConvertStandardDateAndTime SWI.
  101.  * Converts the given time into a string using the format string stored in
  102.  * Sys$DateFormat.
  103.  */
  104. extern os_error *Time_ConvertStandardDateAndTime(char *fivebyteblock,
  105.                                                  char *buffer, int bufflen);
  106.  
  107. #ifdef __cplusplus
  108.            }
  109. #endif
  110.  
  111. #endif
  112.