debian man page for css::dom::util

CSS::DOM::Util(3pm)					User Contributed Perl Documentation				       CSS::DOM::Util(3pm)

NAME
       CSS::DOM::Util - Utility functions for dealing with CSS tokens

VERSION
       Version 0.14

SYNOPSIS
	 use CSS::DOM::Util ':all';
	 # or:
	 use CSS::DOM::Util qw[
	   escape unescape
	   escape_ident unescape_url
	   escape_str unescape_str
	 ];

DESCRIPTION
       This module provides utility functions for dealing with CSS tokens.

FUNCTIONS
       All functions below that take one argument have a "($)" prototype, so they have the same precedence as "closedir" and "delete".

       escape $string, $chars_to_escape
	   This escapes any characters in $string that occur in $chars_to_escape, which is interpreted as a regular expression. The regexp must
	   consume just one character; otherwise you'll find chars missing from the output. ASCII vertical whitespace (except the vertical tab) is
	   always escaped.

	   Printable non-alphanumeric ASCII characters and the space character are escaped with a single backslash. Other characters are encoded
	   in hexadecimal.

	   "escape" also considers that you might want to include the escaped string in a larger string, so it appends a space if the escaped
	   string ends with a hexadecimal escape with fewer than six digits.

       unescape $string
	   This turns something like "H65llo" into "Hello" (including quotes).

       escape_ident $string
       escape_ident $string, $more_chars_to_escape
	   This escapes $string as a CSS identifier, escaping also any characters matched by $more_chars_to_escape.

       unescape_url $url_token
	   Returns the URL that the token represents.

       escape_str $string
	   Returns a CSS string token containing $string (within quotes; characters possibly escaped).

       unescape_str $string_token
	   Returns the value that a CSS string token represents.

SEE ALSO
       CSS::DOM

perl v5.10.1							    2010-12-10						       CSS::DOM::Util(3pm)