function copies the absolute pathname of the current working directory
into the memory referenced by
and returns a pointer to
argument is the size, in bytes, of the array referenced by
space is allocated as necessary to store the pathname.
This space may later be
is a compatibility routine which calls
argument and a size of
(as defined in the include
should be at least
bytes in length.
These routines have traditionally been used by programs to save the
name of a working directory for the purpose of returning to it.
A much faster and less error-prone method of accomplishing this is to
open the current directory
and use the
function to return.