Rinput - Revision history

Laura: /* Syntax */

2014-05-06T00:02:11Z

Syntax

← Older revision		Revision as of 00:02, 6 May 2014
Line 30:		Line 30:

	===Syntax===		===Syntax===
	RINPUT [#<window number>] <string variable> [<error condition> <line ref>][,...]		RINPUT [#<window number>] <[[String\|string variable]]> [<[[error condition]]> <[[line ref]]>][,...]
	[[Image:Rinput.png]]		[[Image:Rinput.png]]

Laura: /* Comments and Examples */

2014-04-29T14:27:30Z

Comments and Examples

← Older revision		Revision as of 14:27, 29 April 2014
Line 29:		Line 29:
	An advantage of RINPUT is that the output and input both occur on the bottom line of the screen where the operator can use cursor keys to merely update parts of the line which need to be changed. If no change is needed, the operator may simply press Enter and the current variable is retained.		An advantage of RINPUT is that the output and input both occur on the bottom line of the screen where the operator can use cursor keys to merely update parts of the line which need to be changed. If no change is needed, the operator may simply press Enter and the current variable is retained.

			===Syntax===
			RINPUT [#<window number>] <string variable> [<error condition> <line ref>][,...]
	[[Image:Rinput.png]]		[[Image:Rinput.png]]

John: /* See Also */

2014-02-28T15:48:10Z

John: /* See Also */

2014-02-28T15:47:53Z

John at 15:46, 28 February 2014

2014-02-28T15:46:47Z

← Older revision		Revision as of 15:46, 28 February 2014
Line 47:		Line 47:
	:2.) The RINPUT statement has the same keyboard characteristics as LINPUT.		:2.) The RINPUT statement has the same keyboard characteristics as LINPUT.
	:3.) Keyboard buffering operates identically for RINPUT as it does for INPUT and LINPUT.		:3.) Keyboard buffering operates identically for RINPUT as it does for INPUT and LINPUT.

			===See Also===
			* [[Attribute]]

	<noinclude>		<noinclude>

Laura at 18:57, 16 October 2013

2013-10-16T18:57:35Z

← Older revision		Revision as of 18:57, 16 October 2013
Line 1:		Line 1:
			See also: [[RInput (disambiguation)]]

	The '''RInput''' (RI) [[statement]] displays the contents of a string variable on the output line at the bottom of the screen or window, allows the operator to change the value from the keyboard, inputs the new value and assigns it to the string variable.		The '''RInput''' (RI) [[statement]] displays the contents of a string variable on the output line at the bottom of the screen or window, allows the operator to change the value from the keyboard, inputs the new value and assigns it to the string variable.

Laura: /* Technical Considerations */

2013-02-06T03:07:02Z

Technical Considerations

← Older revision		Revision as of 03:07, 6 February 2013
Line 49:		Line 49:
	[[Category:Statements]]		[[Category:Statements]]
	[[Category:Displaying File Processing Statements]]		[[Category:Displaying File Processing Statements]]
			[[Category:Window File Processing Statements]]
	</noinclude>		</noinclude>

Laura: /* Parameters */

2013-01-30T20:38:16Z

Parameters

← Older revision		Revision as of 20:38, 30 January 2013
Line 35:		Line 35:
	The "wind-num" parameter indicates that information is to be input to and output from the bottom line of a window rather than the full screen. The specified window must have already been opened by an OPEN statement.		The "wind-num" parameter indicates that information is to be input to and output from the bottom line of a window rather than the full screen. The specified window must have already been opened by an OPEN statement.

	The required "string~~-var~~" parameter represents an unsubscripted or subscripted string variable. After execution of RINPUT, this variable contains the new value.		The required "string variable" parameter represents an unsubscripted or subscripted string variable. After execution of RINPUT, this variable contains the new value.

	NOTE that MAT and a matrix (array) name are not allowed in the RINPUT statement.		NOTE that MAT and a matrix (array) name are not allowed in the RINPUT statement.

Laura at 20:35, 30 January 2013

2013-01-30T20:35:56Z

← Older revision		Revision as of 20:35, 30 January 2013
Line 14:		Line 14:
	RINPUT #11,SELECT "10,10,C 10",WAIT=10:X$ TIMEOUT 100		RINPUT #11,SELECT "10,10,C 10",WAIT=10:X$ TIMEOUT 100

	The TIMEOUT error condition traps time-out errors (error code 4145) and specifies the line number of an appropriate error-handling routine.		The TIMEOUT error condition traps time-out errors (error code [[4145]]) and specifies the line number of an appropriate error-handling routine.

	00100 RELEASE #ITEM:		00100 RELEASE #ITEM:
Line 25:		Line 25:
	RINPUT combines the functions of PRINT and LINPUT to allow the operator to update a string variable.		RINPUT combines the functions of PRINT and LINPUT to allow the operator to update a string variable.

	An advantage of RINPUT is that the output and input both occur on the bottom line of the screen where the operator can use cursor keys to merely update parts of the line which need to be changed. If no change is needed, the operator may simply press ~~<CR>~~ and the current variable is retained.		An advantage of RINPUT is that the output and input both occur on the bottom line of the screen where the operator can use cursor keys to merely update parts of the line which need to be changed. If no change is needed, the operator may simply press Enter and the current variable is retained.

	[[Image:Rinput.png]]		[[Image:Rinput.png]]
