Gnome2:...:Handle(3)

📦
version 1.084 · 2 versions
, in fedora 43

💖 NAME 💖

okay bestie, so this page is all about Gnome2::VFS::Async::Handle — like, the async handle situation in the Gnome2::VFS Perl bindings, fr fr. It's a User Contributed Perl Documentation page, which is giving very "the community came through" energy. 🫶

✨ METHODS ✨

🌸 $handle->cancel

that's it. that's the method. no args, no drama, she just cancels. iconic behaviour honestly. 💅

🎀 $handle->close ($func, $data=undef)

closing time, bestie! 🚪 here's what you pass in:

  • $func (scalar) — your callback function, the lil guy who runs when it's done
  • $data (scalar) — optional extra data you wanna hand over (defaults to undef)

🦋 $handle->read ($bytes, $func, $data=undef)

reading era 📖 and the args are:

  • $bytes (integer) — how many bytes we're pulling
  • $func (scalar) — the callback
  • $data (scalar) — optional, defaults to undef

🌈 $handle->seek ($whence, $offset, $func, $data=undef)

the way that seek needs SO many things, like girl why 😭 here's the whole lineup:

  • $whence (Gnome2::VFS::SeekPosition) — where you're seeking from
  • $offset (unsigned) — how far you're going
  • $func (scalar) — the callback
  • $data (scalar) — optional, undef by default
⭐ lowkey important: this one has been around Since: vfs 2.6

💜 $handle->write ($buffer, $bytes, $func, $data=undef)

writing era ✍️ and yes, she takes four things:

  • $buffer (string) — the actual content you're writing
  • $bytes (integer) — how many bytes
  • $func (scalar) — the callback
  • $data (scalar) — optional, defaults to undef

🎀 ENUMS AND FLAGS 🎀

👑 enum Gnome2::VFS::SeekPosition

the seek positions, all three of them, no gatekeeping:

  • 'start' / 'GNOME_VFS_SEEK_START' — from the top, like a fresh start bestie 🌅
  • 'current' / 'GNOME_VFS_SEEK_CURRENT' — right where you're at rn 📍
  • 'end' / 'GNOME_VFS_SEEK_END' — from the very end, periodt 🏁

💀 SEE ALSO 💀

  • Gnome2::VFS — go check her out if you want the full picture, iykyk

Copyright (C) 2003-2007, 2013 by the gtk2-perl team. 💖

This software is licensed under the LGPL. See Gnome2::VFS for a full notice. (yes, the actual full notice, go read it, I'm not retyping the whole thing, that's a you-and-Gnome2::VFS moment 🫶)

okay that's the whole page, bestie!! no cap, you're now fully caught up on Gnome2::VFS::Async::Handle. go slay ✨

this was perl v5.42.0, dated 2025-07-25 — mwah, love u, bye! 🎀💅🦋

📦 where this page comes from