getpath.cpp File Reference

#include <corecrt_internal.h>
#include <stddef.h>

Include dependency graph for getpath.cpp:

Go to the source code of this file.

Functions
template<typename Character >
	_Success_ (return !=0) static Character *__cdecl common_getpath(_In_z_ Character const *const delimited_paths
	_Out_writes_z_ (result_count) Character *const result
size_t const result_count	throw ()
char *__cdecl	__acrt_getpath (char const *const delimited_paths, char *const result, size_t const result_count)
wchar_t *__cdecl	__acrt_wgetpath (wchar_t const *const delimited_paths, wchar_t *const result, size_t const result_count)

Function Documentation

__acrt_getpath()

char *__cdecl __acrt_getpath	(	char const *const	delimited_paths,
		char *const	result,
		size_t const	result_count
	)

Definition at line 143 of file getpath.cpp.

{
    return common_getpath(delimited_paths, result, result_count);
}

__acrt_wgetpath()

wchar_t *__cdecl __acrt_wgetpath	(	wchar_t const *const	delimited_paths,
		wchar_t *const	result,
		size_t const	result_count
	)

Definition at line 152 of file getpath.cpp.

{
    return common_getpath(delimited_paths, result, result_count);
}

_Out_writes_z_()

_Out_writes_z_

(

result_count

)

const

_Success_()

template<typename Character >

_Success_

(

return !

= 0

)

const

throw()

size_t const result_count throw

(

)

Definition at line 68 of file getpath.cpp.

{
    _VALIDATE_RETURN_NOEXC(result != nullptr, EINVAL, nullptr);
 
    if (result_count > 0)
    {
        result[0] = '\0';
    }
 
    _VALIDATE_RETURN_NOEXC(result_count > 1,  EINVAL, nullptr);
 
    Character const* source_it = delimited_paths;
 
    // Skip past any leading semicolons:
    while (*source_it == ';')
    {
        ++source_it;
    }
 
    Character const* const source_first = source_it;
 
    Character*       result_it   = result;
    Character* const result_last = result + result_count - 1; // Leave room for \0
 
#pragma warning(suppress:__WARNING_POTENTIAL_BUFFER_OVERFLOW_NULLTERMINATED) // 26018 Prefast is confused.
    while (*source_it != '\0' && *source_it != ';')
    {
        if (*source_it == '"')
        {
            // We found a quote; copy all characters until we reach the matching
            // end quote or the end of the string:
            ++source_it; // Advance past opening quote
 
            while (*source_it != '\0' && *source_it != '"')
            {
#pragma warning(suppress:__WARNING_POTENTIAL_BUFFER_OVERFLOW_HIGH_PRIORITY) // 26015 Prefast is confused.
                *result_it++ = *source_it++;
                if (result_it == result_last)
                {
                    *result_it = '\0';
                    errno = ERANGE;
                    return nullptr;
                }
            }
 
            if (*source_it != '\0')
            {
                ++source_it; // Advance past closing quote
            }
        }
        else
        {
            *result_it++ = *source_it++;
            if (result_it == result_last)
            {
                *result_it = '\0';
                errno = ERANGE;
                return nullptr;
            }
        }
    }
 
    // If we copied something and stopped because we reached a semicolon, skip
    // any semicolons before returning:
    while (*source_it == ';')
    {
        ++source_it;
    }
 
    *result_it = '\0';
    return source_it == source_first
        ? nullptr
        : const_cast<Character*>(source_it);
}