Line 37:		Line 37:
	The required "string-var" parameter represents an unsubscripted or subscripted string variable. After execution of RINPUT, this variable contains the new value.		The required "string-var" parameter represents an unsubscripted or subscripted string variable. After execution of RINPUT, this variable contains the new value.

	NOTE that MAT and a matrix name are not allowed in the RINPUT statement.		NOTE that MAT and a matrix (array) name are not allowed in the RINPUT statement.

	RINPUT allows error processing with the optional "error-cond line-ref" parameter. See ~~the~~ Error Conditions ~~chapter~~ for more information.		RINPUT allows error processing with the optional "error-cond line-ref" parameter. See [[Error Conditions]] for more information.

	===Technical Considerations===		===Technical Considerations===
	:1.) Relevant error conditions are: ERROR, ~~Exit~~		:1.) Relevant error conditions are: [[ERROR]], [[EXIT]]
	:2.) The RINPUT statement has the same keyboard characteristics as LINPUT.		:2.) The RINPUT statement has the same keyboard characteristics as LINPUT.
	:3.) Keyboard buffering operates identically for RINPUT as it does for INPUT and LINPUT.		:3.) Keyboard buffering operates identically for RINPUT as it does for INPUT and LINPUT.

Laura: Created page with "The '''RInput''' (RI) statement displays the contents of a string variable on the output line at the bottom of the screen or window, allows the operator to change the valu..."

2013-01-30T20:24:07Z

Created page with "The '''RInput''' (RI) statement displays the contents of a string variable on the output line at the bottom of the screen or window, allows the operator to change the valu..."

New page

The '''RInput''' (RI) [[statement]] displays the contents of a string variable on the output line at the bottom of the screen or window, allows the operator to change the value from the keyboard, inputs the new value and assigns it to the string variable.

The WAIT= parameter and TIMEOUT error trap may now be used with INPUT/RINPUT statements to force releasing of records. This feature is useful for multi-user situations.

WAIT= specifies the number of seconds the system should wait for operator input before responding with a TIMEOUT error condition. NOTE that WAIT=0 instructs the system to wait for zero seconds, not to ignore the WAIT instruction. Also, -1 is a special WAIT value that instructs the system to wait forever, if necessary. Every time the operator presses any key, the clock is reset for WAIT seconds.

INPUT WAIT=10:X$ TIMEOUT 100
RINPUT WAIT=10:X$ TIMEOUT 100
LINPUT WAIT=10:X$ TIMEOUT 100
INPUT FIELDS "10,10,C 10",WAIT=10:X$ TIMEOUT 100
INPUT #11,FIELDS "10,10,C 10",WAIT=10:X$ TIMEOUT 100
RINPUT FIELDS "10,10,C 10",WAIT=10:X$ TIMEOUT 100
INPUT SELECT "10,10,C 10",WAIT=10:X$ TIMEOUT 100
RINPUT #11,SELECT "10,10,C 10",WAIT=10:X$ TIMEOUT 100

The TIMEOUT error condition traps time-out errors (error code 4145) and specifies the line number of an appropriate error-handling routine.

00100 RELEASE #ITEM:
00110 PRINT "OVER TIME LIMIT"
00120 PRINT "Your hold on inventory items has expired, re-enter order."

Before releasing the record, you may want to go to a routine that warns with a message and a few beeps that the hold on records is about to be released, then gives the operator an opportunity to continue data entry. See the "KSTAT$" function in the manual for information on how to use the WAIT parameter with that function.

===Comments and Examples===
RINPUT combines the functions of PRINT and LINPUT to allow the operator to update a string variable.

An advantage of RINPUT is that the output and input both occur on the bottom line of the screen where the operator can use cursor keys to merely update parts of the line which need to be changed. If no change is needed, the operator may simply press <CR> and the current variable is retained.

[[Image:Rinput.png]]

===Default===
:1.) Interrupt the program if an error occurs and ON error is not active.

===Parameters===
The "wind-num" parameter indicates that information is to be input to and output from the bottom line of a window rather than the full screen. The specified window must have already been opened by an OPEN statement.

The required "string-var" parameter represents an unsubscripted or subscripted string variable. After execution of RINPUT, this variable contains the new value.

NOTE that MAT and a matrix name are not allowed in the RINPUT statement.

RINPUT allows error processing with the optional "error-cond line-ref" parameter. See the Error Conditions chapter for more information.

===Technical Considerations===
:1.) Relevant error conditions are: ERROR, Exit
:2.) The RINPUT statement has the same keyboard characteristics as LINPUT.
:3.) Keyboard buffering operates identically for RINPUT as it does for INPUT and LINPUT.

<noinclude>
[[Category:Statements]]
[[Category:Displaying File Processing Statements]]
</noinclude>

← Older revision		Revision as of 15:48, 28 February 2014
Line 50:		Line 50:
	===See Also===		===See Also===
	* [[Control Attributes]]		* [[Control Attributes]]
			* [[Attribute (Screen)]]

	<noinclude>		<noinclude>

← Older revision		Revision as of 15:47, 28 February 2014
Line 49:		Line 49:

	===See Also===		===See Also===
	* [[~~Attribute~~]]		* [[Control Attributes]]

	<noinclude>		<noinclude>