{"id":7168,"date":"2022-12-20T19:35:42","date_gmt":"2022-12-20T22:35:42","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/datadumptrace-man3\/"},"modified":"2022-12-20T19:35:42","modified_gmt":"2022-12-20T22:35:42","slug":"datadumptrace-man3","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/datadumptrace-man3\/","title":{"rendered":"Data::Dump::Trace (man3)"},"content":{"rendered":"

Data::Dump::Trace<\/h1>\n

NAME<\/a>
SYNOPSIS<\/a>
DESCRIPTION<\/a>
SEE ALSO<\/a>
AUTHOR<\/a> <\/p>\n

\n

NAME <\/a> <\/h2>\n

Data::Dump::Trace \u2212 Helpers to trace function and method calls<\/p>\n

SYNOPSIS <\/a> <\/h2>\n

use Data::Dump::Trace qw(autowrap mcall);
autowrap(“LWP::UserAgent” => “ua”, “HTTP::Response” => “res”);
use LWP::UserAgent;
$ua = mcall(LWP::UserAgent => “new”); # instead of LWP::UserAgent\u2212>new;
$ua\u2212>get(“http:\/\/www.example.com”)\u2212>dump;<\/p>\n

DESCRIPTION <\/a> <\/h2>\n

The following functions are provided:
autowrap( $class )
autowrap( $class => $prefix )
autowrap( $class1 => $prefix1, $class2 => $prefix2, … )
autowrap( $class1 => %info1, $class2 => %info2, … )<\/p>\n

Register classes whose objects are automatically wrapped when returned by one of the call functions below. If $prefix is provided it will be used as to name the objects.<\/p>\n

Alternative is to pass an %info hash for each class. The recognized keys are:
prefix => $string<\/p>\n

The prefix string used to name objects of this type.<\/p>\n

proto => %hash<\/p>\n

A hash of prototypes to use for the methods when an object is wrapped.<\/p>\n

wrap( name => $str, func => &func, proto => $proto )
wrap( name => $str, obj => $obj, proto => %hash )<\/p>\n

Returns a wrapped function or object. When a wrapped function is invoked then a trace is printed after the underlying function has returned. When a method on a wrapped object is invoked then a trace is printed after the methods on the underlying objects has returned.<\/p>\n

See “Prototypes” for description of the “proto” argument.<\/p>\n

call( $name, &func, $proto, @ARGS )<\/p>\n

Calls the given function with the given arguments. The trace will use $name as the name of the function.<\/p>\n

See “Prototypes” for description of the $proto argument.<\/p>\n

mcall( $class, $method, $proto, @ARGS )
mcall( $object, $method, $proto, @ARGS )<\/p>\n

Calls the given method with the given arguments.<\/p>\n

See “Prototypes” for description of the $proto argument.<\/p>\n

trace( $symbol, $prototype )<\/p>\n

Replaces the function given by $symbol with a wrapped function.<\/p>\n

Prototypes
Note: The prototype string syntax described here is experimental and likely to change in revisions of this interface<\/b>.<\/p>\n

The $proto argument to call()<\/b> and mcall()<\/b> can optionally provide a prototype for the function call. This give the tracer hints about how to best format the argument lists and if there are in\/out<\/i> or out<\/i> arguments. The general form for the prototype string is:<\/p>\n

= <\/p>\n

The default prototype is “@ = @”; list of values as input and list of values as output.<\/p>\n

The value \u2019%\u2019 can be used for both arguments and return value to say that key\/value pair style lists are used.<\/p>\n

Alternatively, individual positional arguments can be listed each represented by a letter:<\/p>\n\n\n\n\n
<\/td>\n\n

“i”<\/p>\n<\/td>\n

<\/td>\n\n

input argument<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

“o”<\/p>\n<\/td>\n

<\/td>\n\n

output argument<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

“O”<\/p>\n<\/td>\n

<\/td>\n\n

both input and output argument<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

If the return value prototype has “!” appended, then it signals that this function sets errno ($!) when it returns a false value. The trace will display the current value of errno in that case.<\/p>\n

If the return value prototype looks like a variable name (with “$” prefix), and the function returns a blessed object, then the variable name will be used as prefix and the returned object automatically traced.<\/p>\n

SEE ALSO <\/a> <\/h2>\n

Data::Dump<\/p>\n

AUTHOR <\/a> <\/h2>\n

Copyright 2009 Gisle Aas.<\/p>\n

This library is free software; you can redistribute it and\/or modify it under the same terms as Perl itself.<\/p>\n

\n","protected":false},"excerpt":{"rendered":"

Data::Dump::Trace \u2212 Helpers to trace function and method calls <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[3502,3007],"class_list":["post-7168","post","type-post","status-publish","format-standard","hentry","category-sin-categoria","tag-datadumptrace","tag-man3"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/7168","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=7168"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/7168\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=7168"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=7168"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=7168"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}