NAME

src/io/io_layers.c - IO Layer Handling

DESCRIPTION

The Parrot IO subsystem uses a per-interpreter stack to provide a layer-based approach to IO. Each layer implements a subset of the ParrotIOLayerAPI vtable. To find an IO function the layer stack is searched downwards until a non-NULL function pointer is found for that particular slot.

Layer and Stack Functions

PIO_base_new_layer

The default IO layer constructor. Creates and returns a new ParrotIOLayer. If a prototype *proto is supplied then its values will be copied to the new instance.

PIO_base_delete_layer

The default IO layer destructor. Frees the memory associated with *layer.

PIO_push_layer

Push a layer onto an IO object (*pmc) or the default stack.

PIO_get_layer

TODO: Not yet documented!!!

PIO_push_layer_str

Push a layer onto an IO object (*pmc).

PIO_pop_layer

Pop a layer from an IO object (*pmc) or the default stack.

PIO_pop_layer_str

Pop a layer from an IO object (*pmc) and return the name of the popped layer. The layer gets freed.

PIO_copy_stack

Primarily used to copy the default IO stack for a new IO object. Later we will do some funky copy-on-write stuff.