c_cpp/etc/calc/help/estr

   1 NAME
   2     estr - represent some types of value by text strings
   3
   4 SYNOPSIS
   5     estr(x)
   6
   7 TYPES
   8     x           null, string, real or complex number, list, matrix,
   9                 object. block, named block, error
  10
  11     return      string
  12
  13 DESCRIPTION
  14     This function attempts to represent x exactly by a string s of
  15     ordinary text characters such that eval(s) == x.
  16
  17     If x is null, estr(x) returns the string "".
  18
  19     If x is a string, estr(x) returns the string in which occurrences of
  20     newline, tab, ", \,  etc. have been converted to \n, \t, \",
  21     \\, etc., '\0' to \000 or \0 according as the next character is
  22     or is not an octal digit, and other non-text characters to their
  23     escaped hex representation, e.g. char(165) becomes \xa5.
  24
  25     For real x, estr(x) represebts x in fractional mode.
  26
  27
  28 EXAMPLE
  29     ; estr("abc\0xyz\00023\n\xa5\r\n")
  30         ""abc\0xyz\00023\n\xa5\r\n""
  31     ; estr(1.67)
  32         "167/100"
  33     ; estr(mat[3] = {2, list(3,5), "abc"})
  34         "mat[3]={2,list(3,5),"abc""
  35
  36 LIMITS
  37     none
  38
  39 LINK LIBRARY
  40     none
  41
  42 SEE ALSO
  43     str, strprintf
  44
  45 ## Copyright (C) 2006  Ernest Bowen
  46 ##
  47 ## Calc is open software; you can redistribute it and/or modify it under
  48 ## the terms of the version 2.1 of the GNU Lesser General Public License
  49 ## as published by the Free Software Foundation.
  50 ##
  51 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  52 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  53 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  54 ## Public License for more details.
  55 ##
  56 ## A copy of version 2.1 of the GNU Lesser General Public License is
  57 ## distributed with calc under the filename COPYING-LGPL.  You should have
  58 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  59 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  60 ##
  61 ## @(#) $Revision: 30.1 $
  62 ## @(#) $Id: estr,v 30.1 2007/03/16 11:10:42 chongo Exp $
  63 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/estr,v $
  64 ##
  65 ## Under source code control:   2006/08/20 14:45:13
  66 ## File existed as early as:    2006
  67 ##
  68 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  69 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/