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.)

1 files changed, 14 insertions, 14 deletions

diff --git a/ext/XS-APItest/APItest.xs b/ext/XS-APItest/APItest.xs
index 4edef935ac..2155bc9c93 100644
--- a/ext/XS-APItest/APItest.xs
+++ b/ext/XS-APItest/APItest.xs
@@ -3816,51 +3816,51 @@ test_isWORDCHAR_LC_utf8(unsigned char * p)
         RETVAL
 
 bool
-test_isALNUMC_uni(UV ord)
+test_isALPHANUMERIC_uni(UV ord)
     CODE:
-        RETVAL = isALNUMC_uni(ord);
+        RETVAL = isALPHANUMERIC_uni(ord);
     OUTPUT:
         RETVAL
 
 bool
-test_isALNUMC_LC_uvchr(UV ord)
+test_isALPHANUMERIC_LC_uvchr(UV ord)
     CODE:
-        RETVAL = isALNUMC_LC_uvchr(ord);
+        RETVAL = isALPHANUMERIC_LC_uvchr(ord);
     OUTPUT:
         RETVAL
 
 bool
-test_isALNUMC_A(UV ord)
+test_isALPHANUMERIC_A(UV ord)
     CODE:
-        RETVAL = isALNUMC_A(ord);
+        RETVAL = isALPHANUMERIC_A(ord);
     OUTPUT:
         RETVAL
 
 bool
-test_isALNUMC_L1(UV ord)
+test_isALPHANUMERIC_L1(UV ord)
     CODE:
-        RETVAL = isALNUMC_L1(ord);
+        RETVAL = isALPHANUMERIC_L1(ord);
     OUTPUT:
         RETVAL
 
 bool
-test_isALNUMC_LC(UV ord)
+test_isALPHANUMERIC_LC(UV ord)
     CODE:
-        RETVAL = isALNUMC_LC(ord);
+        RETVAL = isALPHANUMERIC_LC(ord);
     OUTPUT:
         RETVAL
 
 bool
-test_isALNUMC_utf8(unsigned char * p)
+test_isALPHANUMERIC_utf8(unsigned char * p)
     CODE:
-        RETVAL = isALNUMC_utf8( p);
+        RETVAL = isALPHANUMERIC_utf8( p);
     OUTPUT:
         RETVAL
 
 bool
-test_isALNUMC_LC_utf8(unsigned char * p)
+test_isALPHANUMERIC_LC_utf8(unsigned char * p)
     CODE:
-        RETVAL = isALNUMC_LC_utf8( p);
+        RETVAL = isALPHANUMERIC_LC_utf8( p);
     OUTPUT:
         RETVAL