compiler/clib/asctime.c

   1 /*
   2     Copyright © 1995-2003, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Convert a time into a string.
   6 */
   7
   8 /*****************************************************************************
   9
  10     NAME */
  11 #include <time.h>
  12
  13         char * asctime (
  14
  15 /*  SYNOPSIS */
  16         const struct tm * tm)
  17
  18 /*  FUNCTION
  19         The asctime() function converts the broken-down time value tm
  20         into a string with this format:
  21
  22             "Wed Jun 30 21:49:08 1993\n"
  23
  24         The return value points to a statically allocated string which
  25         might be overwritten by subsequent calls to any of the date and
  26         time functions.
  27
  28     INPUTS
  29         tm - The broken down time
  30
  31     RESULT
  32         A statically allocated buffer with the converted time. Note that
  33         there is a newline at the end of the buffer and that the contents
  34         of the buffer might get lost with the call of any of the date
  35         and time functions.
  36
  37     NOTES
  38
  39     EXAMPLE
  40         time_t      tt;
  41         struct tm * tm;
  42         char      * str;
  43
  44         // Get time
  45         time (&tt);
  46
  47         // Break time up
  48         tm = localtime (&tt);
  49
  50         // Convert to string
  51         str = asctime (tm);
  52
  53     BUGS
  54
  55     SEE ALSO
  56         time(), ctime(), localtime()
  57
  58     INTERNALS
  59
  60 ******************************************************************************/
  61 {
  62     static char buffer[26];
  63
  64     strftime (buffer, sizeof (buffer), "%C\n", tm);
  65
  66     return buffer;
  67 } /* asctime */