NAME

XML::Entities - Decode strings with XML entities

SYNOPSIS

use XML::Entities;

$a = "Tom & Jerry © Warner Bros."
XML::Entities::decode($a);

DESCRIPTION

Based upon the HTML::Entities module by Gisle Aas

This module deals with decoding of strings with XML character entities. The module provides one function:

decode( $entity_set, $string, ... )

This routine replaces XML entities from $entity_set found in the $string with the corresponding Unicode character. Unrecognized entities are left alone.

The $entity_set can either be a name of an entity set - the selection of which can be obtained by XML::Entities::Data::names(), or "all" for a union, or alternatively a hashref which maps entity names (without leading &'s) to the corresponding Unicode characters (or strings).

If multiple strings are provided as argument they are each decoded separately and the same number of strings are returned.

If called in void context the arguments are decoded in-place.

XML::Entities::Data

The list of entities is defined in the XML::Entities::Data module. The list can be generated from the w3.org definition (or any other). Check perldoc XML::Entities::Data for more details.

SEE ALSO

HTML::Entities, XML::Entities::Data

COPYRIGHT

Copyright 2007 Oldrich Kruza Oldrich.Kruza@sixtease.net. All rights reserved.

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