home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD2.mdf / c / library / dos / directry / fullpath / fullpath.doc < prev   
Encoding:
Text File  |  1986-06-04  |  1.3 KB  |  51 lines
  1. NAME
  2.  
  3.     fullpath - expand file-name to full description
  4.  
  5.  
  6. SYNOPSIS
  7.  
  8.     char *fullpath(char *)
  9.  
  10.  
  11. NOTE
  12.  
  13.     All uses of back-slash is really refering to "extern char _SLASH",
  14.     the directory separator character.
  15.  
  16.  
  17. DESCRIPTION
  18.  
  19.     Fullpath takes one parameter, and expands it as if it were a path-name.
  20.     All . and .. are delt with properly, and \.. will be assumed to be \,
  21.     as on UNIX systems.
  22.     The returning string (which is a static pointer, so when function is
  23.     called multiple times it's overwritten each time) is of the format:
  24.  
  25.         <drive>:\<directory-path><file-name>
  26.  
  27.     and is in lower case.
  28.     If drive is not given default is inserted. If path is not from root
  29.     then current directory is preceeded.
  30.  
  31.  
  32. SPECIAL CASES
  33.  
  34.     NULL passed returns NULL.
  35.     Multiple back-slashes are reduced to one.
  36.     Trailing back-slashes are erased (except for root).
  37.  
  38.     
  39. EXAMPLES
  40.  
  41.     Assuming current drive C, current directory \a\b. And drive A: has
  42.     current directory \m
  43.  
  44.         x                       c:\a\b\x
  45.         ..\d\x                  c:\a\d\x
  46.         .                       c:\a\b
  47.         ..                      c:\a
  48.         ..\..\..\..             c:\
  49.         a:q\x                   a:\m\q\x
  50.         b:\x\y\.\z\..           b:\x\y
  51.