TITLE

dumper.imc - PIR version of Data::Dumper

VERSION

version 0.10

SYNOPSIS

        ...

        # dump the P0 register
        _dumper( "P0", P0 )

        ...

        END
        .include "library/dumper.imc"

DESCRIPTION

    PIR implementation of Perl's Data::Dumper module.

FUNCTIONS

This library provides the following functions:

_dumper( name, pmc[, indent] )

This is the public (non object) interface to the dumper library.

name

Optional. The name of the PMC.

pmc

Required. The PMC to dump.

indent

Optional. The indent used at the start of each line printed.

Note: This function currently returns nothing. It should return the dumped data as a string, like Perl's Data::Dumper. Instead, everything is printed out using print.

Note: #2 Hash keys are now sorted using _sort() (library/sort.imc)

_register_dumper( id, sub )

Registers a dumper for new PMC type. UNIMPLEMENTED But see method __dunp below.

id

the PMC id, as returned by the typeof op.

sub

a Sub pmc, that gets called in order to dump the content of the given PMC

For example:

        newsub sub, .Sub, _dump_PerlArray
        _register_dumper( .PerlArray, sub )

This function returns nothing.

__dump(pmc dumper, str label) method

If a method __dump exists in the namespace of the class, it will be called with the current dumper object and the label of the PMC.

dumper =_global_dumper() (internal)

Internal helper function.

Returns the global dumper instance used by the non object interface.

AUTHOR

Jens Rieks <parrot at jensbeimsurfen dot de> is the author and maintainer. Please send patches and suggestions to the Perl 6 Internals mailing list.

COPYRIGHT

Copyright (c) 2004, the Perl Foundation.