NAME

       JE::String - JavaScript string value

SYNOPSIS

         use JE;
         use JE::String;

         $j = JE->new;

         $js_str = new JE::String $j, "etetfyoyfoht";

         $perl_str = $js_str->value;

         $js_str->to_object; # retuns a new JE::String::Object;

DESCRIPTION

       This class implements JavaScript string values for JE. The difference in use between this
       and JE::Object::String is that that module implements string objects, while this module
       implements the primitive values.

       The stringification operator is overloaded.

THE FUNCTION

       There are two exportable functions, "surrogify" and "desurrogify", which convert
       characters outside the BMP into surrogate pairs, and convert surrogate pairs in the string
       input argument into the characters they represent, respectively, and return the modified
       string. E.g.:

         use JE::String qw 'desurrogify surrogify';

         {
                 no warnings 'utf8';
                 $str = "\x{d834}\x{dd2b}";
         }

         $str = desurrogify $str;  # $str now contains "\x{1d12b}" (double flat)
         $str = surrogify $str;    # back to "\x{d834}\x{dd2b}"

SEE ALSO

       JE
       JE::Types
       JE::Object::String