Changeset 26485 in vbox for trunk/include

Timestamp:

Feb 14, 2010 6:59:06 AM (15 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

57654

Message:

iprt/getopt: Added two standard options: h: --help/-help/-h/-?, V: --version,-version,-V. These can be disabled by giving using RTGETOPTINIT_FLAGS_NO_STD_OPTS. Added another init flag, RTGETOPTINIT_FLAGS_OPTS_FIRST, for making RTGetOpt return options first and then non-options. Converted tstGetOpt to RTTest.

File:

• trunk/include/iprt/getopt.h (modified) (2 diffs)

trunk/include/iprt/getopt.h

@@ -205 +205 @@
     /** The index of an index option, otherwise UINT32_MAX. */
     uint32_t        uIndex;
-    /* More members will be added later for dealing with initial
-       call, optional sorting, '--' and so on. */
+    /** The flags passed to RTGetOptInit.  */
+    uint32_t        fFlags;
+    /** Number of non-options that we're skipping during a sorted get.  The value
+     * INT32_MAX is used to indicate that there are no more options.  This is used
+     * to implement '--'.   */
+    int32_t         cNonOptions;
+
+    /* More members may be added later for dealing with new features. */
 } RTGETOPTSTATE;
 /** Pointer to RTGetOpt state. */
@@ -235 +241 @@
                          PCRTGETOPTDEF paOptions, size_t cOptions,
                          int iFirst, uint32_t fFlags);
+
+/** @name RTGetOptInit flags.
+ * @{ */
+/** Sort the arguments so that options comes first, then non-options. */
+#define RTGETOPTINIT_FLAGS_OPTS_FIRST   RT_BIT_32(0)
+/** Prevent add the standard version and help options:
+ *     - "--help", "-h" and "-?" returns 'h'.
+ *     - "--version" and "-V" return 'V'.
+ */
+#define RTGETOPTINIT_FLAGS_NO_STD_OPTS  RT_BIT_32(1)
+/** @} */
 
 /**