|Command||basic.%memccpy C Function/BASIC Program
Applicable release versions: AP/Unix
|Category||BASIC Program (486)|
|Description||copies characters from memory area specified by "s2" into "s1", stopping after the first occurrence of character designated by "character" has been copied, or after the number of characters specified by "length" have been copied, whichever comes first.
"s1" and "s2" are either Pick/BASIC strings or pointers to a character.
"variable" is a pointer to the character after the copy of "character" in "s1" or a NULL pointer if "c" was is found in the first "length" characters of "s2". If "s1" is a Pick string, the value returned by this function, except NULL, has no meaning.
|Syntax||variable=(char*)%memccpy(s1, s2, (char)character, length )|