---
name: "CSS::DOM::Util"
section: "3pm"
platform: "linux"
package: "libcss-dom-perl"
version: "0.17-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/CSS::DOM::Util"
---

# CSS::DOM::Util(3pm)

Utility functions for dealing with CSS tokens

## 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