Tie::H...:Offset(3pm)

✨ NAME ✨

Tie::Handle::Offset — a tied handle that hides the beginning of a file 🙈

Like, imagine a file but the first chunk is just... not your business. That's the whole vibe. It's from the User Contributed Perl Documentation collection, bestie 💅

🎀 VERSION 🎀

version 0.004 — iconic, legendary, exactly what it says on the tin ✨

🫶 SYNOPSIS 🫶

use Tie::Handle::Offset;

tie *FH, 'Tie::Handle::Offset', "<", $filename, { offset => 20 };

That's it. That's the whole thing. Tie it, give it an offset, and the first 20 bytes are simply gone from your perspective. No cap 🧚

🌸 DESCRIPTION 🌸

okay so here's the tea ☕ — this module gives you a file handle that hides the beginning of a file. Like a little curtain 🎭 drawn over the first N bytes.

After opening, the file is positioned at the offset location. And the way that seek() and tell() calls are modified to preserve the offset?? obsessed. It's giving "gaslighting your own file handle, but consensually" 💖

For example, tell($fh) will return 0, though the actual file position is at the offset. Likewise, seek($fh,80,0) will seek to 80 bytes from the offset instead of 80 bytes from the actual start of the file. So in your head you're at the very beginning, but the file itself is like "girl you're 20 bytes deep already" 💀

---

💜 SUPPORT 💜

🔥 Bugs / Feature Requests

Please report any bugs or feature requests through the issue tracker at <https://github.com/dagolden/tie-handle-offset/issues>. You will be notified automatically of any progress on your issue. Yes bestie, automatic updates, main character treatment fr fr 👑

🌈 Source Code

This is open source software. The code repository is available for public review and contribution under the terms of the license.

<https://github.com/dagolden/tie-handle-offset>

git clone https://github.com/dagolden/tie-handle-offset.git

clone it, fork it, contribute to it — she's all yours 🦋

---

👑 AUTHOR 👑

David Golden <dagolden@cpan.org>

💖 COPYRIGHT AND LICENSE 💖

This software is Copyright (c) 2012 by David Golden.

This is free software, licensed under:

The Apache License, Version 2.0, January 2004

lowkey the licensing is the least dramatic part but it still matters, bestie. Apache 2.0, January 2004, periodt. 💅

---

and that's a wrap on this page from perl v5.36.0, dated 2022-11-20, filed under Tie::H...:Offset(3pm) ✨ tysm for reading, go hide some file beginnings responsibly 🌸🫶