Click above to get retro games delivered to your door ever month!

Synopsis:
    #include <direct.h>
    char *getcwd( char *buffer, size_t size );
    wchar_t *_wgetcwd( wchar_t *buffer, size_t size );

Description:
    The getcwd function returns the name of the current working directory.
     The buffer address is either NULL or is the location at which a string
    containing the name of the current working directory is placed.  In the
    latter case, the value of size is the length (including the delimiting
    '\0' character) which can be be used to store this name.

    The maximum size that might be required for buffer is  PATH_MAX + 1
    bytes.

    Extension:  When buffer has a value of NULL, a string is allocated using
     malloc to contain the name of the current working directory.  This
    string may be freed using the  free function.  The _wgetcwd function is
    identical to getcwd except that it returns the name of the current
    working directory as a wide-character string (which is twice as long).

Returns:
    The getcwd function returns the address of the string containing the
    name of the current working directory, unless an error occurs, in which
    case NULL is returned.

Errors:
    When an error has occurred,  errno contains a value indicating the type
    of error that has been detected.

    Constant     Meaning

EINVAL
    The argument size is negative.

ENOMEM
    Not enough memory to allocate a buffer.

ERANGE
    The buffer is too small (specified by size) to contain the name of the
    current working directory.


Example:
    #include <stdio.h>
    #include <stdlib.h>
    #include <direct.h>

    void main()
      {
        char *cwd;

        cwd = getcwd( NULL, 0 );
        if( cwd != NULL ) {
          printf( "My working directory is %s\n", cwd );
          free( cwd );
        }
      }

    produces the following:

    My working directory is C:\PROJECT\C

Classification:
    getcwd is POSIX 1003.1 with extensions, _wgetcwd is not POSIX

Systems:
     getcwd - All, Netware

    _wgetcwd - DOS, Windows, Win386, Win32, OS/2 1.x(all), OS/2-32

See Also:
    chdir, chmod, _getdcwd, mkdir, rmdir