---
name: IO::Seekable
runtime: pp
source: src/native/IO/Seekable/pp.rs
---
```{index} single: IO::Seekable; Perl module (pp runtime)
```

# IO::Seekable

Native implementation of IO::Seekable

Provides seek/tell operations on filehandles compatible with Perl's IO::Seekable.
IO::Seekable is a mixin class inherited by IO::File and others.
All methods delegate to FILEHANDLE_TABLE via the shared `extract_fh_id()` helper.

# Functions

## seek

Sets the filehandle position. `$whence` is one of SEEK_SET (0),
SEEK_CUR (1), or SEEK_END (2). Returns 1 on success, 0 on failure.

```perl
use IO::Seekable;
$fh->seek(0, SEEK_SET);
```

## tell

Returns the current byte position in the filehandle, or -1 on error.

```perl
my $pos = $fh->tell();
```

## setpos

Sets the filehandle position to an absolute byte offset (equivalent to
`seek($pos, SEEK_SET)`). Returns 1 on success, 0 on failure.

```perl
$fh->setpos($saved_pos);
```

## getpos

Returns the current byte position, equivalent to `tell()`.
Intended for use with `setpos()` to save and restore positions.

```perl
my $pos = $fh->getpos();
# ... read some data ...
$fh->setpos($pos);
```

## SEEK_SET / SEEK_CUR / SEEK_END

Seek position constants (0, 1, 2). Exported both as constant subs
and package scalars.