File and Path Function

char *_getdcwd(int drive, char *buffer, int maxlen);

wchar_t *_wgetdcwd(int drive, wchar_t *buffer, int maxlen);

TCHAR *_tgetdcwd(int drive, TCHAR *buffer, int maxlen);

Internationalization (I18n) Function Overview

The _getdcwd function copies an absolute pathname of the current working directory on the specified drive to the array pointed to by buffer, which is of maxlen byte size, and returns a pointer to the result.

buffer can be NULL, in which case, an array is allocated using malloc to store the path. This buffer can later be freed by calling free and passing it the _getdcwd return value (a pointer to the allocated buffer).

In the event of an error, NULL is returned, and the global error errno is set either to ENOMEM, indicating that there is insufficient memory to allocate maxlen bytes (when a NULL is given as buffer), or to ERANGE, indicating that the path (including the terminating null character) is longer than maxlen bytes.

_wgetdcwd is the wide version of the function; its string parameter and return are wide character strings, and maxlen is the size of buffer in wide characters, rather than single-byte characters.

_tgetdcwd is the Generic version of the function; with the _MBCS or _UNICODE compiler flags determining its mapping to either _getdcwd or _wgetdcwd.

I18n Issues

Use the appropriate version of the function as required for internationalization support, ensuring that maxlen is correct for the chosen platform. See Locale-Sensitive Length Functions for a discussion on single-byte and wide character sizes.

See Pathnames for a discussion of path and filename considerations in an internationalized application.

Recommended Replacements*

Microsoft Windows MBCS	_getdcwd
Microsoft Windows Unicode	_wgetdcwd
Microsoft Windows Generic	_tgetdcwd

File and Path Functions