Inside Macintosh: OpenDoc Class Reference /

Part 1 - Classes and Methods / ODStorageUnitView

InsertValue

The InsertValue method inserts data into the focused value, starting at the offset (inclusive).

void InsertValue (in ODByteArray value);

value

A byte array whose buffer contains the data to be written.

DISCUSSION

You call this method to insert data into the focused value without overwriting the existing data at and beyond the current offset. If the focused value is currently a promise value, the promise is fulfilled before the data is written.

This method writes data to the focused value, starting at the current offset. If the focused value contained any data at and beyond the offset, that data appears after the inserted data. The size of the value is automatically increased to accommodate the inserted data.

When you no longer need the structure you pass as the value parameter, you should deallocate that structure and its buffer.

EXCEPTIONS

kODErrUnfocusedStorageUnit

The focus context of this storage-unit view is not a value.

If the storage-unit cursor for this storage-unit view does not represent a legal focus context for the storage unit that created this storage-unit view, this method throws exceptions raised by the FocusWithCursor method of that storage unit.

SEE ALSO

The ODByteArray type (page 877).
The ODStorageUnitView::DeleteValue method (page 733).
The ODStorageUnitView::SetValue method (page 760).