84PCE:Syscalls:021320 - Revision history

MateoConLechuga at 01:54, 26 September 2017

2017-09-26T01:54:03Z

MateoConLechuga: /* Inputs */

2017-09-26T01:50:53Z

‎Inputs

MateoConLechuga at 13:30, 31 May 2016

2016-05-31T13:30:14Z

MateoConLechuga at 13:19, 31 May 2016

2016-05-31T13:19:31Z

MateoConLechuga at 13:17, 31 May 2016

2016-05-31T13:17:28Z

MateoConLechuga at 13:15, 31 May 2016

2016-05-31T13:15:03Z

MateoConLechuga: Created page with "GetStringInput 021320 - GetStringInput == Synopsis == '''Hypothesized Official Name:''' GetStringInp..."

2016-05-31T13:10:10Z

Created page with "GetStringInput 021320 - GetStringInput == Synopsis == '''Hypothesized Official Name:''' GetStringInp..."

New page

[[Category:84PCE:Syscalls:By Name|GetStringInput]]
[[Category:84PCE:Syscalls:By Address|021320 - GetStringInput]]
== Synopsis ==
'''Hypothesized Official Name:''' GetStringInput

'''Syscall Address:''' 021320h

Gets a string of input from the user, much like the common 'Input' command used in TI-Basic programs. This system call does not return until after the user presses enter, but allows for use of all OS menus and input variations, including the Alpha and 2nd Keys special abilities. It works by creating a temporary equation which it then makes the edit buffer. It can also display an optional prompt for the user, in order to be more user friendly. Note that when using this routine, the system monitor completely takes over, so it will act exactly as it does in TI-Basic programs, which may have unintended side effects. It is highly recommended you call DeleteTempEditEqu once you are finished with your input parsing.

=== Inputs ===
* [[84PCE:RAM:D00879|ioPrompt]] - Copy the optional prompt string here, or write a null byte for no prompt
* [[84PCE:RAM:D00595|curRow]],[[84PCE:RAM:D00596|curCol]] - Set to the appropriate values for the location where to display the prompt and input string
* [[84PCE:RAM:D00596|curUnder]] - This is the character that is first displayed under the cursor. You should set it to 0, unless you want something under the cursor

=== Outputs ===
* [[84PCE:RAM:D0244E|editSym]] - Contains the VAT pointer to the temporary variable used for editing the input string. Can be used with VarNameToOP1HL to lookup the actual input data.

=== Destroys ===
* All

=== Example ===
call _ClrScrn
call _HomeUp ; clean up things
ld hl,inputPrompt
ld bc,inputPrompt_end-inputPrompt
ld de,ioPrompt
ldir ; copy the input prompt here
xor a,a
ld (curUnder),a
call _GetStringInput ; get the input from the user
ld hl,(editSym)
call _VarNameToOP1HL ; lookup the temporary input symbol
call _ChkFindSym
jr c,SomeError
ex de,hl
call _LoadDEInd_s ; get the size of the the string
push de
pop bc
ld de,safeRAMLocation ; copy it to saferam for later use
ldir
xor a,a
ld (de),a ; null terminate the string
SomeError:
call _DeleteTempEditEqu ; delete the temporary input
call _ClrScrn
jp _HomeUp ; clean up and leave

inputPrompt:
.db "Input:",0 ; Input prompt
inputPrompt_end:

@@ Line 6: / Line 6: @@
 '''Syscall Address:''' 021320h
