Files
calc/help/name
2017-05-21 15:38:47 -07:00

66 lines
1.8 KiB
Plaintext

NAME
name - return name of some kinds of structure
SYNOPSIS
name(val)
TYPES
val any
return string or null value
DESCRIPTION
If val is a named block or open file stream, name(val) returns the
name associated with val. Otherwise the null value is returned.
Since the name associated with a file stream is that used when the stream
was opened, different names may refer to the same file, e.g. "foo"
and "./foo".
EXAMPLE
; A = blk("alpha");
; name(A)
"alpha"
; f = fopen("/tmp/beta", "w")
; name(f)
"/tmp/beta"
; names(files(0))
"(stdin)"
LIMITS
none
LINK LIBRARY
none
SEE ALSO
blk, fopen
## Copyright (C) 1999-2006 Landon Curt Noll
##
## Calc is open software; you can redistribute it and/or modify it under
## the terms of the version 2.1 of the GNU Lesser General Public License
## as published by the Free Software Foundation.
##
## Calc is distributed in the hope that it will be useful, but WITHOUT
## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
## or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
## Public License for more details.
##
## A copy of version 2.1 of the GNU Lesser General Public License is
## distributed with calc under the filename COPYING-LGPL. You should have
## received a copy with calc; if not, write to Free Software Foundation, Inc.
## 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
##
## @(#) $Revision: 29.4 $
## @(#) $Id: name,v 29.4 2006/06/25 22:16:55 chongo Exp $
## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/name,v $
##
## Under source code control: 1997/04/05 14:12:44
## File existed as early as: 1997
##
## chongo <was here> /\oo/\ http://www.isthe.com/chongo/
## Share and enjoy! :-) http://www.isthe.com/chongo/tech/comp/calc/