Home > MultiValue Central > Online D3 Reference > BASIC Program > basic.%memccpy

basic.%memccpy

C Function/BASIC Program, Releases: AP/Unix

Copies memory up to a delimiter.

Syntax

variable=(char*)%memccpy(s1, s2, (char)character, length )

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.

See Also

Command Name Type Description
basic.cfunc Definition can be called from a Pick/BASIC program or subroutine in AP/DOS and AP/Unix implementations using a syntax similar to that of normal C.
basic.cfunction Definition Declare a list of C functions.
basic.%memxcpy C Function Copies memory and converts to hexadecimal.

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.