home *** CD-ROM | disk | FTP | other *** search
/ Power CD-ROM!! 7 / POWERCD7.ISO / prgmming / clipper / chdir.c < prev    next >
C/C++ Source or Header  |  1993-10-14  |  1KB  |  64 lines
  1. /*
  2.  * File......: CHDIR.C
  3.  * Author....: Dave Pearson
  4.  * BBS.......: The Dark Knight Returns
  5.  * Net/Node..: 050/069
  6.  * User Name.: Dave Pearson
  7.  * Date......: $Date$
  8.  * Revision..: $Revision$
  9.  * Log file..: $Logfile$
  10.  *
  11.  * This is an original work by Dave Pearson and is placed in the public
  12.  * domain.
  13.  *
  14.  * Modification history:
  15.  * ---------------------
  16.  *
  17.  * $Log$
  18.  *
  19.  */
  20.  
  21. // NOTE: This code has been written for and compiled with Borland C++
  22. //       Version 3.1
  23. //
  24.  
  25. #include <extend.h>
  26. #include "internal.h"
  27.  
  28. /*  $DOC$
  29.  *  $FUNCNAME$
  30.  *      GT_CHDIR()
  31.  *  $CATEGORY$
  32.  *      Disk Drive
  33.  *  $ONELINER$
  34.  *      Change the current directory.
  35.  *  $SYNTAX$
  36.  *      GT_ChDir(<cDir>,[@<nError>]) --> lChanged
  37.  *  $ARGUMENTS$
  38.  *      <cDir> is the path of the directory.
  39.  *
  40.  *      <nError> is an optional parameter that must be passed by reference.
  41.  *      If the directory change fails the DOS error code will be placed in
  42.  *      this variable.
  43.  *  $RETURNS$
  44.  *      If the change was made, GT_ChDir() returns true (.T.), if not it
  45.  *      returns false (.F.).
  46.  *  $DESCRIPTION$
  47.  *      GT_ChDir() can be used to change the current directory.
  48.  *  $EXAMPLES$
  49.  *      // Change directory.
  50.  *
  51.  *      nError := 0
  52.  *      if !GT_ChDir("Knight",@nError)
  53.  *         ? "Error =",nError
  54.  *      endif
  55.  *  $SEEALSO$
  56.  *      GT_MKDIR() GT_RMDIR()
  57.  *  $END$
  58.  */
  59.  
  60. CLIPPER GT_ChDir()
  61. {
  62.         _GT_Internal_Directory(0x3B);
  63. }
  64.