Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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  eventually  call
					    Tcl_DStringFree  to	 free  up any-
					    thing stored here.

       char *path (in)			    File path in UTF-8 format.
______________________________________________________________________________

DESCRIPTION
       These procedures	may be used to manipulate the current  working	direc-
       tory  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	direc-
       tory,  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  string  must  be
       UTF-8.  The function returns -1 on error	or 0 on	success.

KEYWORDS
       pwd

Tcl				      8.1			 Tcl_GetCwd(3)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | KEYWORDS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Tcl_Chdir.tcl86&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help