NAME
    IO::Adapter::Array - base class for IO emulation for ARRAY_REF.

SYNOPSIS
        use IO::Adapter::Array;

        $map = [ 'rudo', 'kenken', 'hitomi' ];
        $obj = new IO::Adapter::Array $map;
        $obj->open;
        while ($x = $obj->get_next_key) { print $x;}
        $obj->close;

DESCRIPTION
    emulate IO operation for the ARRAY_REF on memory. One array is similar
    to a set of primary keys without optional values such as a file:

        rudo
        kenken
        hitomi
          ...

METHODS
    "new()"
        constructor.

  
    "open($args)"
        open IO for the array ARRAY_REF. $args is a hash reference. The
        option follows:

           $args = {
                          flag => $flag
              _array_reference => ARRAY_REFERENCE
           }

        $flag is "r" only (read only) now.

  
    "getline()"
        should not use this ?

    "get_next_key()"
        return the next element of the array.

  getpos()
    return the current position in the array.

  setpos($pos)
    set the current position to $pos -th element.

  eof()
    whether the current position reaches the end of the array or not. If it
    already reaches the end, return 1.

  close()
    end of IO operation. It is a dummy.

CODING STYLE
    See "http://www.fml.org/software/FNF/" on fml coding style guide.

AUTHOR
    Ken'ichi Fukamachi

COPYRIGHT
    Copyright (C) 2001,2002,2003,2004,2005 Ken'ichi Fukamachi

    All rights reserved. This program is free software; you can redistribute
    it and/or modify it under the same terms as Perl itself.

HISTORY
    IO::Adapter::Array first appeared in fml8 mailing list driver package.
    See "http://www.fml.org/" for more details.

