---
name: "Xacobeo::Utils"
section: "3pm"
platform: "linux"
package: "xacobeo"
version: "0.15-3+b2"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/Xacobeo::Utils"
---

# Xacobeo::Utils(3pm)

Utilities.

## NAME

Xacobeo::Utils - Utilities.

## SYNOPSIS

```
        use Xacobeo::Utils qw(:dom :xml);

        if (isa_dom_text($node)) {
                my $text = escape_xml_text($node->nodeValue);
                print "$text\n";
        }
```

## DESCRIPTION

This package provides utility functions that are shared among the different modules in this project.

## IMPORTS

The following import tags are defined:

### :xml

Import the XML utilities.

### :dom

Imports the DOM utilities.

## FUNCTIONS

The following functions are available:

### escape\_xml\_text

Escapes the text as if would be added to a Text node. This function escapes only the entities \<, \> and &.

Parameters:

- •

  `$string`

  The string to escape.

### escape\_xml\_attribute

Escapes the text as if would be added to an Attribute. This function escapes the entities \<, \>, &, ' and ".

Parameters:

- •

  `$string`

  The string to escape.

### isa\_dom\_document

Returns true if the node is a DOM `"Document"` (instance of XML::LibXML::Document).

Parameters:

- •

  `$node`

  The node to check.

### isa\_dom\_element

Returns true if the node is a DOM `"Element"` (instance of XML::LibXML::Element).

Parameters:

- •

  `$node`

  The node to check.

### isa\_dom\_attr

Returns true if the node is a DOM `"Attribute"` (instance of XML::LibXML::Attr).

Parameters:

- •

  `$node`

  The node to check.

### isa\_dom\_nodelist

Returns true if the node is a DOM `"NodeList"` (instance of XML::LibXML::NodeList).

Parameters:

- •

  `$node`

  The node to check.

### isa\_dom\_text

Returns true if the node is a DOM `"Text"` (instance of XML::LibXML::Text).

**NOTE**: XML::LibXML considers that `"Comment"` and `"CDATA"` nodes are also `"Text"` nodes. This method doesn't consider a `"Comment"` nor a `"CDATA"` node as being `"Text"` nodes.

Parameters:

- •

  `$node`

  The node to check.

### isa\_dom\_comment

Returns true if the node is a DOM `"Comment"` (instance of XML::LibXML::Comment).

Parameters:

- •

  `$node`

  The node to check.

### isa\_dom\_node

Returns true if the node is a DOM `"Node"` (instance of XML::LibXML::Node).

Parameters:

- •

  `$node`

  The node to check.

### isa\_dom\_pi

Returns true if the node is a DOM `"PI"` (also known as: processing instruction) (instance of XML::LibXML::PI).

Parameters:

- •

  `$node`

  The node to check.

### isa\_dom\_dtd

Returns true if the node is a DOM `"DTD"` (instance of XML::LibXML::Dtd).

Parameters:

- •

  `$node`

  The node to check.

### isa\_dom\_cdata

Returns true if the node is a DOM `"CDATASection"` (instance of XML::LibXML::CDATASection).

Parameters:

- •

  `$node`

  The node to check.

### isa\_dom\_namespace

Returns true if the node is a `"Namespace"` (instance of XML::LibXML::Namespace).

**NOTE**: The DOM doesn't define an object type named `"Namespaces"` but XML::LibXML does so this function is named 'isa\_dom' for consistency with the other functions.

Parameters:

- •

  `$node`

  The node to check.

### isa\_dom\_literal

Returns true if the node is a `"Literal"` (instance of XML::LibXML::Literal).

**NOTE**: The DOM doesn't define an object type named `"Literal"` but XML::LibXML does so this function is named 'isa\_dom' for consistency with the other functions.

Parameters:

- •

  `$node`

  The node to check.

### isa\_dom\_boolean

Returns true if the node is a `"Boolean"` (instance of XML::LibXML::Boolean).

**NOTE**: The DOM doesn't define an object type named `"Boolean"` but XML::LibXML does so this function is named 'isa\_dom' for consistency with the other functions.

Parameters:

- •

  `$node`

  The node to check.

### isa\_dom\_number

Returns true if the node is a `"Number"` (instance of XML::LibXML::Number).

**NOTE**: The DOM doesn't define an object type named `"Number"` but XML::LibXML does so this function is named 'isa\_dom' for consistency with the other functions.

Parameters:

- •

  `$node`

  The node to check.

### scrollify

Wraps a widget in a scrolled window.

Parameters:

- •

  `$widget`

  The widget to wrap.

- •

  `$width`

  The width of the scroll window. If `"undef"` then -1 will be used.

- •

  `$height`

  The height of the scroll window. If `"undef"` then -1 will be used.

## AUTHORS

Emmanuel Rodriguez \<potyl@cpan.org\>.

## COPYRIGHT AND LICENSE

Copyright (C) 2008,2009 by Emmanuel Rodriguez.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.
