StringCopyMax

void StringCopyMax (char destination[], const char source[], int destinationBufferSize);

Purpose

Copies the string pointed to by source to the array of characters pointed to by destination. No more than the number of characters specified by destinationBufferSize will be copied (including the nul byte).

This function is similar to the C Library strncpy function, except StringCopyMax has the following three advantages:

Parameters

Input
Name Type Description
source const char [] Contains a pointer to the null–terminated source string that will be copied to the destination string subject to the length limit imposed by destinationBufferSize.
destinationBufferSize integer Pass the size of the destination buffer (including space for the nul byte).

StringCopyMax will copy no more than the specified number of bytes (including the nul byte) regardless of the length of the source string.
Output
Name Type Description
destination char [] Contains the target string to which the source string will be copied.

Return Value

None.