view release on metacpan or  search on metacpan

XS/CQuery.pod  view on Meta::CPAN

see L<DDC::XS::Object> for details.
The L<DDC::XS::Object|DDC::XS::Object> methods toHash() and newFromHash()
may be useful for mapping back and forth between the "opaque" objects
in the DDC::XS hierarchy and perl representations of these encoded as
HASH-refs, since perl's internal reference-counting strategy applies
to the latter.


=head1 KNOWN BUGS

Objects should be transparently encoded/decoded to and from perl hash representations.

=head1 SEE ALSO

perl(1),
DDC::XS(3perl),
DDC::XS::Object(3perl),
DDC::XS::CQCount(3perl),
DDC::XS::CQFilter(3perl),
DDC::XS::CQueryOptions(3perl),
DDC::XS::CQueryCompiler(3perl).

XS/Object.pm  view on Meta::CPAN

 $cnt   = $obj->refcnt();               ##-- get internal reference count (NOT the same as perl's)



=head1 DESCRIPTION

The DDC::XS::Object class provides convenience methods for mapping back and forth between
"opaque" pointer-based objects in the DDC::XS:: hierarchy and perl-side representations
of these encoded as HASH-refs.
The methods defined by this class are intended as convenience wrappers for dealing with
complex nested object structures using transparent perl hashes with perl reference-counting for memory
management, rather than DDC::XS reference counting.

DDC::XS::Object objects and their descendants
use an internal reference counting strategy in addition to perl's reference counts
in order to determine when objects can be safely destroyed.
This strategy attempts to ensure that all C<DDC::XS::Object>s are destroyed when the last
reference is dropped, where both perl references and C++-level embedded object pointers
constitute "references" in this sense.
If you so desire, you can force (deep) object destruction by calling
the DDC::XS::Object free() method, although this is currently not recommended for general use.