C++ Syntax

void

MKI_MakePathA(

LPSTR f_pszDestin,

const size_t f_unMaxSize,

LPCSTR f_pszDrive,

LPCSTR f_pszPath,

LPCSTR f_pszFile,

LPCSTR f_pszExt );

template <size_t f_unSize> void

MKI_MakePathA(

char (&f_rDestin)[f_unSize],

LPCSTR f_pszDrive,

LPCSTR f_pszPath,

LPCSTR f_pszFile,

LPCSTR f_pszExt );

Assembles an Ansi or UTF-8 filename from its components.

Parameters

f_pszDestin / f_Destin

[LPSTR] Pointer to or [char[]&] Reference to destination text.

f_unMaxSize

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

f_pszDrive

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

f_pszPath

[LPSTR] 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

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

f_pszExt

[LPSTR] 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!