/usr/share/perl5/XML/Grove/AsCanonXML.pm is in libxml-grove-perl 0.46alpha-12.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 | #
# Copyright (C) 1998, 1999 Ken MacLeod
# XML::Grove::AsCanonXML is free software; you can redistribute it and/or
# modify it under the same terms as Perl itself.
#
# $Id: AsCanonXML.pm,v 1.6 1999/08/17 18:36:20 kmacleod Exp $
#
use strict;
package XML::Grove::AsCanonXML;
use vars qw{%char_entities};
use Data::Grove::Visitor;
%char_entities = (
"\x09" => '	',
"\x0a" => ' ',
"\x0d" => ' ',
'&' => '&',
'<' => '<',
'>' => '>',
'"' => '"',
);
sub new {
my $class = shift;
my $self = ($#_ == 0) ? { %{ (shift) } } : { @_ };
return bless $self, $class;
}
sub as_canon_xml {
my $self = shift; my $object = shift; my $fh = shift;
if (defined $fh) {
return ();
} else {
return join('', $object->accept($self, $fh));
}
}
sub visit_document {
my $self = shift; my $document = shift;
return $document->children_accept($self, @_);
}
sub visit_element {
my $self = shift; my $element = shift; my $fh = shift;
my @return;
push @return, $self->_print($fh, '<' . $element->{Name});
my $key;
my $attrs = $element->{Attributes};
foreach $key (sort keys %$attrs) {
push @return, $self->_print($fh,
" $key=\"" . $self->_escape($attrs->{$key}) . '"');
}
push @return, $self->_print($fh, '>');
push @return, $element->children_accept($self, $fh, @_);
push @return, $self->_print($fh, '</' . $element->{Name} . '>');
return @return;
}
sub visit_entity {
# entities don't occur in text
return ();
}
sub visit_pi {
my $self = shift; my $pi = shift; my $fh = shift;
return $self->_print($fh, '<?' . $pi->{Target} . ' ' . $pi->{Data} . '?>');
}
sub visit_comment {
my $self = shift; my $comment = shift; my $fh = shift;
if ($self->{Comments}) {
return $self->_print($fh, '<!--' . $comment->{Data} . '-->');
} else {
return ();
}
}
sub visit_characters {
my $self = shift; my $characters = shift; my $fh = shift;
return ($self->_print($fh, $self->_escape($characters->{Data})));
}
sub _print {
my $self = shift; my $fh = shift; my $string = shift;
if (defined $fh) {
$fh->print($string);
return ();
} else {
return ($string);
}
}
sub _escape {
my $self = shift; my $string = shift;
$string =~ s/([\x09\x0a\x0d&<>"])/$char_entities{$1}/ge;
return $string;
}
package XML::Grove;
sub as_canon_xml {
my $xml_object = shift;
return XML::Grove::AsCanonXML->new(@_)->as_canon_xml($xml_object);
}
1;
__END__
=head1 NAME
XML::Grove::AsCanonXML - output XML objects in canonical XML
=head1 SYNOPSIS
use XML::Grove::AsCanonXML;
# Using as_canon_xml method on XML::Grove objects:
$string = $xml_object->as_canon_xml( OPTIONS );
# Using an XML::Grove::AsCanonXML instance:
$writer = XML::Grove::AsCanonXML->new( OPTIONS );
$string = $writer->as_canon_xml($xml_object);
$writer->as_canon_xml($xml_object, $file_handle);
=head1 DESCRIPTION
C<XML::Grove::AsCanonXML> will return a string or write a stream of
canonical XML for an XML object and it's content (if any).
C<XML::Grove::AsCanonXML> objects hold the options used for writing
the XML objects. Options can be supplied when the the object is
created,
$writer = XML::Grove::AsCanonXML->new( Comments => 1 );
or modified at any time before writing an XML object by setting the
option directly in the `C<$writer>' hash.
=head1 OPTIONS
=over 4
=item Comments
By default comments are not written to the output. Setting comment to
TRUE will include comments in the output.
=back
=head1 AUTHOR
Ken MacLeod, ken@bitsko.slc.ut.us
=head1 SEE ALSO
perl(1), XML::Parser(3), XML::Grove(3).
James Clark's Canonical XML definition
<http://www.jclark.com/xml/canonxml.html>
=cut
|