args.h

Go to the documentation of this file.

/*
 * args.h
 *
 * Program Argument Parsing class
 *
 * Portable Windows Library
 *
 * Copyright (c) 1993-1998 Equivalence Pty. Ltd.
 *
 * The contents of this file are subject to the Mozilla Public License
 * Version 1.0 (the "License"); you may not use this file except in
 * compliance with the License. You may obtain a copy of the License at
 * http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS"
 * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
 * the License for the specific language governing rights and limitations
 * under the License.
 *
 * The Original Code is Portable Windows Library.
 *
 * The Initial Developer of the Original Code is Equivalence Pty. Ltd.
 *
 * Portions are Copyright (C) 1993 Free Software Foundation, Inc.
 * All Rights Reserved.
 *
 * Contributor(s): ______________________________________.
 *
 * $Revision: 21932 $
 * $Author: rjongbloed $
 * $Date: 2009-01-14 21:19:32 -0600 (Wed, 14 Jan 2009) $
 */

#ifndef PTLIB_ARGLIST_H
#define PTLIB_ARGLIST_H

#ifdef P_USE_PRAGMA
#pragma interface
#endif

class PArgList : public PObject
{
  PCLASSINFO(PArgList, PObject);

  public:
    PArgList(
      const char * theArgPtr = NULL,        
      const char * argumentSpecPtr = NULL,  
      PBoolean optionsBeforeParams = PTrue       
    );
    PArgList(
      const PString & theArgStr,             
      const char * argumentSpecPtr = NULL,   
      PBoolean optionsBeforeParams = PTrue        
    );
    PArgList(
      const PString & theArgStr,             
      const PString & argumentSpecStr,       
      PBoolean optionsBeforeParams = PTrue        
    );
    PArgList(
      int theArgc,                           
      char ** theArgv,                       
      const char * argumentSpecPtr = NULL,   
      PBoolean optionsBeforeParams = PTrue        
    );
    PArgList(
      int theArgc,                           
      char ** theArgv,                       
      const PString & argumentSpecStr,       
      PBoolean optionsBeforeParams = PTrue        
    );

    virtual void PrintOn(
      ostream & strm  
    ) const;

    virtual void ReadFrom(
      istream & strm  
    );

    void SetArgs(
      const PString & theArgStr 
    );
    void SetArgs(
      int theArgc,     
      char ** theArgv  
    );
    void SetArgs(
      const PStringArray & theArgs 
    );

    virtual PBoolean Parse(
      const char * theArgumentSpec,    
      PBoolean optionsBeforeParams = PTrue  
    );
    virtual PBoolean Parse(
      const PString & theArgumentStr,  
      PBoolean optionsBeforeParams = PTrue  
    );

    virtual PINDEX GetOptionCount(
      char optionChar        
    ) const;
    virtual PINDEX GetOptionCount(
      const char * optionStr 
    ) const;
    virtual PINDEX GetOptionCount(
      const PString & optionName 
    ) const;

    PBoolean HasOption(
      char optionChar             
    ) const;
    PBoolean HasOption(
      const char * optionStr     
    ) const;
    PBoolean HasOption(
      const PString & optionName 
    ) const;

    virtual PString GetOptionString(
      char optionChar,          
      const char * dflt = NULL  
    ) const;
    virtual PString GetOptionString(
      const char * optionStr,   
      const char * dflt = NULL  
    ) const;
    virtual PString GetOptionString(
      const PString & optionName, 
      const char * dflt = NULL    
    ) const;

    PINDEX GetCount() const;

    PStringArray GetParameters(
      PINDEX first = 0,
      PINDEX last = P_MAX_INDEX
    ) const;

    PString GetParameter(
      PINDEX num   
    ) const;

    PString operator[](
      PINDEX num   
    ) const;

    void Shift(
      int sh 
    );

    PArgList & operator<<(
      int sh 
    );

    PArgList & operator>>(
      int sh 
    );

    virtual void IllegalArgumentIndex(
      PINDEX idx 
    ) const;

    virtual void UnknownOption(
      const PString & option   
    ) const;

    virtual void MissingArgument(
      const PString & option  
    ) const;

  protected:
    PStringArray argumentArray;
    PString      optionLetters;
    PStringArray optionNames;
    PIntArray    optionCount;
    PStringArray optionString;
    PIntArray    parameterIndex;
    int          shift;

  private:
    PBoolean ParseOption(PINDEX idx, PINDEX offset, PINDEX & arg, const PIntArray & canHaveOptionString);
    PINDEX GetOptionCountByIndex(PINDEX idx) const;
    PString GetOptionStringByIndex(PINDEX idx, const char * dflt) const;
    int m_argsParsed;
};


#ifdef P_CONFIG_FILE

class PConfigArgs : public PArgList
{
    PCLASSINFO(PConfigArgs, PArgList);
  public:
    PConfigArgs(
      const PArgList & args   
    );

    virtual PINDEX GetOptionCount(
      char optionChar  
    ) const;
    virtual PINDEX GetOptionCount(
      const char * optionStr 
    ) const;
    virtual PINDEX GetOptionCount(
      const PString & optionName 
    ) const;

    virtual PString GetOptionString(
      char optionChar,          
      const char * dflt = NULL  
    ) const;

    virtual PString GetOptionString(
      const char * optionStr,   
      const char * dflt = NULL  
    ) const;

    virtual PString GetOptionString(
      const PString & optionName, 
      const char * dflt = NULL    
    ) const;

    void Save(
      const PString & optionName   
    );

    void SetSectionName(
      const PString & section 
    ) { sectionName = section; }

    const PString & GetSectionName() const { return sectionName; }

    void SetNegationPrefix(
      const PString & prefix 
    ) { negationPrefix = prefix; }

    const PString & GetNegationPrefix() const { return negationPrefix; }


  protected:
    PString CharToString(char ch) const;
    PConfig config;
    PString sectionName;
    PString negationPrefix;
};

#endif // P_CONFIG_FILE


#endif // PTLIB_ARGLIST_H


// End Of File ///////////////////////////////////////////////////////////////

---