1. compilation fixes for TB_REPLACEBITMAP and FONTENUMPROC

2. added wxCmdLineParser class


git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@5246 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

include/wx/cmdline.h

@@ -0,0 +1,193 @@
+///////////////////////////////////////////////////////////////////////////////
+// Name:        wx/cmdline.h
+// Purpose:     wxCmdLineParser and related classes for parsing the command
+//              line options
+// Author:      Vadim Zeitlin
+// Modified by:
+// Created:     04.01.00
+// RCS-ID:      $Id$
+// Copyright:   (c) 2000 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
+// Licence:     wxWindows license
+///////////////////////////////////////////////////////////////////////////////
+
+#ifndef _WX_CMDLINE_H_
+#define _WX_CMDLINE_H_
+
+#ifdef __GNUG__
+    #pragma interface "cmdline.h"
+#endif
+
+#include "wx/string.h"
+
+class WXDLLEXPORT wxDateTime;
+
+// ----------------------------------------------------------------------------
+// constants
+// ----------------------------------------------------------------------------
+
+// by default, options are optional (sic) and each call to AddParam() allows
+// one more parameter - this may be changed by giving non-default flags to it
+enum
+{
+    wxCMD_LINE_OPTION_MANDATORY = 0x01, // this option must be given
+    wxCMD_LINE_PARAM_OPTIONAL   = 0x02, // the parameter may be omitted
+    wxCMD_LINE_PARAM_MULTIPLE   = 0x04, // the parameter may be repeated
+    wxCMD_LINE_OPTION_HELP      = 0x08  // this option is a help request
+};
+
+// an option value or parameter may be a string (the most common case), a
+// number or a date
+enum wxCmdLineParamType
+{
+    wxCMD_LINE_VAL_STRING,  // should be 0 (default)
+    wxCMD_LINE_VAL_NUMBER,
+    wxCMD_LINE_VAL_DATE,
+    wxCMD_LINE_VAL_NONE
+};
+
+// for constructing the cmd line description using Init()
+enum wxCmdLineEntryType
+{
+    wxCMD_LINE_SWITCH,
+    wxCMD_LINE_OPTION,
+    wxCMD_LINE_PARAM,
+    wxCMD_LINE_NONE         // to terminate the list
+};
+
+// ----------------------------------------------------------------------------
+// wxCmdLineEntryDesc is a description of one command line
+// switch/option/parameter
+// ----------------------------------------------------------------------------
+
+struct wxCmdLineEntryDesc
+{
+    wxCmdLineEntryType kind;
+    const wxChar *shortName;
+    const wxChar *longName;
+    const wxChar *description;
+    wxCmdLineParamType type;
+    int flags;
+};
+
+// ----------------------------------------------------------------------------
+// wxCmdLineParser is a class for parsing command line.
+//
+// It has the following features:
+//
+// 1. distinguishes options, switches and parameters; allows option grouping
+// 2. allows both short and long options
+// 3. automatically generates the usage message from the cmd line description
+// 4. does type checks on the options values (number, date, ...)
+//
+// To use it you should:
+//
+// 1. construct it giving it the cmd line to parse and optionally its desc
+// 2. construct the cmd line description using AddXXX() if not done in (1)
+// 3. call Parse()
+// 4. use GetXXX() to retrieve the parsed info
+// ----------------------------------------------------------------------------
+
+class WXDLLEXPORT wxCmdLineParser
+{
+public:
+    // ctors and initializers
+    // ----------------------
+
+    // default ctor or ctor giving the cmd line in either Unix or Win form
+    wxCmdLineParser() { Init(); }
+    wxCmdLineParser(int argc, char **argv) { Init(); SetCmdLine(argc, argv); }
+    wxCmdLineParser(const wxString& cmdline) { Init(); SetCmdLine(cmdline); }
+
+    // the same as above, but also gives the cmd line description - otherwise,
+    // use AddXXX() later
+    wxCmdLineParser(const wxCmdLineEntryDesc *desc)
+        { Init(); SetDesc(desc); }
+    wxCmdLineParser(const wxCmdLineEntryDesc *desc, int argc, char **argv)
+        { Init(); SetCmdLine(argc, argv); SetDesc(desc); }
+    wxCmdLineParser(const wxCmdLineEntryDesc *desc, const wxString& cmdline)
+        { Init(); SetCmdLine(cmdline); SetDesc(desc); }
+
+    // set cmd line to parse after using one of the ctors which don't do it
+    void SetCmdLine(int argc, char **argv);
+    void SetCmdLine(const wxString& cmdline);
+
+    // not virtual, don't use this class polymorphically
+    ~wxCmdLineParser();
+
+    // set different parser options
+    // ----------------------------
+
+    // by default, '-' is switch char under Unix, '-' or '/' under Win:
+    // switchChars contains all characters with which an option or switch may
+    // start
+    void SetSwitchChars(const wxString& switchChars);
+
+    // long options are not POSIX-compliant, this option allows to disable them
+    void EnableLongOptions(bool enable = TRUE);
+    void DisableLongOptions() { EnableLongOptions(FALSE); }
+
+    // construct the cmd line description
+    // ----------------------------------
+
+    // take the cmd line description from the wxCMD_LINE_NONE terminated table
+    void SetDesc(const wxCmdLineEntryDesc *desc);
+
+    // a switch: i.e. an option without value
+    void AddSwitch(const wxString& name, const wxString& lng = wxEmptyString,
+                   const wxString& desc = wxEmptyString,
+                   int flags = 0);
+
+    // an option taking a value of the given type
+    void AddOption(const wxString& name, const wxString& lng = wxEmptyString,
+                   const wxString& desc = wxEmptyString,
+                   wxCmdLineParamType type = wxCMD_LINE_VAL_STRING,
+                   int flags = 0);
+
+    // a parameter
+    void AddParam(const wxString& desc = wxEmptyString,
+                  wxCmdLineParamType type = wxCMD_LINE_VAL_STRING,
+                  int flags = 0);
+
+    // actions
+    // -------
+
+    // parse the command line, return 0 if ok, -1 if "-h" or "--help" option
+    // was encountered and the help message was given or a positive value if a
+    // syntax error occured
+    int Parse();
+
+    // give the usage message describing all program options
+    void Usage();
+
+    // get the command line arguments
+    // ------------------------------
+
+    // returns TRUE if the given switch was found
+    bool Found(const wxString& name) const;
+
+    // returns TRUE if an option taking a string value was found and stores the
+    // value in the provided pointer
+    bool Found(const wxString& name, wxString *value) const;
+
+    // returns TRUE if an option taking an integer value was found and stores
+    // the value in the provided pointer
+    bool Found(const wxString& name, long *value) const;
+
+    // returns TRUE if an option taking a date value was found and stores the
+    // value in the provided pointer
+    bool Found(const wxString& name, wxDateTime *value) const;
+
+    // gets the number of parameters found
+    size_t GetParamCount() const;
+
+    // gets the value of Nth parameter (as string only for now)
+    wxString GetParam(size_t n) const;
+
+private:
+    // common part of all ctors
+    void Init();
+
+    struct wxCmdLineParserData *m_data;
+};
+
+#endif // _WX_CMDLINE_H_