| Subject: | Handling utf-8 docs patch |
To handle utf-8 correctly and save double encoding:
"When this option is given, Net::LDAP converts all values of attributes not matching this REGEX into Perl UTF-8 strings so that the regular Perl operators (pattern matching, ...) can operate as one expects even on strings with international characters."
https://metacpan.org/pod/Net::LDAP#raw-REGEX1
Docs patch attached.
| Subject: | utf8_option_docs.patch |
--- Connection.pm 2009-12-03 21:12:02.000000000 +0000
+++ Connection2.pm 2016-08-25 21:49:09.361240600 +0100
@@ -147,6 +147,23 @@
=over 4
+=item C<raw>
+
+Use REGEX to denote the names of attributes that are to be considered binary
+in search results.
+
+When this option is given, Net::LDAP converts all values of attributes B<not>
+matching this REGEX into Perl UTF-8 strings so that the regular Perl operators
+(pattern matching, ...) can operate as one expects even on strings with
+international characters.
+
+If this option is not given, attribute values are treated as byte strings.
+
+Generally, you'll only ever need to do this if using RFC'd LDAP attributes
+and not a custom LDAP schema:
+
+ raw => qr/(?i:^jpegPhoto|;binary)/,
+
=item C<page>
Which page to return.