compiler/stdc/asctime.c

   1 /*
   2     Copyright © 1995-2013, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Convert a time into a string.
   6 */
   7
   8 #include "__stdc_intbase.h"
   9
  10 /*****************************************************************************
  11
  12     NAME */
  13 #include <time.h>
  14
  15         char * asctime (
  16
  17 /*  SYNOPSIS */
  18         const struct tm * tm)
  19
  20 /*  FUNCTION
  21         The asctime() function converts the broken-down time value tm
  22         into a string.
  23
  24         See asctime_r() for details.
  25
  26     INPUTS
  27         tm - The broken down time
  28
  29     RESULT
  30         A statically allocated buffer with the converted time. Note that
  31         the contents of the buffer might get lost with the call of any of the
  32         date and time functions.
  33
  34     NOTES
  35         The returned string is buffered per stdc.library base.
  36
  37     EXAMPLE
  38         time_t      tt;
  39         struct tm * tm;
  40         char      * str;
  41
  42         // Get time
  43         time (&tt);
  44
  45         // Break time up
  46         tm = localtime (&tt);
  47
  48         // Convert to string
  49         str = asctime (tm);
  50
  51     BUGS
  52
  53     SEE ALSO
  54         time(), ctime(), gmtime(), localtime()
  55
  56     INTERNALS
  57
  58 ******************************************************************************/
  59 {
  60     struct StdCIntBase *StdCBase = (struct StdCIntBase *)__aros_getbase_StdCBase();
  61
  62     strftime (StdCBase->timebuffer, 26, "%C\n", tm);
  63
  64     return StdCBase->timebuffer;
  65 } /* asctime */