From 71b454dc73b0aa829699af6ec5991620565c3a43 Mon Sep 17 00:00:00 2001 From: Karl Williamson Date: Sun, 1 May 2022 10:07:07 -0600 Subject: perlapi: Consolidate CopLABEL* entries Making these a single entry makes perlapi more concise. --- cop.h | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) diff --git a/cop.h b/cop.h index dddf0afb52..d93e0f02a4 100644 --- a/cop.h +++ b/cop.h @@ -636,19 +636,17 @@ be zero. cophh_2hv(CopHINTHASH_get(cop), flags) /* -=for apidoc Am|const char *|CopLABEL|COP *const cop +=for apidoc Am|const char *|CopLABEL |COP *const cop +=for apidoc_item|const char *|CopLABEL_len |COP *const cop|STRLEN *len +=for apidoc_item|const char *|CopLABEL_len_flags|COP *const cop|STRLEN *len|U32 *flags -Returns the label attached to a cop. +These return the label attached to a cop. -=for apidoc Am|const char *|CopLABEL_len|COP *const cop|STRLEN *len +C and C additionally store the number of +bytes comprising the returned label into C<*len>. -Returns the label attached to a cop, and stores its length in bytes into -C<*len>. - -=for apidoc Am|const char *|CopLABEL_len_flags|COP *const cop|STRLEN *len|U32 *flags - -Returns the label attached to a cop, and stores its length in bytes into -C<*len>. Upon return, C<*flags> will be set to either C or 0. +C additionally returns the UTF-8ness of the returned label, +by setting C<*flags> to 0 or C. =cut */ -- cgit v1.2.1