int to string - convert an integer to a string

Name

	int to string - convert an integer to a string

Summary

	Name		int to string
	Type		Filter
	Inputs		Integer Value -	integer REQUIRED
	Outputs		Output String -	string
	Parameters	Name		Type	Default
			Format		typein	%i

Description

    The int to string module will convert an integer to a string
    according to the conversion specification given.
    It is very useful and flexible for generating series of filenames.

Inputs

    Integer Value - integer
	The integer value to be converted.

Parameters

    Format (typein)
	The Format is a character string that controls the conversion
	of the integer value.  The conversion specification string is
	the same as for printf.  Please consult an introductory UNIX
	book or the corresponding manual page for more information.

Outputs

    Output String - string
	A string intended to be input into an string parameter port
	of another module.

Example networks

    This network reads a set of AVS field files and saves the results
    as images on disk.  The two "int to string" modules each generate a
    file name based on the integer value given.  Their formats might be
    as follows: "field.%03i.fld" and "image.%03i.rgb".
			animated integer
				|
		       ---------|---------
		      |                     |
		int to string         int to string
		      |                     |
		      |	                read field
		      |                     |
		      |  generate colormap  |
		      |		   |        |
		      |		 field to mesh
		      |                |
		      |------   geometry viewer
			     |         |
			   write rgb image
    The conversion specification used above assumes that the sequence
    number is coded as 3 digits including leading zeroes in the filename.

Related modules

    Modules which generate the integer input:
	integer
	animated integer
    Modules which accept the string output:
	any module with a string parameter
	read field
	write rgb image (any other write...image module)
	concat strings
	string to geom

See also

    float to string, which behaves exactly like int to string but for
    floating point input.

Author

	Urs Meyer
	Centro Svizzero di Calcolo Scientifico,
	Swiss Scientific Computing Center
	6928 Manno, Switzerland
	umeyer@cscs.ch
DATE
	$Date: 93/05/19 14:32:10 $