-Gets a string of input from the user, much like the common 'Input' command used in TI-Basic programs. This system call does not return until after the user presses enter, but allows for use of all OS menus and input variations, including the Alpha and 2nd Keys special abilities. It works by creating a temporary equation which it then makes the edit buffer. It can also display an optional prompt for the user, in order to be more user friendly. Note that when using this routine, the system monitor completely takes over, so it will act exactly as it does in TI-Basic programs, which may have unintended side effects. It is highly recommended you call [[84PCE:Syscalls:021578|DeleteTempEditEqu]] once you are finished with your input parsing.
+Gets a string of input from the user, much like the common 'Input' command used in TI-Basic programs. This system call does not return until after the user presses enter, but allows for use of all OS menus and input variations, including the Alpha and 2nd Keys special abilities. It works by creating a temporary equation which it then makes the edit buffer. It can also display an optional prompt for the user, in order to be more user friendly. Note that when using this routine, the system monitor completely takes over, so it will act exactly as it does in TI-Basic programs, which may have unintended side effects. It is highly recommended you call [[84PCE:Syscalls:021578|DeleteTempEditEqu]] once you are finished with your input parsing. It basically calls _NewContext with 50h, _Mon, then _NewContext with 3Fh.
 === Inputs ===
@@ Line 29: / Line 29: @@
   	xor	a,a
   	ld	(curUnder),a
   	call	_GetStringInput				; get the input from the user
   	ld	hl,(editSym)
   	call	_VarNameToOP1HL				; lookup the temporary input symbol

@@ Line 12: / Line 12: @@
 * [[84PCE:RAM:D00595|curRow]],[[84PCE:RAM:D00596|curCol]] - Set to the appropriate values for the location where to display the prompt and input string
 * [[84PCE:RAM:D00596|curUnder]] - This is the character that is first displayed under the cursor. You should set it to 0, unless you want something under the cursor
 === Outputs ===

@@ Line 14: / Line 14: @@
 === Outputs ===
-* [[84PCE:RAM:D0244E|editSym]] - Contains the VAT pointer to the temporary variable used for editing the input string. Can be used with VarNameToOP1HL to lookup the actual input data.
+* [[84PCE:RAM:D0244E|editSym]] - Contains the VAT pointer to the temporary variable used for editing the input string. Can be used with [[84PCE:Syscalls:020AE8|VarNameToOP1HL]] to lookup the actual input data.
 === Destroys ===

@@ Line 34: / Line 34: @@
   	jr	c,SomeError
   	ex	de,hl
-  	call	_Load
+  	call	_LoadDEInd_s				; get the size of the the string

@@ Line 1: / Line 1: @@
-[[Category:84PCE:Syscalls:By Name|DeleteTempEditEqu]]
+[[Category:84PCE:Syscalls:By Name|GetStringInput]]
-[[Category:84PCE:Syscalls:By Address|021578 - DeleteTempEditEqu]]
+[[Category:84PCE:Syscalls:By Address|021320 - GetStringInput]]
 == Synopsis ==
-'''Hypothesized Official Name:''' DeleteTempEditEqu
+'''Hypothesized Official Name:''' GetStringInput
-'''Syscall Address:''' 021578h
+'''Syscall Address:''' 021320h
 Gets a string of input from the user, much like the common 'Input' command used in TI-Basic programs. This system call does not return until after the user presses enter, but allows for use of all OS menus and input variations, including the Alpha and 2nd Keys special abilities. It works by creating a temporary equation which it then makes the edit buffer. It can also display an optional prompt for the user, in order to be more user friendly. Note that when using this routine, the system monitor completely takes over, so it will act exactly as it does in TI-Basic programs, which may have unintended side effects. It is highly recommended you call [[84PCE:Syscalls:021578|DeleteTempEditEqu]] once you are finished with your input parsing.
@@ Line 34: / Line 34: @@
   	jr	c,SomeError
   	ex	de,hl
-  	call	_LoadDEInd_s				; get the size of the the string
+  	call	_Load
- 	push	de
- 	pop	bc
- 	ld	de,safeRAMLocation			; copy it to saferam for later use
- 	ldir
- 	xor	a,a
- 	ld	(de),a					; null terminate the string
- SomeError:
- 	call	_DeleteTempEditEqu			; delete the temporary input
- 	call	_ClrScrn
- 	jp	_HomeUp					; clean up and leave
-−
- inputPrompt:
- 	.db "Input:",0					; Input prompt
- inputPrompt_end: