strnlen.cpp File Reference

#include <corecrt_internal.h>
#include <corecrt_internal_simd.h>
#include <stdlib.h>
#include <string.h>

Include dependency graph for strnlen.cpp:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Enumerations
enum	strnlen_mode { bounded , unbounded }

Functions
template<strnlen_mode Mode>
static __forceinline bool __cdecl	last_reached (void const *const it, void const *const last) throw ()
template<>
__forceinline bool __cdecl	last_reached< unbounded > (void const *const it, void const *const last) throw ()
template<strnlen_mode Mode, typename Element >
_Check_return_	_When_ (maximum_count > _String_length_(string), _Post_satisfies_(return==_String_length_(string))) _When_(maximum_count< = _String_length_(string)
_Check_return_	_Post_satisfies_ (return==maximum_count)) static __forceinline size_t __cdecl common_strnlen_c(Element const *const string
_Check_return_ size_t const maximum_count	throw ()
size_t __cdecl	strnlen (char const *const string, size_t const maximum_count)
size_t __cdecl	wcsnlen (wchar_t const *const string, size_t const maximum_count)
size_t __cdecl	wcslen (wchar_t const *const string)

Enumeration Type Documentation

strnlen_mode

enum strnlen_mode

Enumerator
bounded
unbounded

Definition at line 26 of file strnlen.cpp.

    {
        bounded,  // strnlen mode; maximum_count is respected
        unbounded, // strlen mode; maximum_count is ignored
    };

Function Documentation

_Post_satisfies_()

_Check_return_ _Post_satisfies_

(

return

= = maximum_count

)

const

_When_()

template<strnlen_mode Mode, typename Element >

_Check_return_ _When_	(	maximum_count	,
		_String_length_(string)	,
		_Post_satisfies_(return==_String_length_(string))
	)		= _String_length_(string)

last_reached()

template<strnlen_mode Mode>

static __forceinline bool __cdecl last_reached ( void const *const  it, void const *const  last  ) throw ( )

static

Definition at line 37 of file strnlen.cpp.

{
    return it == last;
}

last_reached< unbounded >()

template<>

__forceinline bool __cdecl last_reached< unbounded >	(	void const *const	it,
		void const *const	last
	)
throw	(
	)

Definition at line 46 of file strnlen.cpp.

{
    UNREFERENCED_PARAMETER(it);
    UNREFERENCED_PARAMETER(last);
 
    return false;
}

strnlen()

size_t __cdecl strnlen	(	char const *const	string,
		size_t const	maximum_count
	)

Definition at line 206 of file strnlen.cpp.

{
    return common_strnlen<bounded>(reinterpret_cast<uint8_t const*>(string), maximum_count);
}

Referenced by _mbslwr_s_l(), _mbsnlen_l(), _mbsupr_s_l(), _strlwr_s_l_stat(), _strupr_s_l_stat(), _tzset(), BmfdQueryFont(), BmfdQueryFontFile(), FtfdQueryFont(), if(), KdbPrompt(), KdbPuts(), streamout(), and __crt_stdio_output::output_processor< Character, OutputAdapter, ProcessorBase >::type_case_s_compute_narrow_string_length().

throw()

_Check_return_ size_t const maximum_count throw

(

)

Definition at line 67 of file strnlen.cpp.

{
    Element const* const last = string + maximum_count;
    Element const*       it   = string;
 
    for (; !last_reached<Mode>(it, last) && *it != '\0'; ++it)
    {
    }
 
    return static_cast<size_t>(it - string);
}

wcslen()

size_t __cdecl wcslen

(

wchar_t const *const

string

)

Definition at line 224 of file strnlen.cpp.

{
    return common_strnlen<unbounded>(reinterpret_cast<uint16_t const*>(string), _CRT_UNBOUNDED_BUFFER_SIZE);
}

wcsnlen()

size_t __cdecl wcsnlen	(	wchar_t const *const	string,
		size_t const	maximum_count
	)

Definition at line 214 of file strnlen.cpp.

{
    return common_strnlen<bounded>(reinterpret_cast<uint16_t const*>(string), maximum_count);
}

Referenced by __acrt_CompareStringW(), __acrt_copy_locale_name(), __acrt_DownlevelLCIDToLocaleName(), __acrt_LCMapStringW(), _Success_(), _wcslwr_s_l_stat(), _wcsupr_s_l_stat(), EfiInitpCreateApplicationEntry(), PathCchAddExtension(), PathCchRemoveBackslashEx(), SetCurrentConsoleFontEx(), streamout(), and __crt_stdio_output::output_processor< Character, OutputAdapter, ProcessorBase >::type_case_s().