Manual Pages for UNIX Operating System command usage for man Tcl_GetCwd

Tcl Library Procedures                           Tcl_GetCwd(3TCL)



_________________________________________________________________

NAME
     Tcl_GetCwd,  Tcl_Chdir  -  manipulate  the  current  working
     directory

SYNOPSIS
     #include 

     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 Library Procedures                           Tcl_GetCwd(3TCL)



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


KEYWORDS
     pwd

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|__________________|_
    | Availability       |  runtime/tcl-8  |
    |____________________|__________________|_
    | Interface Stability|  Uncommitted    |
    |____________________|_________________|

NOTES
     Source for Tcl is available on http://opensolaris.org.


































Tcl                     Last change: 8.1                        2