parrotcode default PMC
Docs \| FAQ \| Download \| Examples \| Talks \| Resources \| Perl 6 \| Languages \| Who's Who \| Donors \| Cage Cleaners \| Wiki \|

src/pmc/default.pmc

NAME

src/pmc/default.pmc - Abstract root class

DESCRIPTION

These are the vtable functions for the default PMC class.

All methods which are not defined here get a default implementation generated from src/vtable.tbl by tools/build/pmc2c.pl.

Functions

static const char *caller(PARROT_INTERP, PMC *pmc)

Returns a C string for the name of *pmc.

static void cant_do_method(PARROT_INTERP, PMC *pmc, const char *methname)

Throws an exception "$methname() not implemented in class '$class'", used by all unimplemented messages.

static INTVAL check_set_std_props(PARROT_INTERP, PMC *pmc, STRING *key, PMC *value)

Called from setprop().

Returns a true value if setprop() can avoid actually setting a property in the prophash. If it returns true, the property setting will be reflected in a future call to propagate_std_props()

static void propagate_std_props(PARROT_INTERP, PMC *self, PMC *prop_hash)

Set pending standard properties in prop_hash.

static INTVAL has_pending_std_props(PMC *self)

Returns true if propagate_std_props() would create a non-empty prophash.

static PMC* check_get_std_props(PARROT_INTERPeter, PMC *self, STRING *key)

Checks if we can infer the value of key property from self without looking at its prophash. Returns PMCNULL if not, returns the value otherwise.

static PMC * make_prop_hash(PARROT_INTERP, PMC *self)

Create a property hash for self. Returns the created hash. Inferred properties will be added to the hash and it will be set as PMC_metadata(self).

static INTVAL does_isa(PARROT_INTERP, STRING *method, STRING *what)

Compares *method and *what. Returns true (1) if method is found in what, false (0) otherwise.

Methods

void init(): Does nothing.
void init_pmc(PMC *initializer): With a null initializer, calls init(), else throws an exception.
PMC *instantiate(PMC *init): Default fallback. Creates a new PMC of the type of the class SELF and calls init().
void mark(): Panics with a "no custom mark routine defined" error message.
PMC *getprop(STRING *key): Returns the property for *key. If no property is defined then the NULL PMC is returned.
void setprop(STRING *key, PMC *value): Sets the property for *key to *value.
void delprop(STRING *key): Deletes the property for *key.
PMC *getprops(): Returns the PMC's properties or the NULL PMC if no properties exist.
INTVAL type(): Returns the PMC's type.
INTVAL type_keyed_int(INTVAL key): Converts key to a PMC key and returns the result of calling type_keyed() with it.
STRING *name(): Returns the name of the PMC.
PMC *get_namespace: Return the namespace for this PMC.
PMC *find_method(STRING *method_name): Looks up the method for *method_name and returns it. If no method is found then NULL is returned.
void add_method(STRING *method_name, PMC *sub): Store the method as a global in the namespace of this class.
INTVAL get_integer_keyed_int(INTVAL key): Converts key to a PMC key and returns the result of calling get_integer_keyed() with it.
FLOATVAL get_number_keyed_int(INTVAL key): Converts key to a PMC key and returns the result of calling get_number_keyed() with it.
STRING *get_string_keyed_int(INTVAL key): Converts key to a PMC key and returns the result of calling get_string_keyed() with it.
INTVAL elements_keyed_int(INTVAL key): Converts key to a PMC key and returns the result of calling elements_keyed() with it.
PMC *get_pmc_keyed_int(INTVAL key): Converts key to a PMC key and returns the result of calling get_pmc_keyed() with it.
void *get_pointer(): Returns the address of the PMC.
INTVAL is_same(PMC *value): Returns whether the PMC is numerically equal to value.
void assign_pmc(PMC *value)
void assign_string_native(PMC *value): Defaults fall back to set_pmc and set_string_native.
void morph(INTVAL type): Changes the PMC to a PMC of a new type
void set_integer_keyed_int(INTVAL key, INTVAL value): Converts key to a PMC key and calls set_integer_keyed() with it and value.
void set_number_keyed_int(INTVAL key, FLOATVAL value): Converts key to a PMC key and calls set_number_keyed() with it and value.
void set_string_keyed_int(INTVAL key, STRING *string): Converts key to a PMC key and calls set_string_keyed() with it and value.
void set_bool_keyed_int(INTVAL key, INTVAL value): Converts key to a PMC key and calls set_bool_keyed() with it and value.
void set_pmc_keyed_int(INTVAL key, PMC *value): Converts key to a PMC key and calls set_pmc_keyed() with it and value.
INTVAL is_equal(PMC *value): Returns whether the PMC is equal to *value.
INTVAL is_equal_num(PMC *value): Returns whether the PMC is numerically equal to *value.
INTVAL is_equal_str(PMC *value): Returns whether the PMC is numerically equal to *value.
INTVAL exists_keyed_int(INTVAL key): Converts key to a PMC key and returns the result of calling exists_keyed() with it.
INTVAL defined(): Returns true.
INTVAL defined_keyed_int(INTVAL key): Converts key to a PMC key and returns the result of calling defined_keyed() with it.
void delete_keyed_int(INTVAL key): Converts key to a PMC key and calls delete_keyed() with it.
PMC *nextkey_keyed_int(INTVAL key, INTVAL w): Converts key to a PMC key and returns the result of calling nextkey_keyed() with it.
INTVAL can(STRING *method): Reports whether the PMC "can" perform method. If the PMC implements the vtable function method, true (1) is returned; otherwise, false (0) is returned.
INTVAL does(STRING *interface): Reports whether the PMC "does" perform interface. If the interface interface is found in the PMC's interface list, true (1) is returned; otherwise, false (0) is returned.
INTVAL does_pmc(PMC *role): Reports whether the PMC "does" the role.
INTVAL isa_pmc(PMC *_class): Reports whether the PMC "isa" _class. If the class _class is found in the PMC's class hierarchy, true (1) is returned; otherwise, false (0) is returned.
INTVAL isa(STRING *_class): Reports whether the PMC "isa" _class. If the class _class is found in the PMC's class hierarchy, true (1) is returned; otherwise, false (0) is returned.
PMC *inspect_str(STRING *what): Provides introspection of a specific piece of information about the PMC.
PMC *inspect(): Returns a Hash describing the class, with key/value pairs as described in inspect_str.
PMC *get_class(): Returns SELF. A PMC is its own class.
PMC *get_attr_str(STRING *attr): Look for NCI methods and properties.
PMC *get_attr_keyed(PMC *key, STRING *name): Default version of keyed attribute lookups. Discards the key and does a lookup by the string name passed in.
void set_attr_keyed(PMC *key, STRING *name, PMC *value): Default version of keyed attribute set. Discards the key and does a set by the string name passed in.
void add_parent(PMC *parent): Add class parent to the list of our parents.
void visit(visit_info *info): Used by DOD to mark the PMC.
PMC* clone(): Clones this PMC. By default, this just does a freeze and thaw.
void freeze(visit_info *info): Does nothing.
void thaw(visit_info *info): Initializes the PMC during unarchiving.
void thawfinish(visit_info *info): Does nothing.