summaryrefslogtreecommitdiff
path: root/inline.h
diff options
context:
space:
mode:
authorKarl Williamson <khw@cpan.org>2018-07-01 13:48:34 -0600
committerKarl Williamson <khw@cpan.org>2018-07-05 14:47:18 -0600
commit13aab5dd33b0c93c68cd510a6395b3e2d66079e3 (patch)
treee18cedb262445158ac47d3688c07604ec94ed857 /inline.h
parent8ed185f9c23fbf6e4b07abbe602e675889d07d4a (diff)
downloadperl-13aab5dd33b0c93c68cd510a6395b3e2d66079e3.tar.gz
Fix outdated docs for isUTF8_char()
It doesn't accept non-negative code points that don't fit in an IV
Diffstat (limited to 'inline.h')
-rw-r--r--inline.h10
1 files changed, 3 insertions, 7 deletions
diff --git a/inline.h b/inline.h
index d0e60e476d..78a162c7e7 100644
--- a/inline.h
+++ b/inline.h
@@ -1022,7 +1022,7 @@ value gives how many bytes starting at C<s> comprise the code point's
representation. Any bytes remaining before C<e>, but beyond the ones needed to
form the first code point in C<s>, are not examined.
-The code point can be any that will fit in a UV on this machine, using Perl's
+The code point can be any that will fit in an IV on this machine, using Perl's
extension to official UTF-8 to represent those higher than the Unicode maximum
of 0x10FFFF. That means that this macro is used to efficiently decide if the
next few bytes in C<s> is legal UTF-8 for a single character.
@@ -1036,12 +1036,8 @@ code points; and C<L</isUTF8_CHAR_flags>> for a more customized definition.
Use C<L</is_utf8_string>>, C<L</is_utf8_string_loc>>, and
C<L</is_utf8_string_loclen>> to check entire strings.
-Note that it is deprecated to use code points higher than what will fit in an
-IV. This macro does not raise any warnings for such code points, treating them
-as valid.
-
-Note also that a UTF-8 INVARIANT character (i.e. ASCII on non-EBCDIC machines)
-is a valid UTF-8 character.
+Note also that a UTF-8 "invariant" character (i.e. ASCII on non-EBCDIC
+machines) is a valid UTF-8 character.
=cut