From 59887a99f7d62961aaf7cf10962af0a596c4942f Mon Sep 17 00:00:00 2001 From: Marcus Holland-Moritz Date: Mon, 31 Jan 2005 18:14:44 +0000 Subject: [PATCH] Regenerate perlapi.pod. p4raw-id: //depot/perl@23913 --- pod/perlapi.pod | 68 +++++++++++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 56 insertions(+), 12 deletions(-) diff --git a/pod/perlapi.pod b/pod/perlapi.pod index 7f258d8..1c33761 100644 --- a/pod/perlapi.pod +++ b/pod/perlapi.pod @@ -2219,6 +2219,53 @@ Found in file pad.c =back +=head1 Simple Exception Handling Macros + +=over 8 + +=item dXCPT + +Set up neccessary local variables for exception handling. +See L. + + dXCPT; + +=for hackers +Found in file XSUB.h + +=item XCPT_CATCH + +Introduces a catch block. See L. + +=for hackers +Found in file XSUB.h + +=item XCPT_RETHROW + +Rethrows a previously caught exception. See L. + + XCPT_RETHROW; + +=for hackers +Found in file XSUB.h + +=item XCPT_TRY_END + +Ends a try block. See L. + +=for hackers +Found in file XSUB.h + +=item XCPT_TRY_START + +Starts a try block. See L. + +=for hackers +Found in file XSUB.h + + +=back + =head1 Stack Manipulation Macros =over 8 @@ -5307,7 +5354,7 @@ Found in file utf8.c Convert the UTF-8 encoded character at p to its foldcase version and store that in UTF-8 in ustrp and its length in bytes in lenp. Note -that the ustrp needs to be at least UTF8_MAXLEN_FOLD+1 bytes since the +that the ustrp needs to be at least UTF8_MAXBYTES_CASE+1 bytes since the foldcase version may be longer than the original character (up to three characters). @@ -5323,9 +5370,8 @@ Found in file utf8.c Convert the UTF-8 encoded character at p to its lowercase version and store that in UTF-8 in ustrp and its length in bytes in lenp. Note -that the ustrp needs to be at least UTF8_MAXLEN_UCLC+1 bytes since the -lowercase version may be longer than the original character (up to two -characters). +that the ustrp needs to be at least UTF8_MAXBYTES_CASE+1 bytes since the +lowercase version may be longer than the original character. The first character of the lowercased version is returned (but note, as explained above, that there may be more.) @@ -5339,9 +5385,8 @@ Found in file utf8.c Convert the UTF-8 encoded character at p to its titlecase version and store that in UTF-8 in ustrp and its length in bytes in lenp. Note -that the ustrp needs to be at least UTF8_MAXLEN_UCLC+1 bytes since the -titlecase version may be longer than the original character (up to two -characters). +that the ustrp needs to be at least UTF8_MAXBYTES_CASE+1 bytes since the +titlecase version may be longer than the original character. The first character of the titlecased version is returned (but note, as explained above, that there may be more.) @@ -5355,9 +5400,8 @@ Found in file utf8.c Convert the UTF-8 encoded character at p to its uppercase version and store that in UTF-8 in ustrp and its length in bytes in lenp. Note -that the ustrp needs to be at least UTF8_MAXLEN_UCLC+1 bytes since the -uppercase version may be longer than the original character (up to two -characters). +that the ustrp needs to be at least UTF8_MAXBYTES_CASE+1 bytes since +the uppercase version may be longer than the original character. The first character of the uppercased version is returned (but note, as explained above, that there may be more.) @@ -5492,7 +5536,7 @@ Found in file utf8.c =item uvchr_to_utf8 Adds the UTF-8 representation of the Native codepoint C to the end -of the string C; C should be have at least C free +of the string C; C should be have at least C free bytes available. The return value is the pointer to the byte after the end of the new character. In other words, @@ -5510,7 +5554,7 @@ Found in file utf8.c =item uvuni_to_utf8_flags Adds the UTF-8 representation of the Unicode codepoint C to the end -of the string C; C should be have at least C free +of the string C; C should be have at least C free bytes available. The return value is the pointer to the byte after the end of the new character. In other words, -- 2.7.4