compiler/stdc/asctime_r.c

   1 /*
   2     Copyright © 1995-2007, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Convert a time into a string, reentrant.
   6 */
   7
   8 /*****************************************************************************
   9
  10     NAME */
  11 #include <time.h>
  12
  13         char * asctime_r (
  14
  15 /*  SYNOPSIS */
  16         const struct tm * tm,
  17         char * buf)
  18
  19 /*  FUNCTION
  20         The asctime_r() function converts the broken-down time value tm
  21         into a string with this format:
  22
  23             "Wed Jun 30 21:49:08 1993\n"
  24
  25     INPUTS
  26         tm - The broken down time
  27         buf - Buffer of at least 26 characters to store the string in
  28
  29     RESULT
  30         The pointer passed in buf, containing the converted time. Note that
  31         there is a newline at the end of the buffer.
  32
  33     NOTES
  34
  35     EXAMPLE
  36         time_t    tt;
  37         struct tm tm;
  38         char      str[26];
  39
  40         // Get time
  41         time (&tt);
  42
  43         // Break time up
  44         localtime (&tt, &tm);
  45
  46         // Convert to string
  47         asctime (&tm, str);
  48
  49     BUGS
  50
  51     SEE ALSO
  52         time(), ctime_r(), gmtime_r(), localtime_r()
  53
  54     INTERNALS
  55
  56 ******************************************************************************/
  57 {
  58     strftime (buf, 26, "%C\n", tm);
  59
  60     return buf;
  61 } /* asctime */