83Plus:BCALLs:450A - Revision history

Thepenguin77: added di

2010-01-01T18:21:34Z

added di

Dan Englender: /* Destroys */ none

2006-09-09T20:49:24Z

‎Destroys: none

Burntfuse at 20:08, 9 September 2006

2006-09-09T20:08:37Z

New page

[[Category:83Plus:BCALLs:By Name|PutS]]
[[Category:83Plus:BCALLs:By Name:Text|PutS]]
[[Category:83Plus:BCALLs:By Address|450A - PutS]]

== Synopsis ==
'''Official Name:''' PutS

'''BCALL Address:''' 450A

Displays a string on the screen in the large font.

=== Inputs ===
* ([[83Plus:RAM:844B|curRow]], [[83Plus:RAM:844C|curCol]]): Position on screen of first character
* HL: Zero-terminated string

=== Outputs ===
* String displayed on screen
* HL points to character after terminating zero of string

=== Destroys ===
?

== Comments ==
Since HL points to the character after the terminating zero of the string when the call is finished, you can put multiple strings in a row and display them all with calls to PutS. See the example.

== Example ==
ld hl,0
ld (curRow),hl
ld hl,string1
BCALL(PutS)
BCALL(PutS) ;hl points to string2 at this point
BCALL(PutS) ;hl points to string3 at this point
ret

string1: .db "This is a string ",0
string2: .db "This is another string ",0
string3: .db "Yet another string...",0

All three strings will be displayed in order, starting from the top-left corner of the screen.

@@ Line 22: / Line 22: @@
 == Comments ==
-Since HL points to the character after the terminating zero of the string when the call is finished, you can put multiple strings in a row and display them all with calls to PutS.  See the example.
+* Since HL points to the character after the terminating zero of the string when the call is finished, you can put multiple strings in a row and display them all with calls to PutS.  See the example.
 == Example ==

@@ Line 19: / Line 19: @@
 === Destroys ===
+''None''
 == Comments ==