# MARC::File::MicroLIF - phpMan

## NAME
    [MARC::File::MicroLIF] - MicroLIF-specific file handling

## SYNOPSIS
        use [MARC::File::MicroLIF];

        my $file = [MARC::File::MicroLIF]->in( $filename );

        while ( my $marc = $file->next() ) {
            # Do something
        }
        $file->close();
        undef $file;

## EXPORT
    None.

    The buffer must be large enough to handle any valid record because we
    don't check for cases like a CR/LF pair or an end-of-record/CR/LF trio
    being only partially in the buffer.

    The max valid record is the max MARC record size (99999) plus one or two
    characters per tag (CR, LF, or CR/LF). It's hard to say what the max
    number of tags is, so here we use 6000. (6000 tags can be squeezed into
    a MARC record only if every tag has only one subfield containing a
    maximum of one character, or if data from multiple tags overlaps in the
    MARC record body. We're pretty safe.)

## METHODS
  in()
    Opens a MicroLIF file for reading.

    Gets the next chunk of data. If $want_line is true then you get the next
    chunk ending with any combination of \r and \n of any length. If it is
    false or not passed then you get the next chunk ending with \x60
    followed by any combination of \r and \n of any length.

    All trailing \r and \n are stripped.

  header()
    If the MicroLIF file has a file header then the header is returned. If
    the file has no header or the file has not yet been opened then "undef"
    is returned.

  decode()
    Decodes a MicroLIF record and returns a USMARC record.

    Can be called in one of three different ways:

        $object->decode( $lif )
        [MARC::File::MicroLIF]->decode( $lif )
        [MARC::File::MicroLIF::decode]( $lif )

## TODO
## RELATED MODULES
    [MARC::File]

## LICENSE
    This code may be distributed under the same terms as Perl itself.

    Please note that these modules are not products of or supported by the
    employers of the various contributors to the code.

## AUTHOR
    Andy Lester, "<<andy@petdance.com>>"