use Biblio::Isis;

  my $isis = new Biblio::Isis(
        isisdb => './cds/cds',
  );

  for(my $mfn = 1; $mfn <= $isis->count; $mfn++) {
        print $isis->to_ascii($mfn),"\n";
  }

It can create hash values from data in ISIS database (using "to_hash"), ASCII dump (using "to_ascii") or just hash with field names and packed values (like "^asomething^belse").

Unique feature of this module is ability to "include_deleted" records. It will also skip zero sized fields (OpenIsis has a bug in XS bindings, so fields which are zero sized will be filled with random junk from memory).

It also has support for identifiers (only if ISIS database is created by IsisMarc), see "to_hash".

This module will always be slower than OpenIsis module which use C library. However, since it's written in perl, it's platform independent (so you don't need C compiler), and can be easily modified. I hope that it creates data structures which are easier to use than ones created by OpenIsis, so reduced time in other parts of the code should compensate for slower performance of this module (speed of reading ISIS database is rarely an issue).

METHODS

new

Options are described below:

count

fetch

Returns hash with keys which are field names and values are unpacked values for that field like this:

  $rec = {
    '210' => [ '^aNew York^cNew York University press^dcop. 1988' ],
    '990' => [ '2140', '88', 'HAY' ],
  };

mfn

to_ascii

This outputs something like this:

  210   ^aNew York^cNew York University press^dcop. 1988
  990   2140
  990   88
  990   HAY

If "read_fdt" is specified when calling "new" it will display field names from ".FDT" file instead of numeric tags.

to_hash

It has ability to convert characters (using "hash_filter") from ISIS database before creating structures enabling character re-mapping or quick fix-up of data.

This function returns hash which is like this:

  $hash = {
    '210' => [
               {
                 'c' => 'New York University press',
                 'a' => 'New York',
                 'd' => 'cop. 1988'
               }
             ],
    '990' => [
               '2140',
               '88',
               'HAY'
             ],
  };

You can later use that hash to produce any output from ISIS data.

If database is created using IsisMarc, it will also have to special fields which will be used for identifiers, "i1" and "i2" like this:

  '200' => [
             {
               'i1' => '1',
               'i2' => ' '
               'a' => 'Goa',
               'f' => 'Valdo D\'Arienzo',
               'e' => 'tipografie e tipografi nel XVI secolo',
             }
           ],

In case there are repeatable subfields in record, this will create following structure:

  '900' => [ {
        'a' => [ 'foo', 'bar', 'baz' ],
  }]

Or in more complex example of

  902   ^aa1^aa2^aa3^bb1^aa4^bb2^cc1^aa5

it will create

  902   => [
        { a => ["a1", "a2", "a3", "a4", "a5"], b => ["b1", "b2"], c => "c1" },
  ],

This behaviour can be changed using "join_subfields_with" option to ``new'', in which case "to_hash" will always create single value for each subfield. This will change result to:

This method will also create additional field 000 with MFN.

There is also more elaborative way to call "to_hash" like this:

  my $hash = $isis->to_hash({
        mfn => 42,
        include_subfields => 1,
  });

Each option controll creation of hash:

tag_name

read_cnt

This function is not used by module (".CNT" files are not required for this module to work), but it can be useful to examine your index (while debugging for example).

unpack_cnt

This will fill $self object under "cnt" with hash. It's used by "read_cnt".

VERSIONS

  use Biblio::Isis 0.23

Below is list of changes in specific version of module (so you can target older versions if you really have to):

The full text of the license can be found in the LICENSE file included with this module.