diff --git a/sv.c b/sv.c index 5e0158f39e75..9df76f0eaea7 100644 --- a/sv.c +++ b/sv.c @@ -8128,21 +8128,27 @@ Perl_sv_eq_flags(pTHX_ SV *sv1, SV *sv2, const U32 flags) } /* -=for apidoc sv_streq_flags +=for apidoc sv_streq +=for apidoc_item sv_streq_flags -Returns a boolean indicating whether the strings in the two SVs are -identical. If the flags argument has the C bit set, it handles -get-magic too. Will coerce its args to strings if necessary. Treats -C as undef. Correctly handles the UTF8 flag. +These each return a boolean indicating whether the strings in the two SVs are +identical. + +C is the more general form, having a C argument that +affects its behavior in two ways. It coerces its args to strings if necessary, +treating a C argument as C. It correctly handles the UTF8 flag. + +If C has the C bit set, 'get' magic will be handled. If flags does not have the C bit set, an attempt to use C overloading will be made. If such overloading does not exist or the flag is set, then regular string comparison will be used instead. -=for apidoc sv_streq +C merely calls C with C set to just +C. This function basically behaves like the Perl code +S>. -A convenient shortcut for calling C with the C -flag. This function basically behaves like the Perl code C<$sv1 eq $sv2>. +=for apidoc Amnh||SV_SKIP_OVERLOAD =cut */