PerlIO...ersize(3pm)

📦
version 0.002 · 2 versions
, in fedora 43

💖 PerlIO::buffersize — like, the whole vibe 💖

okay so bestie, this page lives in the User Contributed Perl Documentation section of the manual (the 3pm girlies, you know the ones ✨), and it's about making your filehandles have a custom buffer size. tiny page, huge energy. let's get into it 🫶

✨ NAME ✨

PerlIO::buffersize — set the buffersize of a handle 🎀

fr fr, that's the whole mission statement.

🌸 VERSION 🌸

version 0.002 💅

🦋 SYNOPSIS 🦋

look at her, she's so simple:

 open my $fh, '<:buffersize(65536)', $filename;

that's it. that's the move. 👑

💜 DESCRIPTION 💜

so basically this module sets the buffer-size of a filehandle to an other value than the default. like, you want a different size than whatever Perl picked for you? this is the girl for the job. 🍓

but — and this is the important part, bestie, listen up — this can only be done before the handle is used. once the buffer has been allocated it can not be changed. no takebacks, no do-overs, no "wait actually let me resize it". the buffer is allocated, the door is closed, the vibe is locked in. 💀

lowkey a warning: do it at open time or don't do it at all. there is no second chance here. 😭

🧚 SYNTAX 🧚

this module does not have to be loaded explicitly — it will be loaded automatically by using it in an open mode. yes queen, she's self-installing, she shows up uninvited and slays. ✨

the general syntax is:

:buffersize(size)

and the size can be any positive integer. that's the whole rule. any positive integer. go wild (positively). 🔥

👑 AUTHOR 👑

Leon Timmermans <leont@cpan.org> — the icon behind all of this 💖

This software is copyright (c) 2012 by Leon Timmermans.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. so like, go off, share it, remix it, same terms as Perl 5 itself, periodt. 💅

and that's the whole page, bestie!! this one came from perl v5.42.0, dated 2025-07-25 — literally vintage-adjacent but still iconic. mwah 💋🦋✨

📦 where this page comes from