---
name: "String::ToIdentifier::EN"
section: "3pm"
platform: "linux"
package: "libstring-toidentifier-en-perl"
version: "0.12-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/String::ToIdentifier::EN"
---

# String::ToIdentifier::EN(3pm)

Convert Strings to English Program Identifiers

## NAME

String::ToIdentifier::EN - Convert Strings to English Program Identifiers

## SYNOPSIS

```
    use utf8;
    use String::ToIdentifier::EN 'to_identifier';
    to_identifier 'foo-bar';             # fooDashBar
    to_identifier 'foo-bar', '_';        # foo_dash_bar
    to_identifier 'foo.bar', '_';        # foo_dot_bar
    to_identifier "foo\x{4EB0}bar";      # fooJingBar
    to_identifier "foo\x00bar";          # fooNullCharBar
    to_identifier "foo\x00\x00bar";      # foo2NullCharsBar
    to_identifier "foo\x00\x00bar", '_'; # foo_2_null_chars_bar
    {
        no utf8;
        to_identifier "foo\xFF\xFFbar.baz";      # foo_2_0xFF_BarDotBaz
        to_identifier "foo\xFF\xFFbar.baz", '_'; # foo_2_0xFF_bar_dot_baz
    }
```

## DESCRIPTION

This module provides a utility method, "to\_identifier" for converting an arbitrary string into a readable representation using the ASCII subset of `"\w"` for use as an identifier in a computer program. The intent is to make unique identifier names from which the content of the original string can be easily inferred by a human just by reading the identifier.

If you need the full set of `"\w"` including Unicode, see the subclass String::ToIdentifier::EN::Unicode.

Currently, this process is one way only, and will likely remain this way.

The default is to create camelCase identifiers, or you may pass in a separator char of your choice such as `"_"`.

Binary char groups will be separated by `"_"` even in camelCase identifiers to make them easier to read, e.g.: `"foo_2_0xFF_Bar"`.

## EXPORT

Optionally exports the "to\_identifier" function.

## SUBROUTINES

### to\_identifier

Takes the string to be converted to an identifier, and optionally a separator char such as `"_"`. If a separator char is not provided, a camelCase identifier will be returned.

## METHODS

### string\_to\_identifier

The class method version of "to\_identifier", if you want to use the object oriented interface.

## SEE ALSO

String::ToIdentifier::EN::Unicode, Text::Unidecode, Lingua::EN::Inflect::Phrase

## AUTHOR

Rafael Kitover, `"<rkitover@gmail.com>"`

## REPOSITORY

\<http://github.com/rkitover/string-toidentifier-en\>

## LICENSE AND COPYRIGHT

Copyright (c) 2018 Rafael Kitover \<rkitover@gmail.com\>.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.