---
name: "ExtUtils::Typemaps::STL::String"
section: "3pm"
platform: "linux"
package: "libextutils-typemaps-default-perl"
version: "1.05-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ExtUtils::Typemaps::STL::String"
---

# ExtUtils::Typemaps::STL::String(3pm)

A set of typemaps for STL std::strings

## 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.