xref: /trunk/main/shell/source/tools/lngconvex/cmdline.hxx (revision cdf0e10c4e3984b49a9502b011690b615761d4a3)

#ifndef _CMDLINE_HXX_
#define _CMDLINE_HXX_

#include "defs.hxx"

//---------------------------------
/** Simple command line abstraction
*/

class CommandLine
{
public:

    //################################
    // Creation
    //################################


    CommandLine(size_t argc, char* argv[], const std::string& ArgPrefix = std::string("-"));


    //################################
    // Query
    //################################


    /** Return the argument count
    */
    size_t get_arg_count() const;

    /** Return an argument by index
        This method doesn't skip argument
        names if any, so if the second
        argument is an argument name the
        function nevertheless returns it.

        @precond    0 <= Index < GetArgumentCount

        @throws std::out_of_range exception
        if the given index is to high
    */
    std::string get_arg(size_t Index) const;

    /** Returns all argument name found in the
        command line. An argument will be identified
        by a specified prefix. The standard prefix
        is '-'.
        If there are no argument names the returned
        container is empty.
    */
    StringListPtr_t get_arg_names() const;

    /** Returns an argument by name. If there are
        duplicate argument names in the command line,
        the first one wins.
        Argument name an the argument value must be separated
        by spaces. If the argument value starts with an
        argument prefix use quotes else the return value is
        an empty string because the value will be interpreted
        as the next argument name.
        If an argument value contains spaces use quotes.

        @precond    GetArgumentNames() -> has element ArgumentName

        @throws std::invalid_argument exception
        if the specified argument could not be
        found
    */
    std::string get_arg(const std::string& ArgumentName) const;


    //################################
    // Command
    //################################


    /** Set the prefix used to identify arguments in
        the command line.

        @precond    prefix is not empty

        @throws std::invalid_argument exception if
        the prefix is empty
    */
    void set_arg_prefix(const std::string& Prefix);

private:

    /** Returns whether a given argument is an argument name
    */
    bool is_arg_name(const std::string& Argument) const;

private:
    size_t      m_argc;
    char**      m_argv;
    std::string m_argprefix;

// prevent copy and assignment
private:
    CommandLine(const CommandLine&);
    CommandLine& operator=(const CommandLine&);
};

#endif