SetErrno.3
上传用户:rrhhcc
上传日期:2015-12-11
资源大小:54129k
文件大小:2k
源码类别:

通讯编程

开发平台:

Visual C++

  1. '"
  2. '" Copyright (c) 1996 Sun Microsystems, Inc.
  3. '"
  4. '" See the file "license.terms" for information on usage and redistribution
  5. '" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
  6. '" 
  7. '" RCS: @(#) $Id: SetErrno.3,v 1.5 2002/01/15 21:47:27 dgp Exp $
  8. .so man.macros
  9. .TH Tcl_SetErrno 3 8.3 Tcl "Tcl Library Procedures"
  10. .BS
  11. .SH NAME
  12. Tcl_SetErrno, Tcl_GetErrno, Tcl_ErrnoId, Tcl_ErrnoMsg - manipulate errno to store and retrieve error codes
  13. .SH SYNOPSIS
  14. .nf
  15. fB#include <tcl.h>fR
  16. .sp
  17. void
  18. fBTcl_SetErrnofR(fIerrorCodefR)
  19. .sp
  20. int
  21. fBTcl_GetErrnofR()
  22. .sp
  23. CONST char *
  24. fBTcl_ErrnoIdfR()
  25. .sp
  26. CONST char *
  27. fBTcl_ErrnoMsgfR(fIerrorCodefR)
  28. .sp
  29. .SH ARGUMENTS
  30. .AS int errorCode in
  31. .AP int errorCode in
  32. A POSIX error code such as fBENOENTfR.
  33. .BE
  34. .SH DESCRIPTION
  35. .PP
  36. fBTcl_SetErrnofR and fBTcl_GetErrnofR provide portable access
  37. to the fBerrnofR variable, which is used to record a POSIX error
  38. code after system calls and other operations such as fBTcl_GetsfR.
  39. These procedures are necessary because global variable accesses cannot
  40. be made across module boundaries on some platforms.
  41. .PP
  42. fBTcl_SetErrnofR sets the fBerrnofR variable to the value of the
  43. fIerrorCodefR argument
  44. C procedures that wish to return error information to their callers
  45. via fBerrnofR should call fBTcl_SetErrnofR rather than setting
  46. fBerrnofR directly.
  47. .PP
  48. fBTcl_GetErrnofR returns the current value of fBerrnofR.
  49. Procedures wishing to access fBerrnofR should call this procedure
  50. instead of accessing fBerrnofR directly.
  51. .PP
  52. fBTcl_ErrnoIdfR and fBTcl_ErrnoMsgfR return string
  53. representations of fBerrnofR values.  fBTcl_ErrnoIdfR
  54. returns a machine-readable textual identifier such as
  55. "EACCES" that corresponds to the current value of fBerrnofR.
  56. fBTcl_ErrnoMsgfR returns a human-readable string such as
  57. "permission denied" that corresponds to the value of its
  58. fIerrorCodefR argument.  The fIerrorCodefR argument is
  59. typically the value returned by fBTcl_GetErrnofR.
  60. The strings returned by these functions are
  61. statically allocated and the caller must not free or modify them.
  62. .SH KEYWORDS
  63. errno, error code, global variables