The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Template::TAL::ValueParser - parse attribute values

SYNOPSIS

  my $string = "path:/foo/bar/0/baz";
  my $value = Template::TAL::ValueParser->value( $string );
  

DESCRIPTION

This module is responsible for parsing the values of attributes in templates, and returning them. It can also split multiple values up into a list, using semicolons as list seperators. The way that values are parsed is based very strongly on TALES (http://www.zope.org/Wikis/DevSite/Projects/ZPT/TALES) but the actual TALES spec is provided by the language module Template::TAL::Language::TALES.

METHODS

split( string )

commands in 'string' can be split by ';' characters, with raw semicolons represented as ';;'. This command splits the string on the semicolons, and de-escapes the ';;' pairs. For instance:

  foo; bar; baz;; narf

splits to:

  ['foo', 'bar', 'baz; narf']

Not technically part of TALES, I think, but really useful for TAL anyway.

value( expression, context arrayref, plugin arrayref )

parse a TALES expression in the first param, such as

  string:Hello there
  path:/a/b/c

using the passed contexts (in order) to look up path values. Contexts should be hashes, and we will look in each context for a defined key of the given path until we find one.

(note - I need the multiple contexts code because TAL lets you set globals in define statements, so I need a local context, and a global context)

The plugins value should be an arrayref of language plugins to ask about the various types of string. At a minimum, this should probably include Template::TAL::Language::TALES, or the module won't do a lot.

COPYRIGHT

Written by Tom Insam, Copyright 2005 Fotango Ltd. All Rights Reserved

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