NAME
Sub::CharacterProperties - Support for user-defined character properties
VERSION
version 1.100860
SYNOPSIS
my $n = Sub::CharacterProperties->new(characters => [
'LATIN SMALL LETTER A',
'LATIN SMALL LETTER B',
'LATIN SMALL LETTER C',
'LATIN SMALL LETTER D',
# ...
]);
print $n->as_code('MySet');
DESCRIPTION
As described in perlunicode, you can define your own character
properties. To do so, you need to specify the ranges of allowed
characters as pairs of hexadecimal numbers. There are easier ways of
combining ranges with "+", "-", "!" and "&", but if you have a diverse
set of characters you are going to have to deal with hex values.
This module aims at making your task of writing these character property
subroutines easier.
Basically you create an object of this class, pass it a list of the
Unicode character names of the characters you'd like to allow and then
have it generate the character property subroutine.
Each character should be either a Unicode character name - such as
"LATIN SMALL LETTER A" - or a hex code point - indicated by a leading
"0x" - this is useful for characters that don't have a name.
The character property subroutines are a compile-time feature, so
unfortunately this module can't just install the generated subroutine.
You will have to copy-and-paste it into your program.
METHODS
get_ranges
Assumes that the "characters()" have been set.
Returns a list of ranges containing character numeric values; each range
is a Set::IntRange object.
as_code
Assumes that the "characters()" have been set.
Returns, as a string, the code of the subroutine you can use to
implement your custom character properties.
Takes an optional string argument; this is used for the subroutine name.
Note that according to perlunicode the subroutine name has to start with
"In" or "Is". If this argument is omitted, a dummy name - "InFoo" - is
used.
INSTALLATION
See perlmodinstall for information and options on installing Perl
modules.
BUGS AND LIMITATIONS
No bugs have been reported.
Please report any bugs or feature requests through the web interface at
.
AVAILABILITY
The latest version of this module is available from the Comprehensive
Perl Archive Network (CPAN). Visit to find a
CPAN site near you, or see
.
The development version lives at
. Instead of
sending patches, please fork this project using the standard git and
github infrastructure.
AUTHOR
Marcel Gruenauer
COPYRIGHT AND LICENSE
This software is copyright (c) 2007 by Marcel Gruenauer.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.