octave_packages/m/miscellaneous/perl.m

   1 ## Copyright (C) 2008-2012 Julian Schnidder
   2 ##
   3 ## This file is part of Octave.
   4 ##
   5 ## Octave is free software; you can redistribute it and/or modify it
   6 ## under the terms of the GNU General Public License as published by
   7 ## the Free Software Foundation; either version 3 of the License, or (at
   8 ## your option) any later version.
   9 ##
  10 ## Octave is distributed in the hope that it will be useful, but
  11 ## WITHOUT ANY WARRANTY; without even the implied warranty of
  12 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  13 ## General Public License for more details.
  14 ##
  15 ## You should have received a copy of the GNU General Public License
  16 ## along with Octave; see the file COPYING.  If not, see
  17 ## <http://www.gnu.org/licenses/>.
  18
  19 ## -*- texinfo -*-
  20 ## @deftypefn  {Function File} {[@var{output}, @var{status}] =} perl (@var{scriptfile})
  21 ## @deftypefnx {Function File} {[@var{output}, @var{status}] =} perl (@var{scriptfile}, @var{argument1}, @var{argument2}, @dots{})
  22 ## Invoke Perl script @var{scriptfile} with possibly a list of
  23 ## command line arguments.
  24 ## Returns output in @var{output} and status
  25 ## in @var{status}.
  26 ## @seealso{system}
  27 ## @end deftypefn
  28
  29 function [output, status] = perl (scriptfile = "-e ''", varargin)
  30
  31   ## VARARGIN is intialized to {}(1x0) if no additional arguments are
  32   ## supplied, so there is no need to check for it, or provide an
  33   ## initial value in the argument list of the function definition.
  34
  35   if (ischar (scriptfile)
  36       && ((nargin != 1 && iscellstr (varargin))
  37           || (nargin == 1 && ! isempty (scriptfile))))
  38     [status, output] = system (cstrcat ("perl ", scriptfile,
  39                                         sprintf (" %s", varargin{:})));
  40   else
  41     error ("perl: invalid arguments");
  42   endif
  43
  44 endfunction