NAME

Parse::Perl::CopHintsHash - reified cop_hints_hash structure

DESCRIPTION

This is a class used internally by Parse::Perl to represent part of a lexical environment. It is not meant to be touched by users directly. See Parse::Perl::Environment for the class that represents the whole lexical environment.

An object of this class is a Perl-manipulable handle onto a struct refcounted_he, which is the structure that Perl (from version 5.9.4 onwards) uses to store a runtime-accessible form of the compile-time %^H lexical hints hash. The structures are reference-counted, but because they are not in the SV format they can't directly participate in the usual reference counting of Perl objects. This class is a shim layer to allow the structures to be referenced from Perl objects in a way that propagates reference counting semantics.

The refcounted_he structure is only accessible from C code. This class does not provide any Perl-level interface to its content.

On versions of Perl that don't have struct refcounted_he, this class still exists, but represents nothing and should never be encountered.

SEE ALSO

Parse::Perl, Parse::Perl::Environment

AUTHOR

Andrew Main (Zefram) <zefram@fysh.org>

COPYRIGHT

Copyright (C) 2009, 2010, 2011, 2012 Andrew Main (Zefram) <zefram@fysh.org>

LICENSE

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