Tcl_GetCwd(3tcl)

Tcl_GetCwd(3)        Tcl Library Procedures         Tcl_GetCwd(3)

_________________________________________________________________

NAME

     Tcl_GetCwd,  Tcl_Chdir  -  manipulate  the  current  working
     directory

SYNOPSIS

     #include <tcl.h>

     char *
     Tcl_GetCwd(interp, bufferPtr)

     int
     Tcl_Chdir(path)

ARGUMENTS

     Tcl_Interp *interp (in)              Interpreter in which to
                                          report   an  error,  if
                                          any.

     Tcl_DString *bufferPtr (in/out)      This dynamic string  is
                                          used   to   store   the
                                          current working  direc-
                                          tory.   At  the time of
                                          the call it  should  be
                                          uninitialized  or free.
                                          The caller must eventu-
                                          ally               call
                                          Tcl_DStringFree to free
                                          up    anything   stored
                                          here.

     char *path (in)                      File path in UTF-8 for-
                                          mat.
_________________________________________________________________

DESCRIPTION

     These procedures may be used to manipulate the current work-
     ing  directory  for  the  application.  They provide C-level
     access to the same functionality as the Tcl pwd command.

     Tcl_GetCwd returns a pointer  to  a  string  specifying  the
     current  directory,  or  NULL if the current directory could
     not be determined.  If NULL is returned, an error message is
     left  in the interp's result.  Storage for the result string
     is  allocated   in   bufferPtr;   the   caller   must   call
     Tcl_DStringFree()  when the result is no longer needed.  The
     format of the path is UTF-8.

     Tcl_Chdir changes the applications current working directory
     to the value specified in path.  The format of the passed in

Tcl                     Last change: 8.1                        1

Tcl_GetCwd(3)        Tcl Library Procedures         Tcl_GetCwd(3)

     string must be UTF-8.  The function returns -1 on error or 0
     on success.

KEYWORDS

     pwd

Tcl                     Last change: 8.1                        2