GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  DATA::DUMP::TRACE (3)

.ds Aq ’

NAME

Data::Dump::Trace - Helpers to trace function and method calls

CONTENTS

SYNOPSIS



  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->new;
  $ua->get("http://www.example.com")->dump;



DESCRIPTION

The following functions are provided:
autowrap( $class )
autowrap( $class => $prefix )
autowrap( $class1 => $prefix1, $class2 => $prefix2, ... )
autowrap( $class1 => \%info1, $class2 => \%info2, ... ) 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.

Alternative is to pass an %info hash for each class. The recognized keys are:
prefix => $string The prefix string used to name objects of this type.
proto => \%hash A hash of prototypes to use for the methods when an object is wrapped.

wrap( name => $str, func => \&func, proto => $proto )
wrap( name => $str, obj => $obj, proto => \%hash ) 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.

See Prototypes for description of the proto argument.

call( $name, \&func, $proto, @ARGS ) Calls the given function with the given arguments. The trace will use $name as the name of the function.

See Prototypes for description of the $proto argument.

mcall( $class, $method, $proto, @ARGS )
mcall( $object, $method, $proto, @ARGS ) Calls the given method with the given arguments.

See Prototypes for description of the $proto argument.

trace( $symbol, $prototype ) Replaces the function given by $symbol with a wrapped function.

    Prototypes

<B>Note: The prototype string syntax described here is experimental and likely to change in revisions of this interfaceB>.

The $proto argument to call() and mcall() 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 or out arguments. The general form for the prototype string is:



   <arguments> = <return_value>



The default prototype is @ = @; list of values as input and list of values as output.

The value ’%’ can be used for both arguments and return value to say that key/value pair style lists are used.

Alternatively, individual positional arguments can be listed each represented by a letter:
i input argument
o output argument
O both input and output argument
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.

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.

SEE ALSO

Data::Dump

AUTHOR

Copyright 2009 Gisle Aas.

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

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 DATA::DUMP::TRACE (3) 2013-05-16

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.