NAME

Unicode::BiDiRule - RFC 5893 BiDi Rule

SYNOPSIS

  use Unicode::BiDiRule qw(check);
  $result = check($string);
  %result = check($string);

DESCRIPTION

Unicode::BiDiRule performs checking according to BiDi Rule described in RFC 5893.

Note that the word "UTF-8" in this document is used in its proper meaning.

Function

check ( $string )

Check if a string satisfys BiDi Rule.

Parameters:

$string

A string to be checked, Unicode string or bytestring.

Note that bytestring won't be upgraded to Unicode string but will be treated as UTF-8 sequence.

Returns:

In scalar context: Direction of string, UNKNOWN (0), LTR or RTL, if it satisfys the rule. Otherwise undef.

In array context: A list of pairs describing detail of result with these keys:

result

One of values described in "Constants".

offset

If the check fails, offset from beginning of string. If succeeds, length of string.

Offset or length is based on byte for bytestring, and based on character for Unicode string.

length

When the check fails, length of disallowed substring.

Length is based on byte for bytestring, and based on character for Unicode string.

ord

Unicode scalar value of the first character of substring, when length item is set.

Constants

UNKNOWN

LTR

RTL

DISALLOWED

Possible results of checking. UNKNOWN indicates that string was empty and its direction was not determined.

Exports

None by default. :all tag exports check() and constants.

RESTRICTIONS

check() can not check Unicode string on EBCDIC platforms.

CAVEATS

• The repertoire and property values this module can provide are restricted by Unicode database of Perl core. Table below lists implemented Unicode version by each Perl version.

    Perl's version     Implemented Unicode version
    ------------------ ---------------------------------------
    5.8.0              3.2.0
    5.8.1 - 5.8.3      4.0.0
    5.8.4 - 5.8.6      4.0.1
    5.8.7 - 5.8.8      4.1.0
    5.10.0             5.0.0
    5.8.9, 5.10.1      5.1.0
    5.12.x             5.2.0
    5.14.x             6.0.0 with Corrigendum #8
    5.16.x             6.1.0
    5.18.x             6.2.0
    5.20.x             6.3.0
    5.22.x             7.0.0, correcting erratum at 2014-10-21

• LDH labels, strings consisting of ASCII graphic characters only, may not satisfy BiDi Rule. They should be checked using another rule.

SEE ALSO

RFC 5893 Right-to-Left Scripts for Internationalized Domain Names for Applications (IDNA). https://tools.ietf.org/html/rfc5893.

AUTHOR

Hatuka*nezumi - IKEDA Soji, <hatuka@nezumi.nu>

COPYRIGHT AND LICENSE

Copyright (C) 2015 by Hatuka*nezumi - IKEDA Soji

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. For more details, see the full text of the licenses at <http://dev.perl.org/licenses/>.

This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.