.-
help for ^cvar^    					Version 5/5/97
.-
Programming utility.

Puts ^C^haracteristics of a ^VAR^iable in a new variable and macro's.

 ^cvar^ var [ ^,^ no^m^is ^n^am^(^string^) sel^ect^(^string^)^

Generates 

- an integer variable (if specified by ^select()^) ^`nam'^  with values
  1,2,3,.., corresponding to the ordered values of var, am. 

and 

- several global macro's 

^$`nam'`i'^ containing the value label of the i-th value of ^var^ (if existing). 
	If no value label is associated with (the i-th value of) ^var^ it will 
	contain the value itself. The label is embedded in double quotes " ",
	unless there is no value label associated with the variable ^var^.

^$v`nam'`i'^ containing the i-th value of ^var^.

^$n`nam'^ the number of different values of ^var^.

^$l`nam'^ the variable label of ^var^ if it exists, otherwise the name of ^var^.

^$f`nam'^ the display format in case ^var^ is not string or has no value label. 

^$w`nam'^ width required to display the $`nam'`i', i.e. max(length("$nam`i'")).

^var^ may be any type of variable.


^Options^
^-------^

[^no^]^mis^  If ^mis^ specified (default) the missing value of ^var^ (or empty 
	string) will be considered a separate class. If ^nomis^ is specified, 
	records with ^var^ missing will be ^deleted^! 

^nam()^ specifies the pre- or suffix `nam' for the macro's and the name of the
	variable that will be generated. ^`nam'^ should not start with an 
	underscore _, and may be maximum 5 characters long. If not, `nam' will
	be shortened and/or the underscore removed. If ^nam()^ is not specified
	it will be the first 4 characters of the name of ^var^, followed by 
	an underscore _. 

^select()^ offers the possibility to make a selection.
	If not specified: all macro's and the new variable will be created. 
	If specified macro's and variable will be created dependent on the 
	characters present in the string in ^select()^:
   v|V	           the variable `nam'. ^`nam'^ must be a new varname. 
   n|N|w|W|f|F 	   all the macro's 
   l|L		   the l`nam' macro
		

^Author:^
^-------^ 
	Wim van Putten
	Erasmus MC - Daniel den Hoed Cancer Center
	Rotterdam
	The Netherlands
	FAX: +31.10.4391028
	e-mail:	w.vanputten@@erasmusmc.nl 
