TclSetErrno(3) Tcl Library Procedures TclSetErrno(3)

NAME
       TclSetErrno,  TclGetErrno,  TclErrnoId,  TclErrnoMsg  -  manipulate
       errno to store and retrieve error codes

SYNOPSIS
       ##iinncclluuddee <>

       void
       TTccllSSeettEErrrrnnoo(errorCode)

       int
       TTccllGGeettEErrrrnnoo()

       CONST char *
       TTccllEErrrrnnooIIdd()

       CONST char *
       TTccllEErrrrnnooMMssgg(errorCode)


AARRGGUUMMEENNTTSS
       int   errorCode   (in)      A POSIX error code such as EENNOOEENNTT.



DESCRIPTION
       TTccllSSeettEErrrrnnoo and TTccllGGeettEErrrrnnoo provide  portable  access  to  the  eerrrrnnoo
       variable, which is used to record a POSIX error code after system calls
       and other operations such as TTccllGGeettss.  These procedures are  necessary
       because  global  variable  accesses cannot be made across module bound-
       aries on some platforms.

       TTccllSSeettEErrrrnnoo sets the eerrrrnnoo variable to  the  value  of  the  errorCode
       argument  C  procedures  that wish to return error information to their
       callers via eerrrrnnoo should call TTccllSSeettEErrrrnnoo rather  than  setting  eerrrrnnoo
       directly.

       TTccllGGeettEErrrrnnoo returns the current value of eerrrrnnoo.  Procedures wishing to
       access eerrrrnnoo should call this  procedure  instead  of  accessing  eerrrrnnoo
       directly.

       TTccllEErrrrnnooIIdd  and  TTccllEErrrrnnooMMssgg  return  string representations of eerrrrnnoo
       values.  TTccllEErrrrnnooIIdd returns a machine-readable textual identifier such
       as   "EACCES"   that   corresponds  to  the  current  value  of  eerrrrnnoo.
       TTccllEErrrrnnooMMssgg  returns  a  human-readable  string  such  as  "permission
       denied"  that  corresponds to the value of its errorCode argument.  The
       errorCode argument is typically the  value  returned  by  TTccllGGeettEErrrrnnoo.
       The  strings  returned  by these functions are statically allocated and
       the caller must not free or modify them.


KKEEYYWWOORRDDSS
       errno, error code, global variables



Tcl                                   8.3                      TclSetErrno(3)