class Image

Also copy/move-constructible from the View counterpart type.

This permits implicit conversion from View

<Storage

> to Image

<Storage

>.

The inverse is already implicit in the subclass relationship.

Updates the underlying storage to hold an empty ZBI. It is valid to call

this method even if the underlying storage does not already represent a

ZBI or is too small to do so; it will attempt to extend the capacity and

write a new container header.

This version of Append reserves enough space in the underlying ZBI to

append an item corresponding to the provided header. The header is

sanitized (via `SanitizeHeader`) with the header.length value preserved,

as it determines the amount of payload space allocated. The sanitized

header is immediately written to the storage and an iterator pointing to

the partially written item is returned to the caller on success. It is

the caller's responsibility to write the desired data to the payload

offset (accessible via the iterator).

If `header.flags` has `ZBI_FLAGS_CRC32` set, then it is the caller's

further responsibility to ensure that `header.crc32` is correct or to use

`EditHeader` later on the returned iterator with a correct value.

A simpler variation of Append, in which the provided header and payload

data are written to underlying storage up front. `header.length` will

automatically be set as `data.size()`. Moreover, if the ZBI_FLAGS_CRC32

flag is provided, the CRC32 will be automatically computed and set as

well.

A simpler variation of Append, in which the provided header and payload

data are written to underlying storage up front. `header.length` will

automatically be set as `data.size()`. Moreover, if the ZBI_FLAGS_CRC32

flag is provided, the CRC32 will be automatically computed and set as

well.

A simpler variation of Append, in which the provided header and payload

data are written to underlying storage up front. `header.length` will

automatically be set as `data.size()`. Moreover, if the ZBI_FLAGS_CRC32

flag is provided, the CRC32 will be automatically computed and set as

well.

A simpler variation of Append, in which the provided header and payload

data are written to underlying storage up front. `header.length` will

automatically be set as `data.size()`. Moreover, if the ZBI_FLAGS_CRC32

flag is provided, the CRC32 will be automatically computed and set as

well.

Extends the underlying ZBI by the items corresponding to an iterator range

another View. As this operation is inherently a copy from that view, a

CopyError of the latter is returned.

The semantics are similar to that of View's Copy(): this is a blind, bulk

copy from [first, last) and the relevant headers are not sanitized or

checked for correctness when written.

The given iterator must be to the last item in the ZBI. Adjust its length

to the given new length, which must be no larger than the space already

accounted for the item when it was appended. On success, the new iterator

at the same item is returned; old iterators to this item are invalidated.

Remove the given item and all items past it, invalidating any iterators to

those items.