included sample marc file from MARC-Record-2.0

[MARC-Fast] / Fast.pm

diff --git a/Fast.pm b/Fast.pm
index e9a7142..b587be3 100644 (file)
--- a/Fast.pm
+++ b/Fast.pm
@@ -1,5 +1,5 @@
-
 package MARC::Fast;
+
 use strict;
 use Carp;
 use Data::Dumper;
@@ -7,7 +7,7 @@ use Data::Dumper;
 BEGIN {
        use Exporter ();
        use vars qw ($VERSION @ISA @EXPORT @EXPORT_OK %EXPORT_TAGS);
-       $VERSION     = 0.04;
+       $VERSION     = 0.08;
        @ISA         = qw (Exporter);
        #Give a hoot don't pollute, do not export more than needed by default
        @EXPORT      = qw ();
@@ -23,12 +23,21 @@ MARC::Fast - Very fast implementation of MARC database reader
 
   use MARC::Fast;
 
+  my $marc = new MARC::Fast(
+       marcdb => 'unimarc.iso',
+  );
+
+  foreach my $mfn ( 1 .. $marc->count ) {
+       print $marc->to_ascii( $mfn );
+  }
+
+For longer example with command line options look at L<scripts/dump_fastmarc.pl>
 
 =head1 DESCRIPTION
 
 This is very fast alternative to C<MARC> and C<MARC::Record> modules.
 
-It's is also very sutable for random access to MARC records (as opposed to
+It's is also very subtable for random access to MARC records (as opposed to
 sequential one).
 
 =head1 METHODS
@@ -111,7 +120,7 @@ sub new {
                print STDERR "REC ",$self->{count},": $leader\n" if ($self->{debug});
 
                # store leader for later
-               push @{$self->{leaders}}, $leader;
+               push @{$self->{leader}}, $leader;
 
                # skip to next record
                my $o = substr($leader,0,5);
@@ -145,14 +154,22 @@ Fetch record from database
 
   my $hash = $marc->fetch(42);
 
+First record number is C<1>
+
 =cut
 
 sub fetch {
        my $self = shift;
 
-       my $rec_nr = shift || return;
+       my $rec_nr = shift;
 
-       my $leader = $self->{leaders}->[$rec_nr - 1];
+       if ( ! $rec_nr ) {
+               $self->{last_leader} = undef;
+               return;
+       }
+
+       my $leader = $self->{leader}->[$rec_nr - 1];
+       $self->{last_leader} = $leader;
        unless ($leader) {
                carp "can't find record $rec_nr";
                return;
@@ -234,6 +251,26 @@ sub fetch {
 }
 
 
+=head2 last_leader
+
+Returns leader of last record L<fetch>ed
+
+  print $marc->last_leader;
+
+Added in version 0.08 of this module, so if you need it use:
+
+  use MARC::Fast 0.08;
+
+to be sure that it's supported.
+
+=cut
+
+sub last_leader {
+       my $self = shift;
+       return $self->{last_leader};
+}
+
+
 =head2 to_hash
 
 Read record with specified MFN and convert it to hash
@@ -313,17 +350,32 @@ sub to_hash {
        return $rec;
 }
 
+=head2 to_ascii
 
-1;
-__END__
+  print $marc->to_ascii( 42 );
 
-=head1 BUGS
+=cut
+
+sub to_ascii {
+       my $self = shift;
 
+       my $mfn = shift || confess "need mfn";
+       my $row = $self->fetch($mfn) || return;
 
+       my $out;
 
-=head1 SUPPORT
+       foreach my $f (sort keys %{$row}) {
+               my $dump = join('', @{ $row->{$f} });
+               $dump =~ s/\x1e$//;
+               $dump =~ s/\x1f/\$/g;
+               $out .= "$f\t$dump\n";
+       }
 
+       return $out;
+}
 
+1;
+__END__
 
 =head1 AUTHOR
 
@@ -343,6 +395,6 @@ LICENSE file included with this module.
 
 =head1 SEE ALSO
 
-perl(1).
+L<Biblio::Isis>, perl(1).
 
 =cut