appending(_:)

Appends a layer to this disk image, creating or extending a stack.

Declaration

consuming func appending(_ layer: consuming DiskImage) throws -> any StackedImage

Parameters

layer:
An existing disk image to append as the new top layer.

Return Value

A StackedImage containing all layers.

Discussion

This method creates a stacked disk image by appending a layer to either a base image or an existing stacked image. When the image is already a stacked image, the framework adds the new layer on top of the existing stack.