fullpath.cpp File Reference

#include <stdio.h>
#include <direct.h>
#include <errno.h>
#include <stdlib.h>
#include <corecrt_internal_traits.h>
#include <windows.h>

Include dependency graph for fullpath.cpp:

Go to the source code of this file.

Functions
template<typename Character >
	_Success_ (return !=0) static Character *__cdecl common_fullpath(_Out_writes_z_(max_count) Character *const user_buffer
Character const *const size_t const int const char const *const int const line_number	throw ()
char *__cdecl	_fullpath (char *const user_buffer, char const *const path, size_t const max_count)
wchar_t *__cdecl	_wfullpath (wchar_t *const user_buffer, wchar_t const *const path, size_t const max_count)

Variables
Character const *const	path
Character const *const size_t const	max_count
Character const *const size_t const int const	block_use
Character const *const size_t const int const char const *const	file_name

Function Documentation

_fullpath()

char *__cdecl _fullpath	(	char *const	user_buffer,
		char const *const	path,
		size_t const	max_count
	)

Definition at line 106 of file fullpath.cpp.

{
    return common_fullpath(user_buffer, path, max_count, _NORMAL_BLOCK, nullptr, 0);
}

_Success_()

template<typename Character >

_Success_

(

return !

= 0

)

const

_wfullpath()

wchar_t *__cdecl _wfullpath	(	wchar_t *const	user_buffer,
		wchar_t const *const	path,
		size_t const	max_count
	)

Definition at line 115 of file fullpath.cpp.

{
    return common_fullpath(user_buffer, path, max_count, _NORMAL_BLOCK, nullptr, 0);
}

throw()

Character const *const size_t const int const char const *const int const line_number throw

(

)

Definition at line 70 of file fullpath.cpp.

{
    // These are referenced only in the Debug CRT build
    UNREFERENCED_PARAMETER(block_use);
    UNREFERENCED_PARAMETER(file_name);
    UNREFERENCED_PARAMETER(line_number);
 
    typedef __crt_char_traits<Character> traits;
 
    // If the path is empty, we have no work to do:
    if (path == nullptr || path[0] == '\0')
    {
#pragma warning(suppress:__WARNING_POSTCONDITION_NULLTERMINATION_VIOLATION) // 26036 Prefast does not understand perfect forwarding.
        return traits::tgetcwd(user_buffer, static_cast<int>(__min(max_count, INT_MAX)));
    }
 
    if (user_buffer != nullptr) {
        // Using user buffer. Fail if not enough space.
        __crt_no_alloc_win32_buffer<Character> buffer(user_buffer, max_count);
        if (!traits::get_full_path_name(path, buffer)) {
            return user_buffer;
        } else {
            return nullptr;
        }
    } else {
        // Always new memory suitable for debug mode and releasing to the user.
        __crt_public_win32_buffer<Character> buffer(
            __crt_win32_buffer_debug_info(block_use, file_name, line_number)
            );
        traits::get_full_path_name(path, buffer);
        return buffer.detach();
    }
}

Variable Documentation

block_use

Character const* const size_t const int const block_use

Definition at line 67 of file fullpath.cpp.

Referenced by throw().

file_name

Character const* const size_t const int const char const* const file_name

Definition at line 68 of file fullpath.cpp.

Referenced by throw().

max_count

Character const* const size_t const max_count

Definition at line 66 of file fullpath.cpp.

Referenced by _fullpath(), _mblen_internal(), _mblen_l(), _wfullpath(), ComputeConformanceOrVariance(), CreateSyntheticPointerDevice(), DATETIME_GetFieldWidth(), __crt_stdio_output::formatting_buffer::ensure_buffer_is_big_enough(), mblen(), NdrComplexStructBufferSize(), NdrComplexStructMarshall(), NdrComplexStructMemorySize(), NdrComplexStructUnmarshall(), scan_tree(), send_tree(), taskdialog_add_buttons(), and throw().

path

Character const* const path

Definition at line 65 of file fullpath.cpp.