NAME

       ExtUtils::Typemaps::STL::String - A set of typemaps for STL std::strings

SYNOPSIS

         use ExtUtils::Typemaps::STL::String;
         # 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::STL::String->new);

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

DESCRIPTION

       "ExtUtils::Typemaps::STL::String" is an "ExtUtils::Typemaps" subclass that provides a set
       of mappings for C++ STL strings.  These are:

         TYPEMAP
         std::string   T_STD_STRING
         std::string*  T_STD_STRING_PTR

         INPUT
         T_STD_STRING
             $var = std::string( SvPV_nolen( $arg ), SvCUR( $arg ) );

         T_STD_STRING_PTR
             $var = new std::string( SvPV_nolen( $arg ), SvCUR( $arg ) );

         OUTPUT
         T_STD_STRING
             $arg = newSVpvn( $var.c_str(), $var.length() );

         T_STD_STRING_PTR
             $arg = newSVpvn( $var->c_str(), $var->length() );

METHODS

       These are the overridden methods:

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

SEE ALSO

       ExtUtils::Typemaps, ExtUtils::Typemaps::Default, ExtUtils::Typemaps::ObjectMap

AUTHOR

       Steffen Mueller <smueller@cpan.org>

COPYRIGHT AND LICENSE

       Copyright 2010, 2011, 2012, 2013 by Steffen Mueller

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