home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_progs / prog_c / edlib.lzh / EDLIB / MAN / GETCWD < prev    next >
Encoding:
Text File  |  1991-08-16  |  1.1 KB  |  41 lines
  1. GETCWD(3)                  Library Functions                 GETCWD(3)
  2.  
  3.  
  4.  
  5. NAME
  6.      getcwd - get the name of the current working directory
  7.  
  8. SYNOPSIS
  9.      #include <edlib.h>
  10.  
  11.      char *getcwd(buffer,size)
  12.      char *buffer;
  13.      int size;
  14.  
  15. DESCRIPTION
  16.      Getcwd gets the name of the current working directory and puts
  17.      the string formed in the area pointed to by buffer. Buffer is
  18.      assumed to be at least size bytes long. If buffer is a null
  19.      pointer, then getcwd will allocate size bytes, which should
  20.      later be freed using the Manx free() function. In both cases,
  21.      getcwd returns a pointer to the first character in buffer.
  22.  
  23.      Note that getcwd will only give volume labels, and not device
  24.      specifications, when constructing a directory name. Thus, if
  25.      you are in the standard AmigaDOS recoverable ram disk, getcwd
  26.      will return "RAMB0:" as the current working directory.
  27.  
  28. DIAGNOSTICS
  29.      If the current working directory cannot be determined, a null
  30.      pointer is returned and any memory allocated (because the
  31.      buffer parameter is null) is freed.
  32.  
  33. AUTHOR
  34.      Edwin Hoogerbeets 20/03/89
  35.  
  36. SEE ALSO
  37.      chdir(3)
  38.  
  39.  
  40.  
  41.