Tcl_SetErrno


HOME

Tcl_SetErrno

NAME
SYNOPSIS
ARGUMENTS
DESCRIPTION
KEYWORDS

___________________________

NAME

Tcl_SetErrno, Tcl_GetErrno, Tcl_ErrnoId, Tcl_ErrnoMsg − manipulate errno to store and retrieve error codes

SYNOPSIS

#include <tcl.h>

void
Tcl_SetErrno
(errorCode)

int
Tcl_GetErrno
()

const char *
Tcl_ErrnoId
()

const char *
Tcl_ErrnoMsg
(errorCode)

ARGUMENTS

int errorCode (in)

A POSIX error code such as ENOENT.

______________

DESCRIPTION

Tcl_SetErrno and Tcl_GetErrno provide portable access to the errno variable, which is used to record a POSIX error code after system calls and other operations such as Tcl_Gets. These procedures are necessary because global variable accesses cannot be made across module boundaries on some platforms.

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

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

Tcl_ErrnoId and Tcl_ErrnoMsg return string representations of errno values. Tcl_ErrnoId returns a machine-readable textual identifier such as “EACCES” that corresponds to the current value of errno. Tcl_ErrnoMsg 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 Tcl_GetErrno. The strings returned by these functions are statically allocated and the caller must not free or modify them.

KEYWORDS

errno, error code, global variables



More Linux Commands

manpages/Apache::TestTrace.3pm.html
Apache::TestTrace(3pm) - Helper output generation functions
This module exports a number of functions that make it easier generating various diagnostics messages in your programs in a consistent way and saves some keystr

manpages/gs.1.html
gs(1) - Ghostscript (PostScript and PDF language interpreter
The gs (gswin32c, gswin32, gsos2) command invokes Ghostscript, an interpreter of Adobe Systems PostScript(tm) and Portable Document Format (PDF) languages. gs r

manpages/endutxent.3.html
endutxent(3) - access utmp file entries - Linux manual page
New applications should use the POSIX.1-specified utmpx versions of these functions; see CONFORMING TO. utmpname() sets the name of the utmp-format file for the

manpages/unflatten.1.html
unflatten(1) - adjust directed graphs to improve layout aspe
unflatten is a preprocessor to dot that is used to improve the aspect ratio of graphs having many leaves or disconnected nodes. The usual layout for such a grap

manpages/batcher.8.html
batcher(8) - Article batching for InterNetNews (Man Page)...
batcher reads a list of files and prepares news batches for the specified host. It is generally used to prepare UUCP feeds, but the resulting batches can be use

manpages/pam_misc_paste_env.3.html
pam_misc_paste_env(3) - transcribing an environment to that
This function takes the supplied list of environment pointers and uploads its contents to the PAM environment. Success is indicated by PAM_SUCCESS. SEE ALSO pam

manpages/pluginviewer.8.html
pluginviewer(8) - list loadable SASL plugins and their prope
pluginviewer can be used by a server administrator to troubleshoot SASL installations. The utility can list loadable (properly configured) client and server sid

manpages/libsensors.3.html
libsensors(3) - publicly accessible functions provided by th
sensors_init() loads the configuration file and the detected chips list. If this returns a value unequal to zero, you are in trouble; you can not assume anythin

manpages/auto_execok.n.html
auto_execok(n) - standard library of Tcl procedures.........
Tcl includes a library of Tcl procedures for commonly-needed functions. The procedures defined in the Tcl library are generic ones suitable for use by many diff

manpages/makeg.1.html
makeg(1) - make a debuggable executable - Linux manual page
The makeg script runs make, passing it variable settings to create a debuggable target when used with a Makefile generated by imake. For example, it arranges fo

manpages/sgi2tiff.1.html
sgi2tiff(1) create a TIFF file from an SGI image file.......
sgi2tiff converts a file in the SGI image format to TIFF. By default, the TIFF image is created with data samples packed (PlanarConfiguration=1), compressed wit

manpages/pamdice.1.html
pamdice(1) - slice a Netpbm image into many horizontally and
This program is part of Netpbm(1) pamdice reads a PAM, PBM, PGM, or PPM image as input and splits it horizontally and/or vertically into equal size pieces and w





We can't live, work or learn in freedom unless the software we use is free.