*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> perl5/Symbol (3)              


Symbol(3)							     Symbol(3)

NAME    [Toc]    [Back]

     Symbol - manipulate Perl symbols and their	names

SYNOPSIS    [Toc]    [Back]

	 use Symbol;

	 $sym =	gensym;
	 open($sym, "filename");
	 $_ = <$sym>;
	 # etc.

	 ungensym $sym;	     # no effect

	 print qualify("x"), "\n";		# "Test::x"
	 print qualify("x", "FOO"), "\n"	# "FOO::x"
	 print qualify("BAR::x"), "\n";		# "BAR::x"
	 print qualify("BAR::x", "FOO"), "\n";	# "BAR::x"
	 print qualify("STDOUT", "FOO"), "\n";	# "main::STDOUT" (global)
	 print qualify(\*x), "\n";		# returns \*x
	 print qualify(\*x, "FOO"), "\n";	# returns \*x

	 use strict refs;
	 print { qualify_to_ref	$fh } "foo!\n";
	 $ref =	qualify_to_ref $name, $pkg;

DESCRIPTION    [Toc]    [Back]

     Symbol::gensym creates an anonymous glob and returns a reference to it.
     Such a glob reference can be used as a file or directory handle.

     For backward compatibility	with older implementations that	didn't support
     anonymous globs, Symbol::ungensym is also provided.  But it doesn't do

     Symbol::qualify turns unqualified symbol names into qualified variable
     names (e.g. "myvar" -> "MyPackage::myvar").  If it	is given a second
     parameter,	qualify	uses it	as the default package;	otherwise, it uses the
     package of	its caller.  Regardless, global	variable names (e.g. "STDOUT",
     "ENV", "SIG") are always qualfied with "main::".

     Qualification applies only	to symbol names	(strings).  References are
     left unchanged under the assumption that they are glob references,	which
     are qualified by their nature.

     Symbol::qualify_to_ref is just like Symbol::qualify except	that it
     returns a glob ref	rather than a symbol name, so you can use the result
     even if use strict	'refs' is in effect.

									Page 1

Symbol(3)							     Symbol(3)

									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
subs IRIX Perl pragma to predeclare sub names
vars IRIX Perl pragma to predeclare global variable names
file IRIX Manipulate file names and attributes
dcecp_cdsalias HP-UX A dcecp object that lets you manipulate cell names in CDS
perljp OpenBSD AEuEU,i Perl Y~YxYE `A^a`I`A Perl xIAx3|xOxex|x3x1/2! Perl 5.8.0 xexeicUni- _ codeYuYYi1/4YEx~AcEyxE...
optionalsym IRIX transform ELF symbols to optional symbols
MrmRegisterNames IRIX Registers the values associated with the names referenced in UIL (for example, UIL callback function names or
MrmRegisterNames HP-UX Registers the values associated with the names referenced in UIL (for example, UIL callback function names or
krb.realms Tru64 Contains configuration information that associates host names with realm names
c++filt NetBSD demangle C++ symbols
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service