ExtUtils::Typemaps::ObjectMap(3p)

NAME
ExtUtils::Typemaps::ObjectMap - A set of typemaps for opaque C/C++ objects

SYNOPSIS
  use ExtUtils::Typemaps::ObjectMap;
  # First, read my own type maps:
  my $private_map = ExtUtils::Typemaps->new(file => 'my.map');

  # Then, get the object map set and merge it into my maps
  $private_map->merge(typemap => ExtUtils::Typemaps::ObjectMap->new);

  # Now, write the combined map to an output file
  $private_map->write(file => 'typemap');

DESCRIPTION
"ExtUtils::Typemaps::ObjectMap" is an "ExtUtils::Typemaps" subclass that provides a set of mappings for using pointers to C/C++ objects as opaque objects from Perl.

These mappings are taken verbatim from Dean Roehrich's "perlobject.map". They are:

  # "perlobject.map"  Dean Roehrich, version 19960302
  #
  # TYPEMAPs
  #
  # HV *                -> unblessed Perl HV object.
  # AV *                -> unblessed Perl AV object.
  #
  # INPUT/OUTPUT maps
  #
  # O_*         -> opaque blessed objects
  # T_*         -> opaque blessed or unblessed objects
  #
  # O_OBJECT    -> link an opaque C or C++ object to a blessed Perl object.
  # T_OBJECT    -> link an opaque C or C++ object to an unblessed Perl object.
  # O_HvRV      -> a blessed Perl HV object.
  # T_HvRV      -> an unblessed Perl HV object.
  # O_AvRV      -> a blessed Perl AV object.
  # T_AvRV      -> an unblessed Perl AV object.

METHODS
These are the overridden methods:

  new
Creates a new "ExtUtils::Typemaps::ObjectMap" object. It acts as any other "ExtUtils::Typemaps" object, except that it has the object maps initialized.

SEE ALSO
ExtUtils::Typemaps, ExtUtils::Typemaps::Default, ExtUtils::Typemaps::STL::String

AUTHOR
The module was written by Steffen Mueller <smueller@cpan.org>, but the important bit, the typemap, was written by Dean Roehrich.

COPYRIGHT AND LICENSE
Copyright 2010, 2011, 2012, 2013 by Steffen Mueller

Except for the typemap code, which is copyright 1996 Dean Roehrich

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