summaryrefslogtreecommitdiff
path: root/ace/Get_Opt.h
blob: 56a715ebc877a7f656674469fb282a7b356c9c30 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
/* -*- C++ -*- */
// $Id$

// ============================================================================
//
// = LIBRARY
//    ace
// 
// = FILENAME
//    Get_Opt.h
//
// = AUTHOR
//    Doug Schmidt 
// 
// ============================================================================

#if !defined (ACE_GET_OPT_H)
#define ACE_GET_OPT_H

#include "ace/ACE.h"

class ACE_Export ACE_Get_Opt
{
  // = TITLE
  //   Iterator for parsing command-line arguments.
  //
  // = DESCRIPTION
  //    This is a C++ wrapper for getopt(3c).
public:
  ACE_Get_Opt (int argc, 
	       char **argv, 
	       const char *optstring, 
	       int skip_argv0 = 1, 
	       int report_errors = 0);
  // Initialize the internal data when the first call is made.  Start
  // processing options with <argv>-element 0 + <skip_argv0>; the
  // sequence of previously skipped non-option <argv>-elements is
  // empty.
  // 
  // <optstring> is a string containing the legitimate option
  // characters.  A colon in <optstring> means that the previous
  // character is an option that wants an argument.  The argument is
  // taken from the rest of the current <argv>-element, or from the
  // following <argv>-element, and returned in <optarg>.
  // 
  // If an option character is seen that is not listed in <optstring>,
  // return '?' after printing an error message.  If you set <opterr>
  // to zero, the error message is suppressed but we still return '?'.
  // 
  // If a char in <optstring> is followed by a colon, that means it
  // wants an arg, so the following text in the same <argv>-element,
  // or the text of the following <argv>-element, is returned in
  // <optarg>.

  int operator () (void);
  // Scan elements of <argv> (whose length is <argc>) for option
  // characters given in <optstring>.
  //
  // If an element of <argv> starts with '-', and is not exactly "-"
  // or "--", then it is an option element.  The characters of this
  // element (aside from the initial '-') are option characters.  If
  // <operator()> is called repeatedly, it returns successively each
  // of the option characters from each of the option elements.
  // 
  // If <operator()> finds another option character, it returns that
  // character, updating <optind> and <nextchar> so that the next call
  // to <operator()> can resume the scan with the following option
  // character or <argv>-element.
  // 
  // If there are no more option characters, <operator()> returns
  // <EOF>.  Then <optind> is the index in <argv> of the first
  // <argv>-element that is not an option.  (The <argv>-elements have
  // been permuted so that those that are not options now come last.)

  // = Public data members (should be hidden...).

  char *optarg;
  // For communication from <operator()> to the caller.  When
  // <operator()> finds an option that takes an argument, the argument
  // value is returned here.
  
  int optind;
  // Index in <argv> of the next element to be scanned.  This is used
  // for communication to and from the caller and for communication
  // between successive calls to <operator()>.  On entry to
  // <operator()>, zero means this is the first call; initialize.
  //      
  // When <get_opt> returns <EOF>, this is the index of the first of
  // the non-option elements that the caller should itself scan.
  //          
  // Otherwise, <optind> communicates from one call to the next how
  // much of <argv> has been scanned so far.

  int opterr;
  // Callers store zero here to inhibit the error message for
  // unrecognized options.
  
  int argc_;
  // Holds the <argc> count.

  char **argv_;
  // Holds the <argv> pointer.  

  void dump (void) const;
  // Dump the state of an object.

  ACE_ALLOC_HOOK_DECLARE;
  // Declare the dynamic allocation hooks.

private:
  
  char *nextchar_;
  // The next char to be scanned in the option-element in which the
  // last option character we returned was found.  This allows us to
  // pick up the scan where we left off.
  //    
  // If this is zero, or a null string, it means resume the scan
  // by advancing to the next <argv>-element.

  const char *optstring_;
  // Holds the option string.  
};

#if defined (__ACE_INLINE__)
#include "ace/Get_Opt.i"
#endif /* __ACE_INLINE__ */

#endif /* ACE_GET_OPT_H */