_________________________________________________________________
NAME
Tcl_TildeSubst - replace tilde with home directory in a file name
SYNOPSIS
#include <tcl.h>
char *
Tcl_TildeSubst(interp, name, bufferPtr)
ARGUMENTS
Tcl_Interp *interp (in) Interpreter in which to report an error, if any.
If Tcl_TildeSubst has to do tilde substitution then it uses the dynamic string at *bufferPtr to hold the new string it generates. After Tcl_TildeSubst returns, the caller must eventually invoke Tcl_DStringFree to free up any information placed in *bufferPtr. The caller need not know whether or not Tcl_TildeSubst actually used the string; Tcl_TildeSubst initializes *bufferPtr even if it doesn't use it, so the call to Tcl_DStringFree will be safe in either case.
If an error occurs (e.g. because there was no user by the given name) then NULL is returned and an error message will be left at interp->result. It is assumed that interp->result has been initialized in the standard way when Tcl_TildeSubst is invoked.
KEYWORDS
file name, home directory, tilde, user