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

FreeBSD Manual Pages

  
 
  

home | help
Petal::Hash::Test(3)  User Contributed Perl Documentation Petal::Hash::Test(3)

NAME
       Petal::Hash::Test - Test	and Tutorial Petal modifier

SUMMARY
       Petal modifiers are snippets of code which are used to extend the
       expression engine capabilities. This test shows how to write your own
       modifiers.

API
       The modifier API	is very, very simple. It consists of two elements:

   The package name
       Your modifier should be called Petal::Hash::<SomeThing>,	where
       <SomeThing> is the name that you	want to	give to	your modifier.

       For example, this modifier is called Petal::Hash::Test. Petal will
       automatically pick it the module	up and assign it the 'test:' prefix.

	   package Petal::Hash::Test;
	   use warnings;
	   use strict;

   The method $class->process ($hash, $argument);
       This class method will define the modifier in itself.

       * $class	is the package name of your modifier (which might come in
       handy if	you're subclassing a modifier),

       * $hash is the execution	context, i.e. the objects and data which will
       'fill' your template,

       * $argument is whatever was after your modifier's prefix. For example,
       for the expression 'test:foo bar', $argument would be 'foo bar'.

       In this test / tutorial we're going to write a modifier which
       uppercases a Petal expression.

	 sub process
	 {
	     my	$class	  = shift;
	     my	$hash	  = shift;
	     my	$argument = shift;

	     return uc ($hash->get ($argument));
	 }

	 1;

	 __END__

       And that's it! Simple!

AUTHOR
       Jean-Michel Hiver

       This module is redistributed under the same license as Perl itself.

SEE ALSO
       The template hash module:

	 Petal::Hash

perl v5.32.1			  2020-05-20		  Petal::Hash::Test(3)

NAME | SUMMARY | API | AUTHOR | SEE ALSO

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

home | help