Command
	chen

Purpose
	Editor - Character enumerator or counter

Aliases
	charenumerator, charenum, chen

Syntax
	chen [ <options> ] <input_string>

Options
	-n	Count non-printable characters. Without this option,
		non-printable characters are not considered.

Arguments
	<input_string>
		The input string on which this command will operate. It
		can be specified as a str constant or str variable or an
		expression resulting in a str value.

		If a str constant is used, we highly recommend using
		double quotes around it, such as "John Doe".
		Without the double quotes, the spaces in the input string
		may produce errors or erroneous output.
		

Stream Input	
	Stream input is ignored.

Stream Output
	The number of characters found are written here.

Stream Error
	Any errors are listed here.

Description
	The command enumerates (or counts) characters in the <input_string> and
	writes the count to the stream output or redirected output target.

	The command CAN ALSO BE USED WITH FILES. Simply read in the contents
	of the file using the repro command into a str variable, then use that
	str variable as <input_string>.

		
Restrictions
	None.

Valid Examples
	Assume that you want to count characters in a file myfile.js.

	var str content
	repro myfile.js >$content
	chen -n $content

	The above code will produce the number of all characters
	(including nonprintable characters) in file myfile.js.

	To count just the printable characters, do NOT use the -n option, as follows.

	chen $content
	
Invalid Examples

	chen "myfile.js"

	Will produce 9. That's because myfile.js will be taken verbatim as
	<input_string>, and there are 9 characters in that string.

	chen { repro myfile.js }

	Will also produce erroneous results. The inline command { repro myfile.js }
	will execute and bring out its output as part of the command line for chen.
	The chen comand will then consider the first word of the output as <input_string>.
	So, the command will output the number of characters in the first word in
	the file.

	To correctly count the number of characters in myfile.js, use the code listed
	above under Valid Examples.

See Also
systemvar
var
echo
escape
chex
chin
chap
chal
sen
len
wen