NAME
PTools::Proc::Backtick - Simple OO interface to system commands
VERSION
This document describes version 0.03, released Feb 15, 2003.
SYNOPSIS
$cmdObj = run PTools::Proc::Backtick("/bin/echo","echo this");
($stat,$err)= $cmdObj->status();
or ($stat,$err,$cmdObj) = run PTools::Proc::Backtick( "grep", "foo", $fileName );
$commandOut = $cmdObj->result();
or $stat = $cmdObj->stat(); # status number returned in scalar context
($err) = $cmdObj->stat(); # error message returned in array context
($err) = $cmdObj->err();
DESCRIPTION
A simple object oriented interface to Perl's backtick functionality.
Constructor
- new
-
The new method is optional. The run method will also return a newly constructed object.
Methods
- run ( Command [, Args ] )
-
Run a system command via Perl's backtick functionality.
- Command
-
Specify the system command which is to be run.
- Args
-
Supply any additional command-line parameter(s) for the system command.
See Synopsis section for examples.
- result
-
Collect any output resulting from the execution of Command. This will contain results from both STDOUT and STDERR.
- status
- stat
- err
-
Collect the status resulting from the execution of Command. When the status code is non-zero, an error message is also returned. See Synopsis section for examples.
INHERITANCE
None currently.
SEE ALSO
See PTools::Proc::Status.
AUTHOR
Chris Cobb, <nospamplease@ccobb.net>
COPYRIGHT
Copyright (c) 2002-2007 by Chris Cobb. All rights reserved. This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.