NAME

exch - interactively inspect and change values of elements in an integer array

SYNOPSIS

exch (ptr, nelt)
int *ptr, nelt;

DESCRIPTION

exch allows the user to inspect and change the value of any one of nelt integers in the array beginning at ptr. It first prompts the user with the string "element #" printed to the standard output (usually the console terminal). THe user should enter an integer from 0 to nelt -1 followed by a CR (pressing the return key) to specify which element in the array to examine. If an illegal element number is entered, an error message is printed and the prompt is repeated. When exch has received a valid element number it prints the value of that element, requests a "newvalue?", and waits for the user to enter either an optionally signed digit string followed by a CR or simply a CR. If an integer is entered it replaces the old value of the current array element; if only a CR is entered, exch prompts for the next element #. However, if anything other than a digit string or a CR is entered the "newvalue?" prompt is repeated until an approprate response is entered.

To return from exch type a single CR in response to the "element #" prompt.

EXAMPLE

This illustrates the use of exch to change the members of a three element integer array with initial values of 0, 100, and 400. The subroutine call is: exch(array,3); The interaction with the user might look as follows:
element # 0
	= 0 newvalue? 
element # 1
	= 100 newvalue? a
	newvalue? 10
element #3
illegal element #
element # 2
	= 400 newvalue? -4
element # 
After this interaction the array values are 0, 10, and -4.

SEE ALSO

inumber(3U)

DIAGNOSTICS

exch will print an error message to the standard error device and will return -1 if it cannot write to the standard output device.