This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
handy.h: Create isALPHANUMERIC() and kin
authorKarl Williamson <public@khwilliamson.com>
Wed, 12 Dec 2012 03:47:25 +0000 (20:47 -0700)
committerKarl Williamson <public@khwilliamson.com>
Sat, 22 Dec 2012 18:11:27 +0000 (11:11 -0700)
commit15861f948fe52aa0c72233cd9dfc0190bfa3fbb1
tree68e1d074c5f89237a0bcbc739836c5aac749cac9
parentfbc19f27a35cc90f77285a47de2ff0dd21ff50c6
handy.h: Create isALPHANUMERIC() and kin

Perl has had an undocumented macro isALNUMC() for a long time.  I want
to document it, but the name is very obscure.  Neither Yves nor I are
sure what it is.  My best guess is "C's alnum".  It corresponds to
/[[:alnum:]]/, and so its best name would be isALNUM().  But that is the
name long given to what matches \w.  A new synonym, isWORDCHAR(), has
been in place for several releases for that, but the old isALNUM()
should remain for backwards compatibility.

I don't think that the name isALNUMC() should be published, as it is too
close to isALNUM().  I finally came to the conclusion that
isALPHANUMERIC() is the best name; it describes its purpose clearly; the
disadvantage is its long length.  I doubt that it will get much use, but
we need something, I think, that we can publish to accomplish this
functionality.

This commit also converts core uses of isALNUMC to isALPHANUMERIC.  (I
intended to that separately, but made a mistake in rebasing, and
combined the two patches; and it seemed like not a big enough problem to
separate them out again.)
13 files changed:
ext/XS-APItest/APItest.pm
ext/XS-APItest/APItest.xs
ext/XS-APItest/t/handy.t
handy.h
l1_char_class_tab.h
pp_hot.c
regcomp.c
regcomp.h
regen/mk_PL_charclass.pl
regexec.c
toke.c
utf8.c
x2p/walk.c