AcornSearch - Acorn and RISC OS information searching
RISC OS Search
containing
"Nutty quip goes here!"
Home  |  About  |  Filebase Archive  |  StrongHelp Manuals  |  Newsgroups  |  Module Database
=>     R0 = reason code
     other registers are reason code dependent

<=     R0 preserved
     other registers are reason code dependent

This call provides various operations to deal with ASCII strings.

More info.
AppEngine_StringOp information
This call provides various operations to deal with ASCII strings.

Most (if not all) of the calls place their result within AppEngine's workspace and return a pointer to the string within the workspace.  For this reason, you must always copy the string to somewhere else before calling StringOp again - if you don't do that then further calls to StringOp will overwrite the workspace, destroying the string.

All strings are stored in the same style as BASIC, i.e. with CR (13) as the terminating character.  As with BASIC, they are limited to a maximum of 256 characters, including terminator (although this may change later on).  Typically you will use the operations in this way:
     
SYS "AppEngine_StringOp",1,source% TO ,,string$
     
Input strings can be terminated by any control character, unless otherwise stated.
AppEngine_StringOp reason codes
R0     Action

0     reads a string from memory (LF terminated)
1     reads a string from memory (control terminated)
2     shortens a string, adding an ellipsis on the left
3     shortens a string, adding an ellipsis on the right
4     converts a string to lower-case characters
5     converts a string to upper-case characters
6     tests whether a string is a valid integer number
7     strips leading spaces and tabs from a string
8     compares two strings
9     joins two strings
10     returns the leafname from a path string
11     returns the branchname from a path string (not yet implemented)
12     substitutes arguments into a string
13     returns the length of a string
14     copies a string

[sh-index] Back to list of manuals