Maintenance script: Automated @@ correction

2016-02-24T22:10:13Z

Automated @@ correction

← Older revision		Revision as of 22:10, 24 February 2016
Line 1:		Line 1:
	{{Template:TI-BASIC:Routine		{{Template:TI-BASIC:Routine
	\|picture=@@		\|picture=
	\|summary=Displays text on several lines on the graph screen.		\|summary=Displays text on several lines on the graph screen.
	\|input=''Str1'' - text to display		\|input=''Str1'' - text to display
Line 8:		Line 8:
	\|variable=Str1, A, B, C, Ans		\|variable=Str1, A, B, C, Ans
	\|compatibility=TI-83/84/+/SE		\|compatibility=TI-83/84/+/SE
	\|author=@@		\|author=
	\|authors=@@		\|authors=
	\|url=@@		\|url=
	\|download=[file wordwrap.zip]		\|download=[file wordwrap.zip]
	}}		}}

Maintenance script: Initial automated import

2016-02-24T18:13:26Z

Initial automated import

New page

{{Template:TI-BASIC:Routine
|picture=@@
|summary=Displays text on several lines on the graph screen.
|input=''Str1'' - text to display
''A'' - starting row
''B'' - starting column
|output=None
|variable=Str1, A, B, C, Ans
|compatibility=TI-83/84/+/SE
|author=@@
|authors=@@
|url=@@
|download=[file wordwrap.zip]
}}

:1→C
:For(A,A,57,6
:inString(Str1,"/",Ans
:Text(A,B,sub(Str1,C,Ans-C
:If Ans=length(Str1:57→A
:Ans+1→C
:End

This routine displays a string on the graph screen, with line breaks after every slash "/" character. The routine requires there to be a slash at the end of the string (so, a sample string would be "THIS TEXT IS TOO LONG TO/DISPLAY ON ONE LINE/").

The row and column (A and B) inputs determine the upper and left boundaries of the text. You determine the right boundary by where you put the slash characters. The lower boundary is 57, hardcoded into the routine (this is the lowest that text can be displayed), but you could change this if you wanted a different boundary.

The variable C is used for an index inside Str1, that tells us which character we're currently on. We're starting at the beginning of the string, so we store 1 to C.

The [[TI-BASIC:For|For(]] loop will increment A by 6 each time we display a line (small font characters are 6 pixels tall). We start at the current value of A, and end at 57 because beyond that, [[TI-BASIC:Text|Text(]] will throw a domain error.

Now, we search for the next slash "/" character using the [[TI-BASIC:Instring|InString(]] command. Then, using [[TI-BASIC:Text|Text(]], we display the line between C and the "/", not including the slash itself. Ans+1→C will move the C index to the next character after the slash.

The line If Ans=length(Str1:57→A will end the loop early as soon as we reach the end of the string. This command can modify [[TI-BASIC:Ans|Ans]], which would be bad, but it only does so when we're ready to exit anyway -- at that point, we won't be needing Ans anymore.

= Error Conditions =

* '''[[TI-BASIC:Errors#invaliddim|ERR:INVALID DIM]]''' is thrown if Str1 is improperly formatted (check for the backslash at the end).
* '''[[TI-BASIC:Errors#domain|ERR:DOMAIN]]''' is thrown if text goes off the screen. This shouldn't happen unless B is very close to the right edge, if A or B are negative, or if the calculator is in [[TI-BASIC:Horiz|Horiz]] mode (in which case, replace 57 with 25).

= Related Routines =

* [[TI-BASIC:Highlighting_Text|Highlighting_Text]][[Category:TI-BASIC]]
[[Category:TIBD]]

TI-BASIC:Wordwrap Text - Revision history

Maintenance script: Automated @@ correction

Maintenance script: Initial automated import