NAME
PICA::XMLParser - Parse PICA+ XML
SYNOPSIS
my $rcount = 1;
my $parser = PICA::XMLParser->new(
Field => \&field_handler,
Record => \&record_handler
);
$parser->parsefile($filename);
# equivalent:
PICA::Parser->parsefile($filename,
Field => \&field_handler,
Record => \&record_handler,
Format => 'xml'
);
sub field_handler {
my $field = shift;
print $field->to_string();
# no need to save the field so do not return it
}
sub record_handler {
print "$rcount\n"; $rcount++;
}DESCRIPTION
This module contains a parser to parse PICA+ XML. Up to now PICA+ XML is not fully standarized yet so this parser may slightly change in the future.
PUBLIC METHODS
new ( [ %params ] )
Creates a new Parser. See PICA::Parser for a description of parameters to define handlers (Field and Record).
parsedata
Parses data from a string, array reference or function. Data from arrays and functions will be read and buffered before parsing. Do not directly call this method without a PICA::XMLParser object that was created with new().
parsefile ( $filename | $handle )
Parses data from a file or filehandle or IO::Handle.
records ( )
Get an array of the read records (if they have been stored)
counter ( )
Get the number of read records so far. Please note that the number of records as returned by the records method may be lower because you may have filtered out some records.
finished ( )
Return whether the parser will not parse any more records. This is the case if the number of read records is larger then the limit.
PRIVATE HANDLERS
Do not directly call this methods.
init_handler
Called at the beginning.
final_handler
Called at the end. Does nothing so far.
start_handler
Called for each start tag.
end_handler
Called for each end tag.
char_handler
Called for character data.
_getHandlers
Get the handlers (init_handler, final_handler, start_handler, end_handler, char_handler).
_getPosition
Get the current position (file name and line number).
AUTHOR
Jakob Voss <jakob.voss@gbv.de>
LICENSE
Copyright (C) 2007-2009 by Verbundzentrale Goettingen (VZG) and Jakob Voss
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.