compiler/stdc/ctime.c

   1 /*
   2     Copyright © 1995-2007, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Return the current time in seconds.
   6 */
   7
   8 /*****************************************************************************
   9
  10     NAME */
  11 #include <time.h>
  12
  13         char * ctime (
  14
  15 /*  SYNOPSIS */
  16         const time_t * tt)
  17
  18 /*  FUNCTION
  19         The ctime() function converts the broken-down time value tt
  20         into a string.
  21
  22         See ctime_r() for details.
  23
  24     INPUTS
  25         tt - Convert this time.
  26
  27     RESULT
  28         A statically allocated buffer with the converted time. Note that
  29         the contents of the buffer might get lost with the call of any of the
  30         date and time functions.
  31
  32     NOTES
  33         This function must not be used in a shared library or
  34         in a threaded application. Use ctime_r() instead.
  35
  36     EXAMPLE
  37         time_t tt;
  38         char * str;
  39
  40         // Get time
  41         time (&tt);
  42
  43         // Convert to string
  44         str = ctime (&tt);
  45
  46     BUGS
  47
  48     SEE ALSO
  49         time(), asctime(), gmtime(), localtime()
  50
  51     INTERNALS
  52
  53 ******************************************************************************/
  54 {
  55     return asctime (localtime (tt));
  56 } /* ctime */