Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Tag: RELEASE_0_4_12
Fetching contributors…

Cannot retrieve contributors at this time

145 lines (89 sloc) 2.1 KB
Copyright (C) 2001-2003, The Perl Foundation.
=head1 NAME
src/pmc/parrotlibrary.pmc - Dynamic Library
Class for holding info about a dynamic library.
PMC data
PMC_struct_val(SELF) oplib init function
PMC_data(SELF) DLL handle
_filename full path/file of lib
_ro true after init
All ParrotLibrary PMCs are in interp->iglobals.
When a dynamic library (pmc or ops) is loaded, the load function returns
a ParrotLibrary PMC.
=head2 Methods
=over 4
#include "parrot/parrot.h"
pmclass ParrotLibrary need_ext does library const_too {
=item C<void init()>
Initializes the library with a C<NULL> oplib init function.
void init() {
PMC_struct_val(SELF) = NULL;
=item C<void morph(INTVAL type)>
Morphs to C<type>.
void morph(INTVAL type) {
=item C<PMC *clone()>
Creates and returns a clone of the library.
PMC* clone() {
PMC* dest = pmc_new_noinit(INTERP, SELF->vtable->base_type);
PMC_struct_val(dest) = PMC_struct_val(SELF);
PMC_data(dest) = PMC_data(SELF);
if (PMC_metadata(SELF)) {
PMC_metadata(dest) = VTABLE_clone(INTERP, PMC_metadata(SELF));
return dest;
=item C<INTVAL get_bool()>
Returns whether a library has been successfully loaded.
INTVAL get_bool() {
return (PMC_data(SELF) != NULL);
=item C<STRING* get_string()>
Returns the name of the loaded library.
STRING* get_string() {
PMC *prop;
STRING *key;
key = const_string(INTERP, "_filename");
prop = VTABLE_getprop(INTERP, SELF, key);
return VTABLE_get_string(INTERP, prop);
=head1 SEE ALSO
Date: Mon, 29 Sep 2003 14:37:11 -0400 (EDT)
Subject: Library loading and initialization sequence
From: Dan Sugalski
=head1 HISTORY
Initial version by leo 2003.10.12.
* Local variables:
* c-file-style: "parrot"
* End:
* vim: expandtab shiftwidth=4:
Jump to Line
Something went wrong with that request. Please try again.