_strerr.cpp File Reference

#include <corecrt_internal.h>
#include <corecrt_internal_traits.h>
#include <malloc.h>
#include <stdlib.h>
#include <string.h>

Include dependency graph for _strerr.cpp:

Go to the source code of this file.

Functions
static char *&__cdecl	get_strerror_buffer (__acrt_ptd *const ptd, char) throw ()
static wchar_t *&__cdecl	get_strerror_buffer (__acrt_ptd *const ptd, wchar_t) throw ()
static errno_t __cdecl	append_message (_Inout_updates_z_(buffer_count) char *const buffer, size_t const buffer_count, char const *const message) throw ()
static errno_t __cdecl	append_message (_Inout_updates_z_(buffer_count) wchar_t *const buffer, size_t const buffer_count, char const *const message) throw ()
template<typename Character >
_Ret_z_	_Success_ (return !=0) static Character *__cdecl common_strerror(Character const *const message) throw ()
char *__cdecl	_strerror (char const *const message)
wchar_t *__cdecl	__wcserror (wchar_t const *const message)
template<typename Character >
static errno_t __cdecl	common_strerror_s (_Out_writes_z_(buffer_count) Character *const buffer, size_t const buffer_count, Character const *const message) throw ()
errno_t __cdecl	_strerror_s (char *const buffer, size_t const buffer_count, char const *const message)
errno_t __cdecl	__wcserror_s (wchar_t *const buffer, size_t const buffer_count, wchar_t const *const message)

Variables
size_t const	minimum_message_length = 5

Function Documentation

__wcserror()

wchar_t *__cdecl __wcserror

(

wchar_t const *const

message

)

Definition at line 124 of file _strerr.cpp.

{
    return common_strerror(message);
}

__wcserror_s()

errno_t __cdecl __wcserror_s	(	wchar_t *const	buffer,
		size_t const	buffer_count,
		wchar_t const *const	message
	)

Definition at line 196 of file _strerr.cpp.

{
    return common_strerror_s(buffer, buffer_count, message);
}

_strerror()

char *__cdecl _strerror

(

char const *const

message

)

Definition at line 119 of file _strerr.cpp.

{
    return common_strerror(message);
}

_strerror_s()

errno_t __cdecl _strerror_s	(	char *const	buffer,
		size_t const	buffer_count,
		char const *const	message
	)

Definition at line 187 of file _strerr.cpp.

{
    return common_strerror_s(buffer, buffer_count, message);
}

_Success_()

template<typename Character >

_Ret_z_ _Success_	(	return !	= 0	)	const
throw	(
	)

Definition at line 77 of file _strerr.cpp.

{
    using traits = __crt_char_traits<Character>;
 
    errno_t const original_errno_value = errno;
 
    __acrt_ptd* const ptd = __acrt_getptd_noexit();
    if (!ptd)
        return nullptr;
 
    Character*& buffer = get_strerror_buffer(ptd, Character());
    if (!buffer)
        buffer = _calloc_crt_t(Character, strerror_buffer_count).detach();
 
    if (!buffer)
        return nullptr;
 
    buffer[0] = '\0';
 
    // CRT_REFACTOR TODO AppCRT/DesktopCRT Dependencies
    // (We should be using mbs* functions here).
    if (message && message[0] != '\0')
    {
        Character const colon[] = { ':', ' ', '\0' };
 
        // Leave room for the ": \n\0"
        _ERRCHECK(traits::tcsncat_s(buffer, strerror_buffer_count, message, strerror_buffer_count - 4));
        _ERRCHECK(traits::tcscat_s(buffer, strerror_buffer_count, colon));
    }
 
    char const* const system_message = _get_sys_err_msg(original_errno_value);
    _ERRCHECK(append_message(buffer, strerror_buffer_count, system_message));
 
    Character const newline[] = { '\n', '\0' };
    _ERRCHECK(traits::tcscat_s(buffer, strerror_buffer_count, newline));
 
    return buffer;
}

append_message() [1/2]

static errno_t __cdecl append_message ( _Inout_updates_z_(buffer_count) char *const  buffer, size_t const  buffer_count, char const *const  message  ) throw ( )

static

Definition at line 51 of file _strerr.cpp.

{
    return strncat_s(buffer, buffer_count, message, buffer_count - strlen(buffer) - 2);
}

Referenced by _Success_().

append_message() [2/2]

static errno_t __cdecl append_message ( _Inout_updates_z_(buffer_count) wchar_t *const  buffer, size_t const  buffer_count, char const *const  message  ) throw ( )

static

Definition at line 60 of file _strerr.cpp.

{
    size_t const buffer_length = wcslen(buffer);
    return mbstowcs_s(
        nullptr,
        buffer + buffer_length,
        buffer_count - buffer_length,
        message,
        buffer_count - buffer_length - 2);
}

common_strerror_s()

template<typename Character >

static errno_t __cdecl common_strerror_s ( _Out_writes_z_(buffer_count) Character *const  buffer, size_t const  buffer_count, Character const *const  message  ) throw ( )

static

Definition at line 157 of file _strerr.cpp.

{
    using traits = __crt_char_traits<Character>;
 
    errno_t const original_errno_value = errno;
 
    _VALIDATE_RETURN_ERRCODE(buffer != nullptr, EINVAL);
    _VALIDATE_RETURN_ERRCODE(buffer_count > 0,  EINVAL);
    buffer[0] = '\0';
 
    if (message &&
        message[0] != '\0' &&
        traits::tcslen(message) < (buffer_count - 2 - minimum_message_length))
    {
        Character const colon[] = { ':', ' ', '\0' };
        _ERRCHECK(traits::tcscpy_s(buffer, buffer_count, message));
        _ERRCHECK(traits::tcscat_s(buffer, buffer_count, colon));
    }
 
    // Append the error message at the end of the buffer:
    return traits::tcserror_s(
        buffer       + traits::tcslen(buffer),
        buffer_count - traits::tcslen(buffer),
        original_errno_value);
}

Referenced by __wcserror_s(), and _strerror_s().

get_strerror_buffer() [1/2]

static char *&__cdecl get_strerror_buffer ( __acrt_ptd *const  ptd, char    ) throw ( )

static

Definition at line 41 of file _strerr.cpp.

{
    return ptd->_strerror_buffer;
}

Referenced by _Success_().

get_strerror_buffer() [2/2]

static wchar_t *&__cdecl get_strerror_buffer ( __acrt_ptd *const  ptd, wchar_t    ) throw ( )

static

Definition at line 46 of file _strerr.cpp.

{
    return ptd->_wcserror_buffer;
}

Variable Documentation

minimum_message_length

size_t const minimum_message_length = 5

Definition at line 154 of file _strerr.cpp.

Referenced by common_strerror_s().