1
0
mirror of https://github.com/RevCurtisP/C02.git synced 2024-06-08 21:29:30 +00:00
C02/doc/include/stringx.txt
2021-12-18 19:28:47 -05:00

69 lines
2.6 KiB
Plaintext

Extended String Manipulation Functions for C02
This library contains less commonly used string functions. It is maintained
as a separate set of files so that it can be included only when needed, in
order to reduce program size.
Strings follow all the same rules as specified in the string.h02 library.
Usage: at the beginning of the program use the directives
#include <stddef.h02>
#include <string.h02>
#include <stringx.h02>
The following functions are defined:
n = strspn(&s); Returns the length of the span of characters at
the beginning of destination string set by prior
strdst() call that are present in source string s.
This mimics the functionality of the standard C
and C++ strspn() function.
Note: calls routine strchr(), leaving dstlo and
dsthi pointing to the destination string.
n = strcsp(&s); Returns the length of the span of characters at
the beginning of destination string set by prior
strdst() call that are not present in source
string s.
This mimics the functionality of the standard C
and C++ strcspn() function.
Note: aliased to the strbrk() function, which calls
strchr(), leaving dstlo and dsthi pointing to the
destination string.
n = strpbk(&s); Returns the poisition of the first character in
the destination string set by prior strdst() call
that is present in source string s.
If no characters in the source string are present
in the destination string, returns 255.
This mimics the functionality of the standard C
and C++ strpbrk() function.
Note: calls routine strchr(), leaving dstlo and
dsthi pointing to the destination string.
Note: This library expects the following functions to be defined
setdst(&s); Set destination string pointer
setsrc(&s); Set source string pointer and initialize index
strchr(c, &s); Return position of character in string
along with the zero page pairs
strlo, strhi Source String Pointer
dstlo, dsthi Destination String Pointer
and the memory locations
temp0, temp1 Temporary storage