IPC::Filter(3pm) | User Contributed Perl Documentation | IPC::Filter(3pm) |
NAME¶
IPC::Filter - filter data through an external process
SYNOPSIS¶
use IPC::Filter qw(filter); $compressed_data = filter($data, "bzip2");
DESCRIPTION¶
The "filter" function provided by this module passes data through an external command, thus providing filtering in non-pipeline situations.
FUNCTIONS¶
- filter(DATA, SHELL_COMMAND)
- filter(DATA, PROGRAM, ARGS ...)
- The SHELL_COMMAND, or the PROGRAM with ARGS if more arguments are
supplied, is executed as a separate process. (The arguments other than
DATA are ultimately passed to "exec";
see "exec" in perlfunc(1) for explanation of the choice
between the two forms.) The DATA (which must be either a simple string or
a reference to a string) is supplied to the process on its standard input,
and the process's standard output is captured and returned (as a simple
string).
If the process exits with a non-zero exit code or on a signal, the function will "die". In the case of a non-zero exit code, the "die" message will duplicate the process's standard error output; in any other case, the error output is discarded.
SEE ALSO¶
IPC::Open2
AUTHOR¶
Andrew Main (Zefram) <zefram@fysh.org>
COPYRIGHT¶
Copyright (C) 2004, 2007, 2010, 2011, 2017 Andrew Main (Zefram) <zefram@fysh.org>
LICENSE¶
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
2022-11-19 | perl v5.36.0 |