tstRTGetOpt.cpp@ 102792

Last change on this file since 102792 was 99246, checked in by vboxsync, 20 months ago
IPRT/RTGetOpt: Interpret non-breaking hypen and a handful other unicode dashes like the asci '-' when parsing command line, so that the manual, blog entries and such are free to use other dash variants for typesetting reasons w/o prevent the reader from copying & pasting the examples directly onto the command line. bugref:10302
Property svn:eol-style set to `native` Property svn:keywords set to `Id Revision`
File size: 28.0 KB

Line
1	/* $Id: tstRTGetOpt.cpp 99246 2023-03-31 08:48:57Z vboxsync $ */
2	/** @file
3	* IPRT Testcase - RTGetOpt
4	*/
5
6	/*
7	* Copyright (C) 2007-2023 Oracle and/or its affiliates.
8	*
9	* This file is part of VirtualBox base platform packages, as
10	* available from https://www.virtualbox.org.
11	*
12	* This program is free software; you can redistribute it and/or
13	* modify it under the terms of the GNU General Public License
14	* as published by the Free Software Foundation, in version 3 of the
15	* License.
16	*
17	* This program is distributed in the hope that it will be useful, but
18	* WITHOUT ANY WARRANTY; without even the implied warranty of
19	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20	* General Public License for more details.
21	*
22	* You should have received a copy of the GNU General Public License
23	* along with this program; if not, see <https://www.gnu.org/licenses>.
24	*
25	* The contents of this file may alternatively be used under the terms
26	* of the Common Development and Distribution License Version 1.0
27	* (CDDL), a copy of it is provided in the "COPYING.CDDL" file included
28	* in the VirtualBox distribution, in which case the provisions of the
29	* CDDL are applicable instead of those of the GPL.
30	*
31	* You may elect to license modified versions of this file under the
32	* terms and conditions of either the GPL or the CDDL or both.
33	*
34	* SPDX-License-Identifier: GPL-3.0-only OR CDDL-1.0
35	*/
36
37
38	/*********************************************************************************************************************************
39	* Header Files *
40	*********************************************************************************************************************************/
41	#include <iprt/net.h>
42	#include <iprt/getopt.h>
43
44	#include <iprt/err.h>
45	#include <iprt/string.h>
46	#include <iprt/test.h>
47
48
49	int main()
50	{
51	RTTEST hTest;
52	int rc = RTTestInitAndCreate("tstRTGetOpt", &hTest);
53	if (rc)
54	return rc;
55
56	RTGETOPTSTATE GetState;
57	RTGETOPTUNION Val;
58	#define CHECK(expr) do { if (!(expr)) { RTTestIFailed("error line %d (iNext=%d): %s\n", __LINE__, GetState.iNext, #expr); } } while (0)
59	#define CHECK2(expr, fmt) \
60	do { \
61	if (!(expr)) { \
62	RTTestIFailed("error line %d (iNext=%d): %s\n", __LINE__, GetState.iNext, #expr); \
63	RTTestIFailureDetails fmt; \
64	} \
65	} while (0)
66
67	#define CHECK_pDef(paOpts, i) \
68	CHECK2(Val.pDef == &(paOpts)[(i)], ("Got #%d (%p) expected #%d\n", (int)(Val.pDef - &(paOpts)[0]), Val.pDef, i));
69
70	#define CHECK_GETOPT(expr, chRet, iInc) \
71	do { \
72	const int iPrev = GetState.iNext; \
73	const int rcGetOpt = (expr); \
74	CHECK2(rcGetOpt == (chRet), ("got %d, expected %d\n", rcGetOpt, (chRet))); \
75	CHECK2(GetState.iNext == (iInc) + iPrev, ("iNext=%d expected %d\n", GetState.iNext, (iInc) + iPrev)); \
76	GetState.iNext = (iInc) + iPrev; \
77	} while (0)
78
79	#define CHECK_GETOPT_STR(expr, chRet, iInc, str) \
80	do { \
81	const int iPrev = GetState.iNext; \
82	const int rcGetOpt = (expr); \
83	CHECK2(rcGetOpt == (chRet), ("got %d, expected %d\n", rcGetOpt, (chRet))); \
84	CHECK2(GetState.iNext == (iInc) + iPrev, ("iNext=%d expected %d\n", GetState.iNext, (iInc) + iPrev)); \
85	CHECK2(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, (str)), ("got %s, expected %s\n", Val.psz, (str))); \
86	GetState.iNext = (iInc) + iPrev; \
87	} while (0)
88
89
90	/*
91	* The basics.
92	*/
93	RTTestSub(hTest, "Basics");
94	static const RTGETOPTDEF s_aOpts2[] =
95	{
96	{ "--optwithstring", 's', RTGETOPT_REQ_STRING },
97	{ "--optwithint", 'i', RTGETOPT_REQ_INT32 },
98	{ "--verbose", 'v', RTGETOPT_REQ_NOTHING },
99	{ NULL, 'q', RTGETOPT_REQ_NOTHING },
100	{ "--quiet", 384, RTGETOPT_REQ_NOTHING },
101	{ "-novalue", 385, RTGETOPT_REQ_NOTHING },
102	{ "-startvm", 386, RTGETOPT_REQ_STRING },
103	{ "nodash", 387, RTGETOPT_REQ_NOTHING },
104	{ "nodashval", 388, RTGETOPT_REQ_STRING },
105	{ "--gateway", 'g', RTGETOPT_REQ_IPV4ADDR },
106	{ "--mac", 'm', RTGETOPT_REQ_MACADDR },
107	{ "--strindex", 400, RTGETOPT_REQ_STRING \| RTGETOPT_FLAG_INDEX },
108	{ "strindex", 400, RTGETOPT_REQ_STRING \| RTGETOPT_FLAG_INDEX },
109	{ "--intindex", 401, RTGETOPT_REQ_INT32 \| RTGETOPT_FLAG_INDEX },
110	{ "--macindex", 402, RTGETOPT_REQ_MACADDR \| RTGETOPT_FLAG_INDEX },
111	{ "--indexnovalue", 403, RTGETOPT_REQ_NOTHING \| RTGETOPT_FLAG_INDEX },
112	{ "--macindexnegative", 404, RTGETOPT_REQ_NOTHING },
113	{ "--twovalues", 405, RTGETOPT_REQ_STRING },
114	{ "--twovaluesindex", 406, RTGETOPT_REQ_UINT32 \| RTGETOPT_FLAG_INDEX },
115	{ "--threevalues", 407, RTGETOPT_REQ_UINT32 },
116	{ "--boolean", 408, RTGETOPT_REQ_BOOL_ONOFF },
117	{ "--booleanindex", 409, RTGETOPT_REQ_BOOL_ONOFF \| RTGETOPT_FLAG_INDEX },
118	{ "--pair32", 410, RTGETOPT_REQ_UINT32_PAIR },
119	{ "--optpair32", 411, RTGETOPT_REQ_UINT32_OPTIONAL_PAIR },
120	{ "--optpair64", 412, RTGETOPT_REQ_UINT64_OPTIONAL_PAIR },
121	{ "--boolean0index", 413, RTGETOPT_REQ_BOOL_ONOFF \| RTGETOPT_FLAG_INDEX \| RTGETOPT_FLAG_INDEX_DEF_0 },
122	{ "--boolean1index", 414, RTGETOPT_REQ_BOOL_ONOFF \| RTGETOPT_FLAG_INDEX \| RTGETOPT_FLAG_INDEX_DEF_1 },
123	{ "--boolean-dash-idx", 415, RTGETOPT_REQ_BOOL_ONOFF \| RTGETOPT_FLAG_INDEX \| RTGETOPT_FLAG_INDEX_DEF_0 \| RTGETOPT_FLAG_INDEX_DEF_DASH },
124	};
125
126	const char *argv2[] =
127	{
128	"-s", "string1",
129	"-sstring2",
130	"-s:string3",
131	"-s=string4",
132	"-s:",
133	"-s=",
134	"--optwithstring", "string5",
135	"--optwithstring:string6",
136	"--optwithstring=string7",
137	"--optwithstring:",
138	"--optwithstring=",
139
140	"-i", "-42",
141	"-i:-42",
142	"-i=-42",
143
144	"--optwithint", "42",
145	"--optwithint:42",
146	"--optwithint=42",
147
148	"-v",
149	"--verbose",
150	"-q",
151	"--quiet",
152
153	"-novalue",
154	"-startvm", "myvm",
155
156	"nodash",
157	"nodashval", "string9",
158
159	"filename1",
160	"-q",
161	"filename2",
162
163	"-vqi999",
164
165	"-g192.168.1.1",
166
167	"-m08:0:27:00:ab:f3",
168	"--mac:1:::::c",
169
170	"--strindex786", "string10",
171	"--strindex786:string11",
172	"--strindex786=string12",
173	"strindex687", "string13",
174	"strindex687:string14",
175	"strindex687=string15",
176	"strindex688:",
177	"strindex689=",
178	"--intindex137", "1000",
179	"--macindex138", "08:0:27:00:ab:f3",
180	"--indexnovalue1",
181	"--macindexnegative",
182
183	"--twovalues", "firstvalue", "secondvalue",
184	"--twovalues:firstvalue", "secondvalue",
185	"--twovaluesindex4", "1", "0xA",
186	"--twovaluesindex5=2", "0xB",
187	"--threevalues", "1", "0xC", "thirdvalue",
188
189	/* bool on/off */
190	"--boolean", "on",
191	"--boolean", "off",
192	"--boolean", "invalid",
193	"--booleanindex2", "on",
194	"--booleanindex7", "off",
195	"--booleanindex9", "invalid",
196
197	/* bool on/off with optional index */
198	"--boolean0index9", "on",
199	"--boolean0index", "off",
200	"--boolean1index42", "off",
201	"--boolean1index", "on",
202	"--boolean-dash-idx", "off",
203	"--boolean-dash-idx-2", "on",
204	"--boolean-dash-idx-3=off",
205	"--boolean-dash-idx:on",
206
207	/* standard options */
208	"--help",
209	"-help",
210	"-?",
211	"-h",
212	"--version",
213	"-version",
214	"-V",
215
216	/* 32-bit pairs */
217	"--pair32", "1536:0x1536",
218	"--optpair32", "0x42:042",
219	"--optpair32", "0128",
220	"--optpair64", "0x128 0x42",
221	"--optpair64", "0x128 :0x42",
222	"--optpair64", "0x128",
223
224	/* various utf-8 dashes: */
225	#define DASH_HYPHEN "\xE2\x80\x90" // U+2010
226	#define DASH_NON_BREAKING "\xE2\x80\x91" // U+2011
227	#define DASH_FIGURE "\xE2\x80\x92" // U+2012
228	#define DASH_EN "\xE2\x80\x93" // U+2013
229	#define DASH_EM "\xE2\x80\x94" // U+2014
230	#define DASH_MINUS_SIGN "\xE2\x88\x92" // U+2212
231	#define DASH_SMALL_EM "\xEF\xB9\x98" // U+fe58
232	#define DASH_SMALL_HYPEN_MINUS "\xEF\xB9\xA3" // U+fe63
233	#define DASH_FULLWIDTH "\xEF\xBC\x8D" // U+ff0d
234	DASH_HYPHEN DASH_NON_BREAKING "quiet",
235	DASH_FIGURE DASH_EN "boolean" DASH_EM "dash" DASH_MINUS_SIGN "idx" DASH_FULLWIDTH "2", "off",
236	DASH_NON_BREAKING "qV",
237	DASH_SMALL_EM DASH_SMALL_HYPEN_MINUS "boolean1index42", "on",
238	DASH_NON_BREAKING DASH_FULLWIDTH "indexnovalue2",
239
240	/* done */
241	NULL
242	};
243	int argc2 = (int)RT_ELEMENTS(argv2) - 1;
244
245	CHECK(RT_SUCCESS(RTGetOptInit(&GetState, argc2, (char *)argv2, &s_aOpts2[0], RT_ELEMENTS(s_aOpts2), 0, 0 / fFlags */)));
246
247	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 's', 2);
248	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "string1"));
249	CHECK(GetState.uIndex == UINT32_MAX);
250	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 's', 1);
251	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "string2"));
252	CHECK(GetState.uIndex == UINT32_MAX);
253	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 's', 1);
254	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "string3"));
255	CHECK(GetState.uIndex == UINT32_MAX);
256	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 's', 1);
257	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "string4"));
258	CHECK(GetState.uIndex == UINT32_MAX);
259	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 's', 1);
260	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, ""));
261	CHECK(GetState.uIndex == UINT32_MAX);
262	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 's', 1);
263	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, ""));
264	CHECK(GetState.uIndex == UINT32_MAX);
265	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 's', 2);
266	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "string5"));
267	CHECK(GetState.uIndex == UINT32_MAX);
268	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 's', 1);
269	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "string6"));
270	CHECK(GetState.uIndex == UINT32_MAX);
271	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 's', 1);
272	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "string7"));
273	CHECK(GetState.uIndex == UINT32_MAX);
274	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 's', 1);
275	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, ""));
276	CHECK(GetState.uIndex == UINT32_MAX);
277	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 's', 1);
278	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, ""));
279	CHECK(GetState.uIndex == UINT32_MAX);
280
281	/* -i */
282	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'i', 2);
283	CHECK(Val.i32 == -42);
284	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'i', 1);
285	CHECK(Val.i32 == -42);
286	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'i', 1);
287	CHECK(Val.i32 == -42);
288
289	/* --optwithint */
290	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'i', 2);
291	CHECK(Val.i32 == 42);
292	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'i', 1);
293	CHECK(Val.i32 == 42);
294	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'i', 1);
295	CHECK(Val.i32 == 42);
296
297	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'v', 1);
298	CHECK_pDef(s_aOpts2, 2);
299	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'v', 1);
300	CHECK_pDef(s_aOpts2, 2);
301
302	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'q', 1);
303	CHECK_pDef(s_aOpts2, 3);
304	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 384, 1);
305	CHECK_pDef(s_aOpts2, 4);
306
307	/* -novalue / -startvm (single dash long options) */
308	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 385, 1);
309	CHECK_pDef(s_aOpts2, 5);
310	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 386, 2);
311	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "myvm"));
312
313	/* no-dash options */
314	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 387, 1);
315	CHECK_pDef(s_aOpts2, 7);
316	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 388, 2);
317	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "string9"));
318
319	/* non-option, option, non-option */
320	CHECK_GETOPT(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1);
321	CHECK(Val.psz && !strcmp(Val.psz, "filename1"));
322	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'q', 1);
323	CHECK_pDef(s_aOpts2, 3);
324	CHECK_GETOPT(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1);
325	CHECK(Val.psz && !strcmp(Val.psz, "filename2"));
326
327	/* compress short options */
328	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'v', 0);
329	CHECK_pDef(s_aOpts2, 2);
330	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'q', 0);
331	CHECK_pDef(s_aOpts2, 3);
332	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'i', 1);
333	CHECK(Val.i32 == 999);
334
335	/* IPv4 */
336	RTTestSub(hTest, "RTGetOpt - IPv4");
337	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'g', 1);
338	CHECK(Val.IPv4Addr.u == RT_H2N_U32_C(RT_BSWAP_U32_C(RT_MAKE_U32_FROM_U8(192,168,1,1))));
339
340	/* Ethernet MAC address. */
341	RTTestSub(hTest, "RTGetOpt - MAC Address");
342	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'm', 1);
343	CHECK( Val.MacAddr.au8[0] == 0x08
344	&& Val.MacAddr.au8[1] == 0x00
345	&& Val.MacAddr.au8[2] == 0x27
346	&& Val.MacAddr.au8[3] == 0x00
347	&& Val.MacAddr.au8[4] == 0xab
348	&& Val.MacAddr.au8[5] == 0xf3);
349	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'm', 1);
350	CHECK( Val.MacAddr.au8[0] == 0x01
351	&& Val.MacAddr.au8[1] == 0x00
352	&& Val.MacAddr.au8[2] == 0x00
353	&& Val.MacAddr.au8[3] == 0x00
354	&& Val.MacAddr.au8[4] == 0x00
355	&& Val.MacAddr.au8[5] == 0x0c);
356
357	/* string with indexed argument */
358	RTTestSub(hTest, "RTGetOpt - Option w/ Index");
359	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 400, 2);
360	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "string10"));
361	CHECK(GetState.uIndex == 786);
362
363	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 400, 1);
364	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "string11"));
365	CHECK(GetState.uIndex == 786);
366
367	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 400, 1);
368	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "string12"));
369	CHECK(GetState.uIndex == 786);
370
371	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 400, 2);
372	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "string13"));
373	CHECK(GetState.uIndex == 687);
374
375	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 400, 1);
376	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "string14"));
377	CHECK(GetState.uIndex == 687);
378
379	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 400, 1);
380	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "string15"));
381	CHECK(GetState.uIndex == 687);
382
383	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 400, 1);
384	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, ""));
385	CHECK(GetState.uIndex == 688);
386
387	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 400, 1);
388	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, ""));
389	CHECK(GetState.uIndex == 689);
390
391	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 401, 2);
392	CHECK(Val.i32 == 1000);
393	CHECK(GetState.uIndex == 137);
394
395	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 402, 2);
396	CHECK( Val.MacAddr.au8[0] == 0x08
397	&& Val.MacAddr.au8[1] == 0x00
398	&& Val.MacAddr.au8[2] == 0x27
399	&& Val.MacAddr.au8[3] == 0x00
400	&& Val.MacAddr.au8[4] == 0xab
401	&& Val.MacAddr.au8[5] == 0xf3);
402	CHECK(GetState.uIndex == 138);
403
404	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 403, 1);
405	CHECK(GetState.uIndex == 1);
406
407	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 404, 1);
408	CHECK(GetState.uIndex == UINT32_MAX);
409
410	/* RTGetOptFetchValue tests */
411	RTTestSub(hTest, "RTGetOptFetchValue");
412	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 405, 2);
413	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "firstvalue"));
414	CHECK(GetState.uIndex == UINT32_MAX);
415	CHECK_GETOPT(RTGetOptFetchValue(&GetState, &Val, RTGETOPT_REQ_STRING), VINF_SUCCESS, 1);
416	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "secondvalue"));
417	CHECK(GetState.uIndex == UINT32_MAX);
418
419	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 405, 1);
420	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "firstvalue"));
421	CHECK(GetState.uIndex == UINT32_MAX);
422	CHECK_GETOPT(RTGetOptFetchValue(&GetState, &Val, RTGETOPT_REQ_STRING), VINF_SUCCESS, 1);
423	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "secondvalue"));
424	CHECK(GetState.uIndex == UINT32_MAX);
425
426	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 406, 2);
427	CHECK(Val.u32 == 1);
428	CHECK(GetState.uIndex == 4);
429	CHECK_GETOPT(RTGetOptFetchValue(&GetState, &Val, RTGETOPT_REQ_UINT32), VINF_SUCCESS, 1);
430	CHECK(Val.u32 == 10);
431	CHECK(GetState.uIndex == 4);
432
433	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 406, 1);
434	CHECK(Val.u32 == 2);
435	CHECK(GetState.uIndex == 5);
436	CHECK_GETOPT(RTGetOptFetchValue(&GetState, &Val, RTGETOPT_REQ_UINT32), VINF_SUCCESS, 1);
437	CHECK(Val.u32 == 11);
438	CHECK(GetState.uIndex == 5);
439
440	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 407, 2);
441	CHECK(Val.u32 == 1);
442	CHECK(GetState.uIndex == UINT32_MAX);
443	CHECK_GETOPT(RTGetOptFetchValue(&GetState, &Val, RTGETOPT_REQ_UINT32), VINF_SUCCESS, 1);
444	CHECK(Val.u32 == 12);
445	CHECK(GetState.uIndex == UINT32_MAX);
446	CHECK_GETOPT(RTGetOptFetchValue(&GetState, &Val, RTGETOPT_REQ_STRING), VINF_SUCCESS, 1);
447	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "thirdvalue"));
448	CHECK(GetState.uIndex == UINT32_MAX);
449
450	/* bool on/off tests */
451	RTTestSub(hTest, "RTGetOpt - bool on/off");
452	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 408, 2);
453	CHECK(Val.f);
454	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 408, 2);
455	CHECK(!Val.f);
456	CHECK_GETOPT(RTGetOpt(&GetState, &Val), VERR_GETOPT_UNKNOWN_OPTION, 2);
457	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "invalid"));
458
459	/* bool on/off with indexed argument */
460	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 409, 2);
461	CHECK(Val.f);
462	CHECK(GetState.uIndex == 2);
463	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 409, 2);
464	CHECK(!Val.f);
465	CHECK(GetState.uIndex == 7);
466	CHECK_GETOPT(RTGetOpt(&GetState, &Val), VERR_GETOPT_UNKNOWN_OPTION, 2);
467	CHECK(RT_VALID_PTR(Val.psz) && !strcmp(Val.psz, "invalid"));
468
469	/* bool on/off with optional indexed argument */
470	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 413, 2);
471	CHECK(Val.f);
472	CHECK(GetState.uIndex == 9);
473
474	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 413, 2);
475	CHECK(!Val.f);
476	CHECK(GetState.uIndex == 0);
477
478	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 414, 2);
479	CHECK(!Val.f);
480	CHECK(GetState.uIndex == 42);
481
482	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 414, 2);
483	CHECK(Val.f);
484	CHECK(GetState.uIndex == 1);
485
486	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 415, 2);
487	CHECK(!Val.f);
488	CHECK(GetState.uIndex == 0);
489
490	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 415, 2);
491	CHECK(Val.f);
492	CHECK(GetState.uIndex == 2);
493
494	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 415, 1);
495	CHECK(!Val.f);
496	CHECK(GetState.uIndex == 3);
497
498	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 415, 1);
499	CHECK(Val.f);
500	CHECK(GetState.uIndex == 0);
501
502	/* standard options. */
503	RTTestSub(hTest, "Standard options");
504	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'h', 1);
505	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'h', 1);
506	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'h', 1);
507	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'h', 1);
508	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'V', 1);
509	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'V', 1);
510	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'V', 1);
511
512	/* 32-bit pairs */
513	RTTestSub(hTest, "RTGetOpt - pairs");
514	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 410, 2);
515	CHECK(Val.PairU32.uFirst == 1536);
516	CHECK(Val.PairU32.uSecond == 0x1536);
517	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 411, 2);
518	CHECK(Val.PairU32.uFirst == 0x42);
519	CHECK(Val.PairU32.uSecond == 42);
520	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 411, 2);
521	CHECK(Val.PairU32.uFirst == 128);
522	CHECK(Val.PairU32.uSecond == UINT32_MAX);
523	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 412, 2);
524	CHECK(Val.PairU64.uFirst == 0x128);
525	CHECK(Val.PairU64.uSecond == 0x42);
526	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 412, 2);
527	CHECK(Val.PairU64.uFirst == 0x128);
528	CHECK(Val.PairU64.uSecond == 0x42);
529	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 412, 2);
530	CHECK(Val.PairU64.uFirst == 0x128);
531	CHECK(Val.PairU64.uSecond == UINT64_MAX);
532
533	/* various utf-8 dashes: */
534	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 384, 1);
535	CHECK_pDef(s_aOpts2, 4);
536
537	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 415, 2);
538	CHECK(!Val.f);
539	CHECK(GetState.uIndex == 2);
540
541	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'q', 0);
542	CHECK_pDef(s_aOpts2, 3);
543	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'V', 1);
544
545	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 414, 2);
546	CHECK(Val.f);
547	CHECK(GetState.uIndex == 42);
548
549	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 403, 1);
550	CHECK(GetState.uIndex == 2);
551
552	/* the end */
553	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 0, 0);
554	CHECK(Val.pDef == NULL);
555	CHECK(argc2 == GetState.iNext);
556
557	/*
558	* Options first.
559	*/
560	RTTestSub(hTest, "Options first");
561	const char *argv3[] =
562	{
563	"foo1",
564	"-s", "string1",
565	"foo2",
566	"--optwithstring", "string2",
567	"foo3",
568	"-i", "-42",
569	"foo4",
570	"-i:-42",
571	"-i=-42",
572	"foo5",
573	"foo6",
574	"foo7",
575	"-i:-42",
576	"-i=-42",
577	"foo8",
578	"--twovalues", "firstvalue", "secondvalue",
579	"foo9",
580	"--twovalues:firstvalue", "secondvalue",
581	"foo10",
582	"--",
583	"--optwithstring",
584	"-s",
585	"-i",
586	"foo11",
587	"foo12",
588
589	/* done */
590	NULL
591	};
592	int argc3 = (int)RT_ELEMENTS(argv3) - 1;
593
594	CHECK(RT_SUCCESS(RTGetOptInit(&GetState, argc3, (char **)argv3, &s_aOpts2[0], RT_ELEMENTS(s_aOpts2), 0,
595	RTGETOPTINIT_FLAGS_OPTS_FIRST)));
596
597	/* -s */
598	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), 's', 2, "string1");
599	CHECK(GetState.uIndex == UINT32_MAX);
600	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), 's', 2, "string2");
601	CHECK(GetState.uIndex == UINT32_MAX);
602
603	/* -i */
604	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'i', 2);
605	CHECK(Val.i32 == -42);
606	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'i', 1);
607	CHECK(Val.i32 == -42);
608	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'i', 1);
609	CHECK(Val.i32 == -42);
610	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'i', 1);
611	CHECK(Val.i32 == -42);
612	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'i', 1);
613	CHECK(Val.i32 == -42);
614
615	/* --twovalues */
616	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), 405, 2, "firstvalue");
617	CHECK(GetState.uIndex == UINT32_MAX);
618	CHECK_GETOPT_STR(RTGetOptFetchValue(&GetState, &Val, RTGETOPT_REQ_STRING), VINF_SUCCESS, 1, "secondvalue");
619	CHECK(GetState.uIndex == UINT32_MAX);
620
621	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), 405, 1, "firstvalue");
622	CHECK(GetState.uIndex == UINT32_MAX);
623	CHECK_GETOPT_STR(RTGetOptFetchValue(&GetState, &Val, RTGETOPT_REQ_STRING), VINF_SUCCESS, 1, "secondvalue");
624	CHECK(GetState.uIndex == UINT32_MAX);
625
626	/* -- */
627	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 2, "foo1");
628	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo2");
629	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo3");
630	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo4");
631	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo5");
632	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo6");
633	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo7");
634	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo8");
635	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo9");
636	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo10");
637	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "--optwithstring");
638	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "-s");
639	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "-i");
640	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo11");
641	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo12");
642
643	/* the end */
644	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 0, 0);
645	CHECK(Val.pDef == NULL);
646	CHECK(argc3 == GetState.iNext);
647
648	/*
649	* Options first, part 2: No dash-dash.
650	*/
651	const char *argv4[] =
652	{
653	"foo1",
654	"-s", "string1",
655	"foo2",
656	"--optwithstring", "string2",
657	"foo3",
658	"-i", "-42",
659	"foo4",
660	"-i:-42",
661	"-i=-42",
662	"foo5",
663	"foo6",
664	"foo7",
665	"-i:-42",
666	"-i=-42",
667	"foo8",
668	"--twovalues", "firstvalue", "secondvalue",
669	"foo9",
670	"--twovalues:firstvalue", "secondvalue",
671	"foo10",
672	"foo11",
673	"foo12",
674
675	/* done */
676	NULL
677	};
678	int argc4 = (int)RT_ELEMENTS(argv4) - 1;
679
680	CHECK(RT_SUCCESS(RTGetOptInit(&GetState, argc4, (char **)argv4, &s_aOpts2[0], RT_ELEMENTS(s_aOpts2), 0,
681	RTGETOPTINIT_FLAGS_OPTS_FIRST)));
682
683	/* -s */
684	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), 's', 2, "string1");
685	CHECK(GetState.uIndex == UINT32_MAX);
686	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), 's', 2, "string2");
687	CHECK(GetState.uIndex == UINT32_MAX);
688
689	/* -i */
690	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'i', 2);
691	CHECK(Val.i32 == -42);
692	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'i', 1);
693	CHECK(Val.i32 == -42);
694	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'i', 1);
695	CHECK(Val.i32 == -42);
696	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'i', 1);
697	CHECK(Val.i32 == -42);
698	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 'i', 1);
699	CHECK(Val.i32 == -42);
700
701	/* --twovalues */
702	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), 405, 2, "firstvalue");
703	CHECK(GetState.uIndex == UINT32_MAX);
704	CHECK_GETOPT_STR(RTGetOptFetchValue(&GetState, &Val, RTGETOPT_REQ_STRING), VINF_SUCCESS, 1, "secondvalue");
705	CHECK(GetState.uIndex == UINT32_MAX);
706
707	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), 405, 1, "firstvalue");
708	CHECK(GetState.uIndex == UINT32_MAX);
709	CHECK_GETOPT_STR(RTGetOptFetchValue(&GetState, &Val, RTGETOPT_REQ_STRING), VINF_SUCCESS, 1, "secondvalue");
710	CHECK(GetState.uIndex == UINT32_MAX);
711
712	/* -- */
713	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo1");
714	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo2");
715	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo3");
716	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo4");
717	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo5");
718	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo6");
719	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo7");
720	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo8");
721	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo9");
722	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo10");
723	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo11");
724	CHECK_GETOPT_STR(RTGetOpt(&GetState, &Val), VINF_GETOPT_NOT_OPTION, 1, "foo12");
725
726	/* the end */
727	CHECK_GETOPT(RTGetOpt(&GetState, &Val), 0, 0);
728	CHECK(Val.pDef == NULL);
729	CHECK(argc4 == GetState.iNext);
730
731	/*
732	* Some negative testing.
733	*/
734	const char *argv5[] =
735	{
736	"non-option-argument",
737	"--optwithstring", /* missing string */
738	/* done */
739	NULL
740	};
741	int argc5 = (int)RT_ELEMENTS(argv5) - 1;
742	CHECK(RT_SUCCESS(RTGetOptInit(&GetState, argc5, (char **)argv5, &s_aOpts2[0], RT_ELEMENTS(s_aOpts2), 0,
743	RTGETOPTINIT_FLAGS_OPTS_FIRST)));
744	RTTESTI_CHECK_RC(RTGetOpt(&GetState, &Val), VERR_GETOPT_REQUIRED_ARGUMENT_MISSING);
745
746
747	/*
748	* Summary.
749	*/
750	return RTTestSummaryAndDestroy(hTest);
751	}
752

Note: See TracBrowser for help on using the repository browser.

source: vbox/trunk/src/VBox/Runtime/testcase/tstRTGetOpt.cpp@ 102792

Download in other formats: