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

Synopsis:
    #include <direct.h>
    char *getcwd( char *buffer, int 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 buff is  PATH_MAX + 1 bytes.

    Extension:  When buffer has a value of NULL, a string is allocated to
    contain the name of the current working directory.  This string may be
    freed using the  free function.

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.

    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.


See Also:
    chdir, mkdir, rmdir

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:
    POSIX 1003.1 with extensions

Systems:
    All