Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   4347 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

unset(n)		     Tcl Built-In Commands		      unset(n)

______________________________________________________________________________

NAME
       unset - Delete variables

SYNOPSIS
       unset ?-nocomplain? ?--? ?name name name ...?
_________________________________________________________________

DESCRIPTION
       This  command  removes  one or more variables.  Each name is a variable
       name, specified in any of the ways acceptable to the set command.  If a
       name  refers  to	 an  element  of an array then that element is removed
       without affecting the rest of the array.	 If  a	name  consists	of  an
       array  name  with  no  parenthesized  index,  then  the entire array is
       deleted.	 The unset command returns an  empty  string  as  result.   If │
       -nocomplain is specified as the first argument, any possible errors are │
       suppressed.  The option may not be  abbreviated,	 in  order  to	disam‐ │
       biguate	it  from possible variable names.  The option -- indicates the │
       end of the options, and should be used if you wish to remove a variable │
       with  the  same	name  as  any of the options.  If an error occurs, any
       variables after the named one causing the error not deleted.  An	 error
       can  occur when the named variable doesn't exist, or the name refers to
       an array element but the variable is a scalar, or the name refers to  a
       variable in a non-existent namespace.

EXAMPLE
       Create an array containing a mapping from some numbers to their squares
       and remove the array elements for non-prime numbers:
	      array set squares {
		  1 1	 6 36
		  2 4	 7 49
		  3 9	 8 64
		  4 16	 9 81
		  5 25	10 100
	      }

	      puts "The squares are:"
	      parray squares

	      unset squares(1) squares(4) squares(6)
	      unset squares(8) squares(9) squares(10)

	      puts "The prime squares are:"
	      parray squares

SEE ALSO
       set(n), trace(n), upvar(n)

KEYWORDS
       remove, variable

Tcl				      8.4			      unset(n)

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 

Vote for polarhome