NAME

src/pmc.c - The base vtable calling functions

DESCRIPTION

Functions

INTVAL PMC_is_null: Tests if the given pmc is null.
PMC *pmc_new: Creates a new PMC of type base_type (which is an index into the list of PMC types declared in vtables in include/parrot/pmc.h). Once the PMC has been successfully created and its vtable pointer initialized, we call its init method to perform any other necessary initialization.
PMC *pmc_reuse: Reuse an existing PMC, turning it into an empty PMC of the new type. Any required internal structure will be put in place (such as the extension area) and the PMC will be ready to go. This will throw an exception if the PMC is constant or of a singleton type (such as the environment PMC) or is being turned into a PMC of a singleton type.
static PMC *get_new_pmc_header: Gets a new PMC header.
PMC *pmc_new_noinit: Creates a new PMC of type base_type (which is an index into the list of PMC types declared in vtables in include/parrot/pmc.h). Unlike pmc_new(), pmc_new_noinit() does not call its init method. This allows separate allocation and initialization for continuations.
PMC *constant_pmc_new_noinit: Creates a new constant PMC of type base_type.
PMC *constant_pmc_new: Creates a new constant PMC of type base_type, then calls its init.
PMC *pmc_new_init: As pmc_new(), but passes init to the PMC's init_pmc() vtable entry.
PMC *constant_pmc_new_init: As constant_pmc_new, but passes init to the PMC's init_pmc vtable entry.
PMC *temporary_pmc_new(PARROT_INTERP, INTVAL base_type): Creates a new temporary PMC of type base_type, the call init. You are responsible for freeing this PMC when it goes out of scope with free_temporary_pmc(). Do not store this PMC in any other PMCs, or allow it to be stored. Do not store any regular PMC in this PMC, or allow the storage of any regular PMC in this PMC.; If you don't know what this means means, or you can't tell if either case will happen as the result of any call you make on or with this PMC, DO NOT use this function, lest you cause weird crashes and memory errors. Use pmc_new() instead.; (Why do these functions even exist? Used judiciously, they can reduce GC pressure in hotspots tremendously. If you haven't audited the code carefully -- including profiling and benchmarking -- then use pmc_new() instead, and never ever add PARROT_API to either function.)
void temporary_pmc_free: Frees a new temporary PMC created by temporary_pmc_new(). Do not call this with any other type of PMC. Do not forget to call this (or you'll leak PMCs). Read and understand the warnings for temporary_pmc_new() before you're tempted to use this.
INTVAL pmc_register: Registers the name of a new PMC type with Parrot, returning the INTVAL representing that type.
INTVAL pmc_type: Returns the PMC type for name.
INTVAL pmc_type_p: Returns the PMC type for name.
static PMC *create_class_pmc: Create a class object for this interpreter. Takes an interpreter name and type as arguments. Returns a pointer to the class object.
void Parrot_create_mro: Create the MRO (method resolution order) array for this type.

DOD registry interface

void dod_register_pmc: Registers the PMC with the interpreter's DOD registry.
void dod_unregister_pmc: Unregisters the PMC from the interpreter's DOD registry.

HISTORY

Initial version by Simon on 2001.10.20.

NAME

DESCRIPTION

Functions

DOD registry interface

SEE ALSO

HISTORY