NAME

BumpRevisionLength: length-limited name-reformatting for a copy (V45)

SYNOPSIS

result = BumpRevisionLength(newbuf, oldname, length)

D0 A0 A1 D0

STRPTR BumpRevisionLength(STRPTR, STRPTR, ULONG length);

FUNCTION

BumpRevisionLength takes a name and turns it into a "copy_of_name". It knows how to deal with copies of copies. The routine will truncate the new name to the given maximal file size. In case it cannot fit the fill the name even by truncation, it will return NULL.

INPUTS

newbuf: the new buffer that will receive the name (it must be at least 31 characters long).
oldname: the original name

RESULT

result: a pointer to newbuf, or NULL in case the buffer is too small even for a truncated copy.

EXAMPLE

oldname newbuf
------- ------
"foo" "copy_of_foo"
"copy_of_foo" "copy_2_of_foo"
"copy_2_of_foo" "copy_3_of_foo"
"copy_199_of_foo" "copy_200_of_foo"
"copy foo" "copy_of_copy foo"
"copy_0_of_foo" "copy_1_of_foo"
"012345678901234567890123456789" "copy_of_0123456789012345678901"