4glWorks reference: string functions

get_token

file cstrc.c
declaration
function get_token(s)
    define s	char(32000)
returns tok, char(512), the extracted token
tail, char(512), the rest of the string
purpose extracts the first token out of string s
example none
notes none

pos

file cstrc.c
declaration
function pos(h, n)
    define h	char(32000),
	   n	char(32000)
returns p, integer, the index of the character in h where the match has been found
purpose returns the position of string n within h
example none
notes none

posbrk

file cstrc.c
declaration
function posbrk(h, c)
    define h	char(32000),
	   c	char(32000)
returns p, integer, index of the character in h where the match has been found
purpose returns the position of the first occurrence in h of any char in n
example none
notes none

poschr

file cstrc.c
declaration
function poschr(h, c)
    define h	char(32000),
	   c	char(1)
returns p, integer, index of the character in h where the match has been found
purpose returns the position of the first occurrence in h of character c
example none
notes none

posnbrk

file cstrc.c
declaration
function posnbrk(h, c)
    define h	char(32000),
	   c	char(32000)
returns p, integer, index of the character in h where the match has not been found
purpose returns the position of the first character in h that does not match any character in n
example none
notes none

postoken

file cstrc.c
declaration
function postoken(h, c)
    define h	char(32000),
	   s	char(32000)
returns tok, char(512), the extracted token
p, integer, position of the beginning of the rest of the string
purpose returns the first token in h, and the position in h following the token. s defines the possible token separators.
example none
notes none

str2int

file ccnvc.c
declaration
function str2int(s)
    define s	char(10)
returns c, integer, converted character
purpose converts the given string into an integer
example none
notes
  • this routine was written before ord() was implemented and is provided for backwards compatibility
  • returns NULL if the string contains non numerical chars

str_compare

file cstrc.c
declaration
function str_compare(s1, s2)
    define 1, s2	char(32000)
returns r, integer, length of the initial matching segment
purpose returns the length of the initial matching segment of 2 strings
example none
notes none

str_rightmargin

file cstrc.c
declaration
function str_rightmargin(s, l)
    define s	char(132),
	   l	smallint
returns ol, integer, lenght of formatted string
i, integer, starting point of unformmated text
s, char(132), formatted string
purpose right margins the string s to the lenght specified in l. returns the length of the output string, the index of the first character in the original string not included in the output string, and the margined string.
example none
notes none


Please address questions or comments to marco greco
(last updated Thu, 28 March 2002 16:09:18 GMT)