This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlreapi: Update as little as possible for 5.14
[perl5.git] / pod / perlreapi.pod
index 7028650..1c694a7 100644 (file)
@@ -120,21 +120,26 @@ TODO: Document those cases.
 
 =item C</p> - RXf_PMf_KEEPCOPY
 
-=back
-
-Additional flags:
-
-=over 4
-
-=item RXf_PMf_LOCALE
-
-Set if C<use locale> is in effect. If present in C<< rx->extflags >>
+=item Character set
+
+The character set semantics are determined by an enum that is contained
+in this field.  This is still experimental and subject to change, but
+the current interface returns the rules by use of the in-line function
+C<get_regex_charset(const U32 flags)>.  The only currently documented
+value returned from it is REGEX_LOCALE_CHARSET, which is set if
+C<use locale> is in effect. If present in C<< rx->extflags >>
 C<split> will use the locale dependent definition of whitespace under
 when RXf_SKIPWHITE or RXf_WHITE are in effect. Under ASCII whitespace
 is defined as per L<isSPACE|perlapi/isSPACE>, and by the internal
 macros C<is_utf8_space> under UTF-8 and C<isSPACE_LC> under C<use
 locale>.
 
+=back
+
+Additional flags:
+
+=over 4
+
 =item RXf_UTF8
 
 Set if the pattern is L<SvUTF8()|perlapi/SvUTF8>, set by Perl_pmruntime.