CFDataIncreaseLength

Header: CFData.h Carbon status: Supported

Increases the length of a mutable CFData object's internal byte buffer, zero-filling the extension to the buffer.

void CFDataIncreaseLength (
    CFMutableDataRef data, 
    CFIndex extraLength
);
Parameter descriptions
data

Pass a reference to a mutable CFData object. References to immutable CFData objects will cause indeterminate behavior.

extraLength

An integer that specifies the number of bytes by which to increase the byte buffer.

DISCUSSION

The CFDataIncreaseLength function increases the length of a CFData's underlying byte buffer to a new size, initializing the new bytes to zero. Trying to set the length past the capacity of a fixed-size mutable buffer can result in indeterminate behavior.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)