c_cpp/etc/calc/help/strerror

   1 NAME
   2     strerror - returns a string describing an error value
   3
   4 SYNOPSIS
   5     strerror([x])
   6
   7 TYPES
   8     x           error-value or integer in [0, 32767], defaults to errno()
   9
  10     return      string
  11
  12 DESCRIPTION
  13     If x is the error-value with index n, strerror(x) and strerror(n)
  14     return one of:
  15
  16                 a system-generated message,
  17                 a calc-generated description,
  18                 a user-defined description created by newerror(str),
  19                 the string "Error n",
  20
  21     where, in the last form, n is represented decimally.
  22
  23 EXAMPLE
  24     System error messages may be different for different systems.
  25     ; errmax(errcount()+3)
  26             0
  27     ; strerror(2)
  28         "No such file or directory"
  29
  30     ; x = 3 * ("a" + "b")
  31     ; print strerror(x)
  32     Bad arguments for +
  33
  34     ; a = newerror("alpha")
  35     ; print strerror(a)
  36     alpha
  37
  38     ; print strerror(999)
  39     Error 999
  40
  41     ; a = 1/0
  42     ; print strerror()
  43     Division by zero
  44
  45 LIMITS
  46     none
  47
  48 LINK LIBRARY
  49     none
  50
  51 SEE ALSO
  52     strcat, strcpy, strlen, strncmp, strncpy, strpos,
  53     strprintf, strscan, strscanf, substr,
  54
  55     errcount, errmax, error, iserror, errno, newerror, errorcodes,
  56     stoponerror
  57
  58 ## Copyright (C) 1999-2006  Landon Curt Noll
  59 ##
  60 ## Calc is open software; you can redistribute it and/or modify it under
  61 ## the terms of the version 2.1 of the GNU Lesser General Public License
  62 ## as published by the Free Software Foundation.
  63 ##
  64 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  65 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  66 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  67 ## Public License for more details.
  68 ##
  69 ## A copy of version 2.1 of the GNU Lesser General Public License is
  70 ## distributed with calc under the filename COPYING-LGPL.  You should have
  71 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  72 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  73 ##
  74 ## @(#) $Revision: 30.1 $
  75 ## @(#) $Id: strerror,v 30.1 2007/03/16 11:10:42 chongo Exp $
  76 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/strerror,v $
  77 ##
  78 ## Under source code control:   1996/04/30 03:05:18
  79 ## File existed as early as:    1996
  80 ##
  81 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  82 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/