asctime.cpp File Reference

#include <corecrt_internal_securecrt.h>
#include <corecrt_internal_time.h>

Include dependency graph for asctime.cpp:

Go to the source code of this file.

Macros
#define	_ASCBUFSIZE   26

Functions
template<typename Character >
static Character *__cdecl	common_asctime_s_write_value (_Out_writes_(2) Character *p, int const value, bool const zero_fill) throw ()
template<typename Character >
	_Success_ (return==0) static errno_t __cdecl common_asctime_s(_Out_writes_z_(size_in_chars) _Post_readable_size_(_ASCBUFSIZE) Character *const buffer
	_In_range_ (>=, _ASCBUFSIZE) size_t const size_in_chars
tm const *const tm_value	throw ()
errno_t __cdecl	asctime_s (char *const buffer, size_t const size_in_chars, tm const *const tm_value)
errno_t __cdecl	_wasctime_s (wchar_t *const buffer, size_t const size_in_chars, tm const *const tm_value)
static char **	common_asctime_get_ptd_buffer (char) throw ()
static wchar_t **	common_asctime_get_ptd_buffer (wchar_t) throw ()
template<typename Character >
	_Success_ (return !=0) _Ret_writes_z_(26) static Character *__cdecl common_asctime(tm const *const tm_value) throw ()
char *__cdecl	asctime (tm const *const tm_value)
wchar_t *__cdecl	_wasctime (tm const *const tm_value)

Macro Definition Documentation

_ASCBUFSIZE

#define _ASCBUFSIZE   26

Definition at line 11 of file asctime.cpp.

Function Documentation

_In_range_()

_In_range_	(	>=	,
		_ASCBUFSIZE
	)		const

_Success_() [1/2]

template<typename Character >

_Success_	(	return !	= 0	)	const
throw	(
	)

Definition at line 166 of file asctime.cpp.

{
    static Character static_buffer[_ASCBUFSIZE];
 
    Character** ptd_buffer_address = common_asctime_get_ptd_buffer(Character());
    if (ptd_buffer_address != nullptr && *ptd_buffer_address == nullptr)
    {
        *ptd_buffer_address = _calloc_crt_t(Character, _ASCBUFSIZE).detach();
    }
 
    Character* const buffer = ptd_buffer_address != nullptr && *ptd_buffer_address != nullptr
        ? *ptd_buffer_address
        : static_buffer;
 
    errno_t const status = common_asctime_s(buffer, _ASCBUFSIZE, tm_value);
    if (status != 0)
        return nullptr;
 
    return buffer;
}

_Success_() [2/2]

template<typename Character >

_Success_

(

return

= = 0

)

const

_wasctime()

wchar_t *__cdecl _wasctime

(

tm const *const

tm_value

)

Definition at line 194 of file asctime.cpp.

{
    return common_asctime<wchar_t>(tm_value);
}

_wasctime_s()

errno_t __cdecl _wasctime_s	(	wchar_t *const	buffer,
		size_t const	size_in_chars,
		tm const *const	tm_value
	)

Definition at line 126 of file asctime.cpp.

{
    return common_asctime_s(buffer, size_in_chars, tm_value);
}

asctime()

char *__cdecl asctime

(

tm const *const

tm_value

)

Definition at line 189 of file asctime.cpp.

{
    return common_asctime<char>(tm_value);
}

asctime_s()

errno_t __cdecl asctime_s	(	char *const	buffer,
		size_t const	size_in_chars,
		tm const *const	tm_value
	)

Definition at line 117 of file asctime.cpp.

{
    return common_asctime_s(buffer, size_in_chars, tm_value);
}

common_asctime_get_ptd_buffer() [1/2]

static char ** common_asctime_get_ptd_buffer ( char  ) throw ( )

static

Definition at line 143 of file asctime.cpp.

{
    __acrt_ptd* const ptd = __acrt_getptd_noexit();
    if (ptd == nullptr)
        return nullptr;
 
    return &ptd->_asctime_buffer;
}

Referenced by _Success_().

common_asctime_get_ptd_buffer() [2/2]

static wchar_t ** common_asctime_get_ptd_buffer ( wchar_t  ) throw ( )

static

Definition at line 152 of file asctime.cpp.

{
    __acrt_ptd* const ptd = __acrt_getptd_noexit();
    if (ptd == nullptr)
        return nullptr;
 
    return &ptd->_wasctime_buffer;
}

common_asctime_s_write_value()

template<typename Character >

static Character *__cdecl common_asctime_s_write_value ( _Out_writes_(2) Character *  p, int const  value, bool const  zero_fill  ) throw ( )

static

Definition at line 21 of file asctime.cpp.

{
    if (value >= 10 || zero_fill)
    {
        *p++ = static_cast<Character>('0' + value / 10);
    }
    else
    {
        *p++ = ' ';
    }
 
    *p++ = static_cast<Character>('0' + value % 10);
    return p;
}

Referenced by throw().

throw()

tm const *const tm_value throw

(

)

Definition at line 54 of file asctime.cpp.

{
    _VALIDATE_RETURN_ERRCODE(
        buffer != nullptr && size_in_chars > 0,
        EINVAL
    )
 
    _RESET_STRING(buffer, size_in_chars);
 
    _VALIDATE_RETURN_ERRCODE(size_in_chars >= _ASCBUFSIZE, EINVAL)
    _VALIDATE_RETURN_ERRCODE(tm_value != nullptr,          EINVAL)
    _VALIDATE_RETURN_ERRCODE(tm_value->tm_year >= 0,       EINVAL)
 
    // Month, hour, minute, and second are zero-based
    _VALIDATE_RETURN_ERRCODE(tm_value->tm_mon  >= 0 && tm_value->tm_mon  <= 11, EINVAL)
    _VALIDATE_RETURN_ERRCODE(tm_value->tm_hour >= 0 && tm_value->tm_hour <= 23, EINVAL)
    _VALIDATE_RETURN_ERRCODE(tm_value->tm_min  >= 0 && tm_value->tm_min  <= 59, EINVAL)
    _VALIDATE_RETURN_ERRCODE(tm_value->tm_sec  >= 0 && tm_value->tm_sec  <= 60, EINVAL) // including leap second
    _VALIDATE_RETURN_ERRCODE(tm_value->tm_wday >= 0 && tm_value->tm_wday <=  6, EINVAL)
 
    _VALIDATE_RETURN_ERRCODE(__crt_time_is_day_valid(tm_value->tm_year, tm_value->tm_mon, tm_value->tm_mday), EINVAL)
 
    Character* buffer_it = buffer;
 
    // Copy the day name into the buffer:
    char const* const day_first = __dnames + tm_value->tm_wday * 3;
    char const* const day_last  = day_first + 3;
    for (char const* day_it = day_first; day_it != day_last; ++day_it)
        *buffer_it++ = static_cast<Character>(*day_it);
 
    *buffer_it++ = static_cast<Character>(' ');
 
    // Copy the month name into the buffer:
    char const* const month_first = __mnames + tm_value->tm_mon * 3;
    char const* const month_last  = month_first + 3;
    for (char const* month_it = month_first; month_it != month_last; ++month_it)
        *buffer_it++ = static_cast<Character>(*month_it);
 
    *buffer_it++ = static_cast<Character>(' ');
 
    // Copy the day of the month (1 - 31) into the buffer:
    buffer_it = common_asctime_s_write_value(buffer_it, tm_value->tm_mday, false);
    *buffer_it++ = static_cast<Character>(' ');
 
    // Copy the time into the buffer in HH:MM:SS form:
    buffer_it = common_asctime_s_write_value(buffer_it, tm_value->tm_hour, true);
    *buffer_it++ = static_cast<Character>(':');
    buffer_it = common_asctime_s_write_value(buffer_it, tm_value->tm_min, true);
    *buffer_it++ = static_cast<Character>(':');
    buffer_it = common_asctime_s_write_value(buffer_it, tm_value->tm_sec, true);
    *buffer_it++ = static_cast<Character>(' ');
 
    // Copy the four-digit year into the buffer:
    buffer_it = common_asctime_s_write_value(buffer_it, __crt_get_century(tm_value->tm_year), true);
    buffer_it = common_asctime_s_write_value(buffer_it, __crt_get_2digit_year(tm_value->tm_year), true);
 
    // And that's it...
    *buffer_it++ = static_cast<Character>('\n');
    *buffer_it++ = static_cast<Character>('\0');
 
    return 0;
}