Fill<n>DByteArray

Creating Instances

Fills the last dimension of a byte array with a buffer beginning at the specified n-1 indices.

char *Fill<n>DByteArray( ByteArray Array, int ind1...indn-1, const char* buffer, size_t buff_size );
ArrayA byte array
int1...indn-1A comma-delimited list of the indices of the first n-1 dimensions where the filling will begin
*bufferA pointer to the buffer
buff_sizeThe size of the buffer

The Fill<n>DByteArrayfamily of functionsfill the last dimension of an n-dimensional byte array with a buffer.

The common function calls of this type are:

Fill1DByteArray
Fill2DByteArray
Fill3DByteArray
Fill4DByteArray
Fill5DByteArray
Fill6DByteArray
Fill7DByteArray
Fill8DByteArray
Fill9DByteArray

Return Values

lrc Return Values

Parameterization

Parameterization is not applicable to this function.

Example

This example fills a byte array with strings of characters. 

        ByteArray var;
        var = Create3DByteArray(0, 2, 0, 3, 0, 4);
        Fill3DByteArray(var, 0, 0, "abcd", 4);
        Fill3DByteArray(var, 0, 1, "efgh", 4);
        Fill3DByteArray(var, 0, 2, "ijkl", 4);
        Fill3DByteArray(var, 1, 0, "mnop", 4);
        Fill3DByteArray(var, 1, 1, "qrst", 4);
        Fill3DByteArray(var, 1, 2, "uvwx", 4);