NAME
SplitName -- splits out a component of a pathname into a buffer (V36)
SYNOPSIS
newpos = SplitName(name, separator, buf, oldpos, size)
D0 D1 D2 D3 D4 D5
WORD SplitName(STRPTR, UBYTE, STRPTR, WORD, LONG)FUNCTION
This routine splits out the next piece of a name from a given file name. Each piece is copied into the buffer, truncating at size-1 characters. The new position is then returned so that it may be passed in to the next call to splitname. If the separator is not found within 'size' characters, then size-1 characters plus a null will be put into the buffer, and the position of the next separator will be returned.
If a a separator cannot be found, -1 is returned (but the characters from the old position to the end of the string are copied into the buffer, up to a maximum of size-1 characters). Both strings are null-terminated.
This function is mainly intended to support handlers.
INPUTS
name - Filename being parsed. separator - Separator charactor to split by. buf - Buffer to hold separated name. oldpos - Current position in the file. size - Size of buf in bytes (including null termination);
RESULT newpos - New position for next call to splitname. -1 for last one.
SEE ALSO