C++ Syntax

void

MKI_MakePathW(

LPWSTR f_pszDestin,

const size_t f_unMaxSize,

LPCWSTR f_pszDrive,

LPCWSTR f_pszPath,

LPCWTSTR f_pszFile,

LPCWSTR f_pszExt );

template <size_t f_unSize> void

MKI_MakePathW(

wchar_t (&f_rDestin)[f_unSize],

LPCWSTR f_pszDrive,

LPCWSTR f_pszPath,

LPCWSTR f_pszFile,

LPCWSTR f_pszExt );

Assembles a UTF-16 filename from its components.

Parameters

f_pszDestin / f_rDestin

[LPWSTR] Pointer to or [wchar_t[]&] Reference to destination text.

f_unMaxSize

[const size_t] Maximum allowed length of the destination text in UTF-16 characters including the terminating '\0' character.

f_pszDrive

[LPWSTR] Drive of the filename (e.g. "A:" or "C"). A colon will automatically be added, if necessary. May be nullptr.

f_pszPath

[LPWSTR] Folder sequence of the filename (e.g. "Drawing\Project A"). A starting and ending backslash will automatically be added, if necessary. May be nullptr.

f_pszFile

[LPWSTR] Base name of the filename (e.g. "Plan B"). May be nullptr.

f_pszExt

[LPWSTR] Extension of the filename (e.g. ".mkd" or "dxf"). A point will be added, if necessary. May be nullptr.

Comment

It is guaranteed that the resulting text will always be terminated with a '\0' character!