Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Devel::Events::Match(3User Contributed Perl DocumentatiDevel::Events::Match(3)

NAME
       Devel::Events::Match - Event matching, splicing and dicing.

VERSION
       version 0.09

SYNOPSIS
	       use Devel::Events::Match;

	       my $matcher = Devel::Events::Match->new;

	       my @matching = $matcher->grep( match => $cond, events =>	\@events );

DESCRIPTION
       This class provides event list filtering, chunking etc based on a
       simple match format.

       This class is used by Devel::Events::Handler::Log::Memory in order to
       ease access into	the event log.

METHODS
       compile_cond
	   Used	to compile condition values into code references.

	   Scalars become equality tests on the	first element (event type/name
	   matches this).

	   Hashes become recursive conditions, where each key is matched on
	   the field. The 'type' pseudofield is	the first element of the
	   event. Every	value in the hash gets "compile_cond" called on	it
	   recursively.

	   Code	references are returned	verbatim.

	   The output is a code	reference that can be used to match events.

       first %args
	   Return the first event that matches a certain condition.

	   Requires the	"match"	and "events" parameters.

       grep %args
	   Return the list of events that match	a certain condition.

	   Requires the	"match"	and "events" parameters.

       limit from => $cond, to => $cond, %args
	   Return events between two events. If	"from" or "to" is omitted then
	   it returns all the events up	to or from the other filter ("from"
	   defaults to "sub { 1	}" and "to" defaults to	"sub { 0 }").

	   If either the "from_inclusive" and "to_inclusive" parameters	are
	   provided and	set to false then the range will only begin on the
	   event after the "from" match	and end	on the event before the	"to"
	   match respectively.

	   Requires the	"events" parameter.

       chunk %args
	   Cuts	the event log into chunks. When	$marker	matches	a new chunk is
	   opened.

	   Requires the	"marker" and "events" parameters.

	   The "first" and "last" parameters, when provided and	false will
	   cause the first and last chunks to be dropped, respectively.

	   The first chunk contains all	the events up to the first matching
	   one.

       take_while %args
       take_until %args
       drop_while %args
       drop_until %args
	   Require the "match" and "events" parameters.

SUPPORT
       Bugs may	be submitted through the RT bug	tracker
       <https://rt.cpan.org/Public/Dist/Display.html?Name=Devel-Events>	(or
       bug-Devel-Events@rt.cpan.org <mailto:bug-Devel-Events@rt.cpan.org>).

AUTHOR
       XXXX XXX'XX (Yuval Kogman) <nothingmuch@woobling.org>

COPYRIGHT AND LICENCE
       This software is	copyright (c) 2007 by XXXX XXX'XX (Yuval Kogman).

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

perl v5.32.1			  2018-03-27	       Devel::Events::Match(3)

NAME | VERSION | SYNOPSIS | DESCRIPTION | METHODS | SUPPORT | AUTHOR | COPYRIGHT AND LICENCE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Devel::Events::Match&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help