Applesoft: Internals--String Utilities (2 of 2)



STRTXT          DE81

Build a temporary descriptor for a string literal of which the first character

is pointed to by TXTPTR plus C and which ends with a quote. FACMO,FACLO points

to the resulting temporary descriptor. Skip leading quotes before calling

STRLIT.  On exit, STRNG2 points to the character after the string literal.



STRLIT          E3E7

Build a temporary descriptor for a string literal of which the first character

is pointed to by Y,A and which ends with a quote.   FACMO,FACLO points to the

resulting temporary descriptor.

Skip leading quotes before calling STRLIT.  On exit, STRNG2 points to the

character after the string literal.



STRLT2          E3ED

Take a string literal of which the first character is pointed to by Y,A and

build a temporary descriptor for it pointed to by FACMO,FACLO. Save in CHARAC

and ENDCHR the characters other than zero that terminate the string. Skip

leading quotes before calling STRLIT2.  On exit, STRNG2 points to the

character after the string literal.



PUTNEW          E42A

Move the descriptor in DSCTMP to a temporary descriptor, put a pointer to the

descriptor in FACMO,FACLO, and flag the result as a string.



GETSPA          E452

Get A bytes of memory below HIMEM for a string.

GETSPA forces garbage collection to make room in memory when necessary and

exits with an "OUT OF MEMORY ERROR" if garbage collection can't make enough

room.

GETSPA moves FRESPC and FRETOP down enough to store the string.  On entry, A

equals the number of characters.  GETSPA returns with A unchanged and pointer

to the space in FRESPC, FRETOP, and Y,X.



FRESTR          E5FD

Make sure that the last FAC result was a string and free up the temporary

string result.  Check the descriptor for a temporary status allocated by

PUTNEW.  On exit, the address of the string is in INDEX and Y,X. The length of

the string is in A.  Uses FRETMP.



FREFAC          E600

Free up the temporary string pointed to by FACMO,FACLO.  Check the descriptor

for a temporary status allocated by PUTNEW.  On exit the address of the string

is in INDEX and Y,X.  The length of the string is in A. Uses FRETMP.



FRETMP          E604

Free up a temporary string.  On entry the pointer to the descriptor is in Y,A.

Checks the descriptor for a temporary status allocated by PUTNEW.  If so, the

temporary is freed up by updating TEMPPT.  If a temp is freed up, a further

check tests the string's location for the lowest in memory. If so, that area

of memory is freed up by updating FRETOP.  On exit the address of the string

is in INDEX and Y,X.  The length of the string is in A.



FRETMS          E635

Free the temporary descriptor without freeing up the string.  On entry Y,A

point to the descriptor to be freed.  On exit Z is set if anything was freed.





Apple Tech Notes





Keywords:  <None>



==================================================================



This information is from the Apple Technical Information Library.



ArticleID: TECHINFO-0000078



19960724 15:55:27.00

.