corecrt_wtime.h

// corecrt_wtime.h

// This file declares the wide character (wchar_t) time functionality, shared

// by <time.h> and <wchar.h>.

#pragma once

#include <corecrt.h>

_CRT_BEGIN_C_HEADER

__pragma

(pack(push,

))

extern

"C"

{

//-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

// Types

//-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

struct

{

int

tm_sec

;

// seconds after the minute - [0, 60] including leap second

int

tm_min

;

// minutes after the hour - [0, 59]

int

tm_hour

;

// hours since midnight - [0, 23]

int

tm_mday

;

// day of the month - [1, 31]

int

tm_mon

;

// months since January - [0, 11]

int

tm_year

;

// years since 1900

int

tm_wday

;

// days since Sunday - [0, 6]

int

tm_yday

;

// days since January 1 - [0, 365]

int

tm_isdst

;

// daylight savings time flag

};

//-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

// Wide String Time Functions

//-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

_Check_return_ _CRT_INSECURE_DEPRECATE(_wasctime_s)

__declspec

(deprecated(

"This function or variable may be unsafe. Consider using "

"_wasctime_s"

" instead. To disable deprecation, use _CRT_SECURE_NO_WARNINGS. "

"See online help for details."

))

_Success_(return != 0)

_Ret_writes_z_(26)

_ACRTIMP wchar_t* __cdecl _wasctime(

__declspec

(dllimport)

wchar_t

__cdecl

_wasctime

(

_In_ struct tm const* _Tm

struct

const

_Tm

);

_Success_(return == 0)

_Check_return_wat_

_ACRTIMP errno_t __cdecl _wasctime_s(

__declspec

(dllimport)

errno_t

__cdecl

_wasctime_s

(

_Out_writes_z_(_SizeInWords) _Post_readable_size_(26) wchar_t* _Buffer,

wchar_t

_Buffer

_In_range_(>=,26) size_t _SizeInWords,

size_t

_SizeInWords

_In_ struct tm const* _Tm

struct

const

_Tm

);

__DEFINE_CPP_OVERLOAD_SECURE_FUNC_0_1( _Success_(return == 0) errno_t, _wasctime_s, _Post_readable_size_(26) wchar_t, _Buffer, _In_ struct tm const*, _Time )

extern

"C++"

{

template

size_t

_Size

inline

errno_t

__cdecl

_wasctime_s

(

wchar_t

_Buffer

)[

_Size

struct

const

_Time

)

throw

() {

return

_wasctime_s

(

_Buffer

_Size

_Time

); } }

_Success_(return > 0)

_Check_return_wat_

_ACRTIMP size_t __cdecl wcsftime(

__declspec

(dllimport)

size_t

__cdecl

wcsftime

(

_Out_writes_z_(_SizeInWords) wchar_t* _Buffer,

wchar_t

_Buffer

_In_ size_t _SizeInWords,

size_t

_SizeInWords

_In_z_ wchar_t const* _Format,

wchar_t

const

_Format

_In_ struct tm const* _Tm

struct

const

_Tm

);

_Success_(return > 0)

_Check_return_wat_

_ACRTIMP size_t __cdecl _wcsftime_l(

__declspec

(dllimport)

size_t

__cdecl

_wcsftime_l

(

_Out_writes_z_(_SizeInWords) wchar_t* _Buffer,

wchar_t

_Buffer

_In_ size_t _SizeInWords,

size_t

_SizeInWords

_In_z_ wchar_t const* _Format,

wchar_t

const

_Format

_In_ struct tm const* _Tm,

struct

const

_Tm

_In_opt_ _locale_t _Locale

_locale_t

_Locale

);

_Success_(return != 0)

_Check_return_ _CRT_INSECURE_DEPRECATE(_wctime32_s)

__declspec

(deprecated(

"This function or variable may be unsafe. Consider using "

"_wctime32_s"

" instead. To disable deprecation, use _CRT_SECURE_NO_WARNINGS. "

"See online help for details."

))

_ACRTIMP wchar_t* __cdecl _wctime32(

__declspec

(dllimport)

wchar_t

__cdecl

_wctime32

(

_In_ __time32_t const* _Time

__time32_t

const

_Time

);

_Check_return_wat_

_ACRTIMP errno_t __cdecl _wctime32_s(

__declspec

(dllimport)

errno_t

__cdecl

_wctime32_s

(

_Out_writes_z_(_SizeInWords) _Post_readable_size_(26) wchar_t* _Buffer,

wchar_t

_Buffer

_In_ _In_range_(>=, 26) size_t _SizeInWords,

size_t

_SizeInWords

_In_ __time32_t const* _Time

__time32_t

const

_Time

);

__DEFINE_CPP_OVERLOAD_SECURE_FUNC_0_1( errno_t, _wctime32_s, _Post_readable_size_(26) wchar_t, _Buffer, _In_ __time32_t const*, _Time )

extern

"C++"

{

template

size_t

_Size

inline

errno_t

__cdecl

_wctime32_s

(

wchar_t

_Buffer

)[

_Size

__time32_t

const

_Time

)

throw

() {

return

_wctime32_s

(

_Buffer

_Size

_Time

); } }

_Success_(return != 0)

_Ret_writes_z_(26)

_Check_return_ _CRT_INSECURE_DEPRECATE(_wctime64_s)

__declspec

(deprecated(

"This function or variable may be unsafe. Consider using "

"_wctime64_s"

" instead. To disable deprecation, use _CRT_SECURE_NO_WARNINGS. "

"See online help for details."

))

_ACRTIMP wchar_t* __cdecl _wctime64(

__declspec

(dllimport)

wchar_t

__cdecl

_wctime64

(

_In_ __time64_t const* _Time

__time64_t

const

_Time

);

_Check_return_wat_

_ACRTIMP errno_t __cdecl _wctime64_s(

__declspec

(dllimport)

errno_t

__cdecl

_wctime64_s

(

_Out_writes_z_(_SizeInWords) _Post_readable_size_(26) wchar_t* _Buffer,

wchar_t

_Buffer

_In_ _In_range_(>=, 26) size_t _SizeInWords,

size_t

_SizeInWords

_In_ __time64_t const* _Time);

__time64_t

const

_Time

);

__DEFINE_CPP_OVERLOAD_SECURE_FUNC_0_1( errno_t, _wctime64_s, _Post_readable_size_(26) wchar_t, _Buffer, _In_ __time64_t const*, _Time )

extern

"C++"

{

template

size_t

_Size

inline

errno_t

__cdecl

_wctime64_s

(

wchar_t

_Buffer

)[

_Size

__time64_t

const

_Time

)

throw

() {

return

_wctime64_s

(

_Buffer

_Size

_Time

); } }

_Check_return_wat_

_ACRTIMP errno_t __cdecl _wstrdate_s(

__declspec

(dllimport)

errno_t

__cdecl

_wstrdate_s

(

_Out_writes_z_(_SizeInWords) _When_(_SizeInWords >=9, _Post_readable_size_(9)) wchar_t* _Buffer,

wchar_t

_Buffer

_In_ size_t _SizeInWords

size_t

_SizeInWords

);

__DEFINE_CPP_OVERLOAD_SECURE_FUNC_0_0( errno_t, _wstrdate_s, _Post_readable_size_(9) wchar_t, _Buffer )

extern

"C++"

{

template

size_t

_Size

inline

errno_t

__cdecl

_wstrdate_s

(

wchar_t

_Buffer

)[

_Size

])

throw

() {

return

_wstrdate_s

(

_Buffer

_Size

); } }

__DEFINE_CPP_OVERLOAD_STANDARD_FUNC_0_0( _Success_(return != 0) _Ret_writes_z_(9) wchar_t*, __RETURN_POLICY_DST, _ACRTIMP, _wstrdate, _Out_writes_z_(9), wchar_t, _Buffer )

__declspec

(deprecated(

"This function or variable may be unsafe. Consider using "

"_wstrdate_s"

" instead. To disable deprecation, use _CRT_SECURE_NO_WARNINGS. "

"See online help for details."

))

__declspec

(dllimport)

wchar_t

__cdecl

_wstrdate

(

wchar_t

_Buffer

);

_Check_return_wat_

_ACRTIMP errno_t __cdecl _wstrtime_s(

__declspec

(dllimport)

errno_t

__cdecl

_wstrtime_s

(

_Out_writes_z_(_SizeInWords) _When_(_SizeInWords >=9, _Post_readable_size_(9)) wchar_t* _Buffer,

wchar_t

_Buffer

_In_ size_t _SizeInWords

size_t

_SizeInWords

);

__DEFINE_CPP_OVERLOAD_SECURE_FUNC_0_0( errno_t, _wstrtime_s, _Post_readable_size_(9) wchar_t, _Buffer )

extern

"C++"

{

template

size_t

_Size

inline

errno_t

__cdecl

_wstrtime_s

(

wchar_t

_Buffer

)[

_Size

])

throw

() {

return

_wstrtime_s

(

_Buffer

_Size

); } }

__DEFINE_CPP_OVERLOAD_STANDARD_FUNC_0_0( _Success_(return != 0) _Ret_writes_z_(9) wchar_t*, __RETURN_POLICY_DST, _ACRTIMP, _wstrtime, _Out_writes_z_(9), wchar_t, _Buffer )

__declspec

(deprecated(

"This function or variable may be unsafe. Consider using "

"_wstrtime_s"

" instead. To disable deprecation, use _CRT_SECURE_NO_WARNINGS. "

"See online help for details."

))

__declspec

(dllimport)

wchar_t

__cdecl

_wstrtime

(

wchar_t

_Buffer

);

//-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

// Inline Definitions

//-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

#if !defined RC_INVOKED && !defined __midl && !defined _INC_WTIME_INL && !defined _CRT_NO_TIME_T

#pragma warning(push)

#pragma warning(disable: 4996)

#pragma warning(disable:

4996

)

#ifdef _USE_32BIT_TIME_T

_Check_return_

static __inline wchar_t* __CRTDECL _wctime(

_In_ time_t const* const _Time

)

{

return _wctime32(_Time);

}

_Check_return_wat_

static __inline errno_t __CRTDECL _wctime_s(

_Pre_notnull_ _Post_z_ _Out_writes_z_(_SizeInWords) wchar_t* const _Buffer,

_In_ size_t const _SizeInWords,

_In_ time_t const* const _Time)

{

return _wctime32_s(_Buffer, _SizeInWords, _Time);

}

#else // ^^^ _USE_32BIT_TIME_T ^^^ // vvv !_USE_32BIT_TIME_T vvv //

_Check_return_

static __inline wchar_t * __CRTDECL _wctime(

static

__inline

wchar_t

__cdecl

_wctime

(

_In_ time_t const* const _Time)

time_t

const

_Time

)

{

return

_wctime64

(

_Time

); }

_Check_return_wat_

static __inline errno_t __CRTDECL _wctime_s(

static

__inline

errno_t

__cdecl

_wctime_s

(

_Pre_notnull_ _Post_z_ _Out_writes_z_(_SizeInWords) wchar_t* const _Buffer,

wchar_t

const

_Buffer

_In_ size_t const _SizeInWords,

size_t

const

_SizeInWords

_In_ time_t const* const _Time

time_t

const

_Time

) {

return

_wctime64_s

(

_Buffer

_SizeInWords

_Time

); }

#endif // !_USE_32BIT_TIME_T

#pragma warning(pop) #endif

#pragma warning(pop)

_CRT_END_C_HEADER

}

__pragma

(pack(pop))