Functions | |
bool | isSTRING (SatAddr src) |
is the object at src a STRING? | |
char * | STRINGdecode (SatAddr src, char *dst) |
decode a STRING to a null-terminated C string. | |
SatAddr | STRINGencode (const char *src, SatAddr dst) |
convert a null-terminated C string into an HP STRING object | |
bool | STRINGadd (const char *src, SatAddr dst) |
SatAddr | makeSTRING (unsigned size) |
Allocate a STRING with numChars characters The initial contents of the string are undefined. | |
int | STRINGnibbles (SatAddr src) |
Return the size in nibbles of the STRING object at src. | |
int | STRINGnumChars (SatAddr src) |
return the number of characters in a STRING |
bool isSTRING | ( | SatAddr | src | ) |
is the object at src a STRING?
src | Saturn address of an object |
SatAddr makeSTRING | ( | unsigned | size | ) |
Allocate a STRING with numChars characters The initial contents of the string are undefined.
size | The number of characters that the string must hold. |
bool STRINGadd | ( | const char * | src, | |
SatAddr | dst | |||
) |
brief append a null-terminated string to a STRING object
src | a null-terminated C string to append | |
dst | Saturn Address of an existing STRING object. There must be sufficient space after the object to hold the appended string |
char* STRINGdecode | ( | SatAddr | src, | |
char * | dst | |||
) |
decode a STRING to a null-terminated C string.
src | The Saturn Address of a STRING object | |
dst | Where to store the resulting C string. If dst is NULL then a new string will be malloc'ed. Otherwise, dst must have sufficient space for the string and it's null terminator. |
convert a null-terminated C string into an HP STRING object
src | a null-terminated C string to convert | |
dst | Where to store the resulting STRING. If zero then a new STRING will be created in TEMPOB. Otherwise dst must point to the right amount of space to hold the STRING. |
int STRINGnibbles | ( | SatAddr | src | ) |
Return the size in nibbles of the STRING object at src.
src | the Saturn address of a STRING object |
int STRINGnumChars | ( | SatAddr | src | ) |
return the number of characters in a STRING
src | the Saturn address of a STRING object |