asctime.gml

来自「开放源码的编译器open watcom 1.6.0版的源代码」· GML 代码 · 共 110 行

.func asctime Functions
.func2 _asctime
.func2 _wasctime
.func2 __wasctime
.func2 _uasctime
.func2 _u_asctime
#include <time.h>
char * asctime( const struct tm *timeptr );
char *_asctime( const struct tm *timeptr, char *buf );
.ixfunc2 '&TimeFunc' asctime
.ixfunc2 '&TimeFunc' _asctime
.if &'length(&wfunc.) ne 0 .do begin
wchar_t * _wasctime( const struct tm *timeptr );
wchar_t *__wasctime( const struct tm *timeptr, wchar_t *buf );
.ixfunc2 '&TimeFunc' _wasctime
.ixfunc2 '&TimeFunc' __wasctime
.ixfunc2 '&Wide' _wasctime
.ixfunc2 '&Wide' __wasctime
.do end
.if &'length(&ufunc.) ne 0 .do begin
wchar_t * _uasctime( const struct tm *timeptr );
wchar_t *_u_asctime( const struct tm *timeptr,
                      wchar_t *buf );
.ixfunc2 '&TimeFunc' _uasctime
.ixfunc2 '&TimeFunc' _u_asctime
.do end
.im structtm
.funcend
.funcbold asctime
.*
.safealt
.*
.desc begin
The &func functions convert the time information in the structure
pointed to by
.arg timeptr
into a string containing exactly 26 characters.
This string has the form shown in the following example:
.millust begin
Sat Mar 21 15:58:27 1987\n\0
.millust end
.pc
All fields have a constant width.
The new-line character
.id '\n'
and the null character
.id '\0'
occupy the last two positions of the string.
.np
The ANSI function &func places the result string in a static buffer
that is re-used each time &func or
.kw ctime
is called.
The non-ANSI function
.kw _asctime
places the result string in the buffer pointed to by
.arg buf.
.if &'length(&wfunc.) ne 0 .do begin
.np
The
.kw _wasctime
and
.kw __wasctime
functions are identical to their
.kw asctime
and
.kw _asctime
counterparts except that they deal with wide-character strings.
.do end
.if &'length(&ufunc.) ne 0 .do begin
The Unicode function
.kw _uasctime
is identical to &func except that it produces a Unicode string (which
is twice as long).
The Unicode function
.kw _u_asctime
is identical to
.kw _asctime
except that it produces a Unicode string (which is twice as long).
.do end
.desc end
.return begin
The &func functions return a pointer to the character string result.
.return end
.see begin
.im seetime asctime
.see end
.exmp begin
#include <stdio.h>
#include <time.h>
.exmp break
void main()
  {
    struct tm  time_of_day;
    time_t     ltime;
    auto char  buf[26];
.exmp break
    time( &ltime );
    _localtime( &ltime, &time_of_day );
    printf( "Date and time is: %s\n",
            _asctime( &time_of_day, buf ) );
  }
.exmp output
Date and time is: Sat Mar 21 15:58:27 1987
.exmp end
.* The following line forces an entry out for the function
.sr mfunc='x __wasctime'
.class ANSI
.system