NAME ^

src/pmc/pmcproxy.pmc - proxy class object for a PMC enabling introspection

DESCRIPTION ^

This class is used to describe a PMC. It can sit in an inheritance hierarchy of a PDD15 class as well as allowing introspection of the PMC.

PMCProxy is not derived from any other PMC.

Structure ^

This class stores its state in the Parrot_PMCProxy structure, which has the following fields.

id

The type number of the PMC that is being described.

name

The name of the PMC -- a STRING.

namespace

The namespace the PMC is associated with, if any.

parents

An array of immediate parent classes. An empty ResizablePMCArray PMC is allocated during initialization.

all_parents

A cached array of ourself and all parent classes, in MRO order. A ResizablePMCArray PMC is allocated during initialization, and is populated with the current class.

NOTE: No doubt we will need other things later; this is a start.

*/

#include "parrot/parrot.h"

/*

Functions ^

void init()

Initializes a PMCProxy PMC.

PMC *instantiate(PMC *init)

Creates an instance of the PMC.

void destroy()

Free the memory associated with the object's underlying struct.

void mark()

Mark any referenced strings and PMCs in the structure as live.

PMC *inspect_str(STRING *what)

Provides introspection of a specific piece of information about the PMC. The available information is:

name

String PMC containing the name of the PMC

namespce

NameSpace PMC of the the namespace attached to the PMC

methods

Hash keyed on method name, value is an invokable PMC

parents

Array of PMCProxy PMCs representing the direct parents of this class.

PMC *inspect()

Returns a Hash describing the PMC, with key/value pairs as described in inspect_str.

STRING *name()

Gets the name of the PMC.

void pmc_namespace()

Gets the namespace that this class is attached to.

void new(PMC *args)

Creates an instance of the PMC.

void methods()

Return a hash where the keys are method names and the values are methods.

void parents()

Return the parents array PMC.

void inspect(STRING *what :optional)

Gets all introspection data for the PMC or, if the optional string parameter is supplied, a particular item of introspection data.

SEE ALSO ^

docs/pdds/pdd17_pmc.pod.


parrot