c_cpp/etc/calc/help/name

   1 NAME
   2     name - return name of some kinds of structure
   3
   4 SYNOPSIS
   5     name(val)
   6
   7 TYPES
   8     val         any
   9
  10     return      string or null value
  11
  12 DESCRIPTION
  13     If val is a named block or open file stream, name(val) returns the
  14     name associated with val.  Otherwise the null value is returned.
  15
  16     Since the name associated with a file stream is that used when the stream
  17     was opened, different names may refer to the same file, e.g. "foo"
  18     and "./foo".
  19
  20 EXAMPLE
  21     ; A = blk("alpha");
  22     ; name(A)
  23         "alpha"
  24
  25     ; f = fopen("/tmp/beta", "w")
  26     ; name(f)
  27         "/tmp/beta"
  28
  29     ; name(files(0))
  30         "(stdin)"
  31
  32 LIMITS
  33     none
  34
  35 LINK LIBRARY
  36     none
  37
  38 SEE ALSO
  39     blk, fopen
  40
  41 ## Copyright (C) 1999-2006  Landon Curt Noll
  42 ##
  43 ## Calc is open software; you can redistribute it and/or modify it under
  44 ## the terms of the version 2.1 of the GNU Lesser General Public License
  45 ## as published by the Free Software Foundation.
  46 ##
  47 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  48 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  49 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  50 ## Public License for more details.
  51 ##
  52 ## A copy of version 2.1 of the GNU Lesser General Public License is
  53 ## distributed with calc under the filename COPYING-LGPL.  You should have
  54 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  55 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  56 ##
  57 ## @(#) $Revision: 30.1 $
  58 ## @(#) $Id: name,v 30.1 2007/03/16 11:10:42 chongo Exp $
  59 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/name,v $
  60 ##
  61 ## Under source code control:   1997/04/05 14:12:44
  62 ## File existed as early as:    1997
  63 ##
  64 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  65 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/