switch_read_c

	value.i4.v = switch_read_c(switch_id.i4.v)

	This routine will return the most recent status of the requested
	switch.

	switch_id	ID of desired switch
			(returned by prior call to switch_create_c or
			 switch_create_radio_c)

	This function returns status values as follows:

	CBS_NO_SUCH		switch does not exist
	otherwise		returns the present value of the switch
				(SWITCH_LATCH -> SWITCH_ON or SWITCH_OFF,
				 SWITCH_MOMENTARY -> SWITCH_WAS_PRESSED or
						     SWITCH_NOT_PRESSED,
				 SWITCH_STATUS -> SWITCH_ON or SWITCH_OFF,
				 SWITCH_RADIO -> number of active switch)

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	switch_pressed, switch_set_state_c, switch_create_c,
	switch_create_radio_c, switch_text_to_id_c, wn_switch_read_c

	C/C++ usage:

	int	value;
	int	switch_id;

	status = switch_read_c(switch_id);