---

more/sys/system.h

Go to the documentation of this file.

//  more/system.h -- a more/signal.h consistent system command
//  Copyright (C) 1999--2001  Petter Urkedal (petter.urkedal@matfys.lth.se)

//  This file is free software; you can redistribute it and/or modify
//  it under the terms of the GNU General Public License as published by
//  the Free Software Foundation; either version 2 of the License, or
//  (at your option) any later version.

//  This file is distributed in the hope that it will be useful,
//  but WITHOUT ANY WARRANTY; without even the implied warranty of
//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
//  GNU General Public License for more details.

//  You should have received a copy of the GNU General Public License
//  along with this program; if not, write to the Free Software
//  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

//  As a special exception, you may use this file as part of a free
//  software library without restriction.  Specifically, if other files
//  instantiate templates or use macros or inline functions from this
//  file, or you compile this file and link it with other files to
//  produce an executable, this file does not by itself cause the
//  resulting executable to be covered by the GNU General Public
//  License.  This exception does not however invalidate any other
//  reasons why the executable file might be covered by the GNU General
//  Public License.

//  $Id: system.h,v 1.1 2002/05/30 18:01:40 petter_urkedal Exp $


#ifndef MORE_SYS_SYSTEM_H
#define MORE_SYS_SYSTEM_H

#include <string>
#include <memory>
#include <more/io/redirection.h>

namespace more {
namespace sys {

  inline char const* c_str(char const* s) { return s; }
  inline char const* c_str(std::string const& s) { return s.c_str(); }

  /** Executes a system specific interpreted command.  Be careful if
      you use in a secure program, as the string is interpreted by the
      shell.  Better, use one of the other overloads of this name if
      you don't need the shell-functionality.  */
  int system(std::string);

  /** Executes the program in argv[0] with arguments from the remaining
      of the null-terminated array.  Check out the overloads with more
      arguments for a higher level iterface.  */
  int system(char const* const* argv, io::redirection const& redir);

  /** Executes a program prgname with arguments given by the iterator
      range.  The value type of the Iterator type must be std::string
      or char const*.  If prgname does not contain a '/', the program
      is search for in an OS dependent way (e.g. using $PATH on Unix).
      For secure applications, use absolute path names (starting with
      '/') if possible.  The program name shall not be included in the
      argument list. */
  template <typename Iterator>
    inline int
    system(std::string prgname, Iterator args_beg, Iterator args_end,
           io::redirection const& redir = io::redirection())
    {
        int n = std::distance(args_beg, args_end) + 2;
        std::auto_ptr<char const*>
            argv(new (char const*)[n]);
        char const** it = argv.get();
        *it++ = prgname.c_str();
        while (args_beg != args_end) {
            *it++ = c_str(*args_beg);
            ++args_beg;
        }
        *it++ = 0;
        return system(argv.get(), redir);
    }

}} // more::sys

#endif

---