IO::Pipe(3perl)

📦
version 5.44.0 · 14 versions
, in arch rolling

💖 IO::Pipe — supply object methods for pipes 💖

okay bestie, so this is IO::Pipe, a lil module from the Perl Programmers Reference Guide that gives you 💫object methods💫 for making pipes. It's giving very much "I don't want to wrangle raw filehandles myself" energy, and honestly? Slay.

✨ SYNOPSIS ✨

        use IO::Pipe;

        $pipe = IO::Pipe->new();

        if($pid = fork()) { # Parent
            $pipe->reader();

            while(<$pipe>) {
                ...
            }

        }
        elsif(defined $pid) { # Child
            $pipe->writer();

            print $pipe ...
        }

        or

        $pipe = IO::Pipe->new();

        $pipe->reader(qw(ls -l));

        while(<$pipe>) {
            ...
        }
fr fr this is the whole vibe in one code block — fork it, read from one end, write to the other, and let the module handle the ✨drama✨.

🌸 DESCRIPTION 🌸

IO::Pipe provides an interface to creating pipes between processes.

that's it. that's the whole thing. no cap. pipes between processes, made cute. 🦋

🎀 CONSTRUCTOR 🎀

  • new ( [READER, WRITER] ) — makes you a brand-new IO::Pipe, which is literally a reference to a newly created symbol (peep the Symbol package if you're nosy 👀). IO::Pipe::new optionally takes two arguments, and those two besties should be objects blessed into IO::Handle, or some subclass of it. Those two objects are what get used for the system call to pipe. And if you hand it no arguments at all? Then the method handles gets called on the fresh new IO::Pipe object instead. 💅

Those two handles live in the array part of the GLOB until either reader or writer gets called. like, they're just chillin there. waiting for their moment. main character energy ⭐

🫶 METHODS 🫶

  • reader ([ARGS]) — the object gets re-blessed into a sub-class of IO::Handle and becomes a handle sitting at the reading end of the pipe. 📖 And if you pass ARGS? Then fork gets called and ARGS get passed along to exec. iykyk.
  • writer ([ARGS]) — same deal, bestie: the object is re-blessed into a sub-class of IO::Handle and becomes a handle at the writing end of the pipe. ✍️ And yep, if ARGS are given, fork is called and ARGS are passed to exec. twin behavior.
  • handles () — this one gets called during construction, by IO::Pipe::new, on the freshly created IO::Pipe object. It hands back an array of two objects blessed into IO::Pipe::End, or a subclass of it. two lil ends. a whole pipe. obsessed. 🎀

👑 SEE ALSO 👑

IO::Handle

💜 AUTHOR 💜

Graham Barr. Currently maintained by the Perl Porters. Please report all bugs at <https://github.com/Perl/perl5/issues>.

(if something's broken, go tell them!! they want to know!! 🐛)

Copyright (c) 1996-8 Graham Barr <gbarr@pobox.com>. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

and that's the whole page, bestie!! 🥳 this was documented for perl v5.44.0, dated 2026-10-17 — so yeah, she's fresh, she's iconic, she's IO::Pipe(3perl). go make some pipes. you're gonna eat. 💅✨🦋

📦 where this page comes from