/ 
parrot-0.8.0
/ Parrot::PMC

NAME

Parrot::PMC - access a Parrot PMC from Perl 5

VERSION

Version 20081006

SYNOPSIS

# find a subroutine to invoke
my $sub_pmc       = $interp->find_global( 'some_parrot_sub' );
my $other_sub_pmc = $interp->find_global( 'another_sub', 'NameSpace' );

# invoke the subroutine
my $result_pmc    = $sub_pmc->invoke( $signature, @args );

# get the values out of it
my $string_val    = $result_pmc->get_string( $interp );

METHODS

This object provides several methods:

  • invoke( $signature, $argument )

    Given a Sub PMC or derivative, calls the appropriate Parrot function, parsing the $signature and passing a single string $argument. The first character of the $signature string denotes the return value. The remaining characters are the argument values, per the list:

    v void (return only)
    I integer
    N float
    S string
    P PMC

    In the future, this method may handle this translation for you automatically, though it may not deduce the return type correctly.

  • get_string()

    Retrieves the string value of the PMC. Not all PMCs support this.

AUTHOR

chromatic, <chromatic at wgz.org>

BUGS

There are three known deficiencies. First, there should be separate classes for separate Parrot PMC types. Second, there should be overloadings to handle various types of getting and setting values on PMCs. Third, the invoke() methods do not handle enough signatures.

Patches welcome.

Please report any bugs or feature requests to the Parrot Porters mailing list. Someday there may be a CPAN version of this code. Who knows?

COPYRIGHT & LICENSE

Copyright (C) 2006-2008 The Perl Foundation / chromatic.

This program is free software; you can redistribute it and/or modify it under the same terms as Parrot itself.