NAME

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

VERSION

       Version 0.17

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 \"H\65llo\" 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.36.0                                       2023-08-02                                CSS::DOM::Util(3pm)