1843200
  /   ˆl–Ðz¾”Jn-jq@5p ¸'ÔÅ£ÂƒÏ‡_‹uÐb&=LV[(ÂÁ K    #

package IO::Seekable;

=head1 NAME

IO::Seekable - supply seek based methods for I/O objects

=head1 SYNOPSIS

    use IO::Seekable;
    package IO::Something;
    @ISA = qw(IO::Seekable);

=head1 DESCRIPTION

C<IO::Seekable> does not have a constructor of its own as it is intended to
be inherited by other C<IO::Handle> based objects. It provides methods
which allow seeking of the file descriptors.

=over 4

=item $io->getpos

Returns an opaque value that represents the current position of the
IO::File, or C<undef> if this is not possible (eg an unseekable stream such
as a terminal, pipe or socket). If the fgetpos() function is available in
your C library it is used to implements getpos, else perl emulates getpos
using C's ftell() function.

=item $io->setpos

Uses the value of a previous getpos call to return to a previously visited
position. Returns "0 but true" on success, C<undef> on failure.

=back

See L<perlfunc> for complete descriptions of each of the following
supported C<IO::Seekable> methods, which are just front ends for the
corresponding built-in functions:

=over 4

=item $io->seek ( POS, WHENCE )

Seek the IO::File to position POS, relative to WHENCE:

=over 8

=item WHENCE=0 (SEEK_SET)

POS is absolute position. (Seek relative to the start of the file)

=item WHENCE=1 (SEEK_CUR)

POS is an offset from the current position. (Seek relative to current)

=item WHENCE=2 (SEEK_END)

POS is an offset from the end of the file. (Seek relative to end)

=back

The SEEK_* constants can be imported from the C<Fcntl> module if you
don't wish to use the numbers C<0> C<1> or C<2> in your code.

Returns C<1> upon success, C<0> otherwise.

=item $io->sysseek( POS, WHENCE )

Similar to $io->seek, but sets the IO::File's position using the system
call lseek(2) directly, so will confuse most perl IO operators except
sysread and syswrite (see L<perlfunc> for full details)

Returns the new position, or C<undef> on failure.  A position
of zero is returned as the string C<"0 but true">

=item $io->tell

Returns the IO::File's current position, or -1 on error.

=back

=head1 SEE ALSO

L<perlfunc>, 
L<perlop/"I/O Operators">,
L<IO::Handle>
L<IO::File>

=head1 HISTORY

Derived from FileHandle.pm by Graham Barr E<lt>gbarr@pobox.comE<gt>

=cut

use 5.008_001;
use Carp;
use strict;
use IO::Handle ();
# XXX we can't get these from IO::Handle or we'll get prototype
# mismatch warnings on C<use POSIX; use IO::File;> :-(
use Fcntl qw(SEEK_SET SEEK_CUR SEEK_END);
require Exporter;

our @EXPORT = qw(SEEK_SET SEEK_CUR SEEK_END);
our @ISA = qw(Exporter);

our $VERSION = "1.41";

sub seek {
    @_ == 3 or croak 'usage: $io->seek(POS, WHENCE)';
    seek($_[0], $_[1], $_[2]);
}

sub sysseek {
    @_ == 3 or croak 'usage: $io->sysseek(POS, WHENCE)';
    sysseek($_[0], $_[1], $_[2]);
}

sub tell {
    @_ == 1 or croak 'usage: $io->tell()';
    tell($_[0]);
}

1;
  #   ˆl–Ðz¾”d*j"Tâ�nãn\ ”Å£Ä„n>÷ÃÂ ?÷     # Test for checking the unicode maps corresponding to
# various fonts. Try
#	for i in 01 02 03 04 05 06 07 08 09 10
#	do
#		unicode_start iso$i.f16 iso$i
#		less -r utflist
#	done
#	unicode_stop
#
0020       SPACE
0021   !   EXCLAMATION MARK
0022   "   QUOTATION MARK
0023   #   NUMBER SIGN
0024   $   DOLLAR SIGN
0025   %   PERCENT SIGN
0026   &   AMPERSAND
0027   '   APOSTROPHE
0028   (   LEFT PARENTHESIS
0029   )   RIGHT PARENTHESIS
002a   *   ASTERISK
002b   +   PLUS SIGN
002c   ,   COMMA
002d   -   HYPHEN-MINUS
002e   .   FULL STOP
002f   /   SOLIDUS
0030   0   DIGIT ZERO
0031   1   DIGIT ONE
0032   2   DIGIT TWO
0033   3   DIGIT THREE
0034   4   DIGIT FOUR
0035   5   DIGIT FIVE
0036   6   DIGIT SIX
0037   7   DIGIT SEVEN
0038   8   DIGIT EIGHT
0039   9   DIGIT NINE
003a   :   COLON
003b   ;   SEMICOLON
003c   <   LESS-THAN SIGN
003d   =   EQUALS SIGN
003e   >   GREATER-THAN SIGN
003f   ?   QUESTION MARK
0040   @   COMMERCIAL AT
0041   A   LATIN CAPITAL LETTER A
0042   B   LATIN CAPITAL LETTER B
0043   C   LATIN CAPITAL LETTER C
0044   D   LATIN CAPITAL LETTER