File: MICmdArgValOptionLong.h

package info (click to toggle)
llvm-toolchain-3.5 1%3A3.5-10
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 282,028 kB
  • ctags: 310,872
  • sloc: cpp: 1,883,926; ansic: 310,731; objc: 86,612; python: 79,565; asm: 65,844; sh: 9,829; makefile: 6,057; perl: 5,589; ml: 5,254; pascal: 3,285; lisp: 1,640; xml: 686; cs: 239; csh: 117
file content (109 lines) | stat: -rw-r--r-- 3,981 bytes parent folder | download | duplicates (2)
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
//===-- MICmdArgValOptionLong.h ---------------------------------*- C++ -*-===//
//
//                     The LLVM Compiler Infrastructure
//
// This file is distributed under the University of Illinois Open Source
// License. See LICENSE.TXT for details.
//
//===----------------------------------------------------------------------===//

//++
// File:		MICmdArgValOptionLong.h
//
// Overview:	CMICmdArgValOptionLong interface.
//
// Environment:	Compilers:	Visual C++ 12.
//							gcc (Ubuntu/Linaro 4.8.1-10ubuntu9) 4.8.1
//				Libraries:	See MIReadmetxt. 
//
// Copyright:	None.
//--

#pragma once

// In-house headers:
#include "MICmdArgValListBase.h"

// Declarations:
class CMICmdArgContext;
class CMIUtilString;

//++ ============================================================================
// Details:	MI common code class. Command argument class. Arguments object
//			needing specialization derived from the CMICmdArgValBase class. 
//			An argument knows what type of argument it is and how it is to 
//			interpret the options (context) string to find and validate a matching 
//			argument and so extract a value from it.
//			If *this argument has expected options following it the option objects
//			created to hold each of those option's values belong to *this argument
//			object and so are deleted when *this object goes out of scope.
//			Based on the Interpreter pattern.
// Gotchas:	None.
// Authors:	Illya Rudkin 16/04/2014.
// Changes:	None.
//--
class CMICmdArgValOptionLong : public CMICmdArgValListBase
{
// Methods:
public:
	/* ctor */	CMICmdArgValOptionLong( void );
	/* ctor */	CMICmdArgValOptionLong( const CMIUtilString & vrArgName, const bool vbMandatory, const bool vbHandleByCmd );
	/* ctor */	CMICmdArgValOptionLong( const CMIUtilString & vrArgName, const bool vbMandatory, const bool vbHandleByCmd, const ArgValType_e veType, const MIuint vnExpectingNOptions );
	//
	bool					IsArgLongOption( const CMIUtilString & vrTxt ) const;
	const VecArgObjPtr_t &	GetExpectedOptions( void ) const;
	template< class T1, typename T2 >
		bool				GetExpectedOption( T2 & vrwValue ) const;
	
// Overridden:
public:
	// From CMICmdArgValBase
	/* dtor */ virtual ~CMICmdArgValOptionLong( void );
	// From CMICmdArgSet::IArg
	virtual bool	Validate( CMICmdArgContext & vArgContext );

// Methods:
protected:
	bool	ExtractExpectedOptions( CMICmdArgContext & vrwTxt, const MIuint nArgIndex );

// Overrideable:
protected:
	virtual bool IsArgOptionCorrect( const CMIUtilString & vrTxt ) const;
	virtual	bool ArgNameMatch( const CMIUtilString & vrTxt ) const;

// Methods:
private:
	void	Destroy( void );

// Attributes:
private:
	MIuint			m_nExpectingNOptions;	// The number of options expected to read following *this argument
	VecArgObjPtr_t	m_vecArgsExpected;		// The option objects holding the value extracted following *this argument
	ArgValType_e	m_eExpectingOptionType;	// The type of options expected to read following *this argument
};

//++ ------------------------------------------------------------------------------------
// Details:	Retrieve the first argument or option value from the list of 1 or more options
//			parsed from the command's options string.
// Type:	Template method.
// Args:	vrwValue	- (W) Templated type return value.
//			T1			- The argument value's class type of the data hold in the list of options.
//			T2			- The type pf the variable which holds the value wanted.
// Return:	MIstatus::success - Functional succeeded.
//			MIstatus::failure - Functional failed. List of object was empty.
// Throws:	None.
//--
template< class T1, typename T2 >
bool CMICmdArgValOptionLong::GetExpectedOption( T2 & vrwValue ) const
{
	const VecArgObjPtr_t & rVecOptions( GetExpectedOptions() );
	VecArgObjPtr_t::const_iterator it2 = rVecOptions.begin();
	if( it2 != rVecOptions.end() )
	{
		const T1 * pOption = static_cast< T1 * >( *it2 );
		vrwValue = pOption->GetValue();
		return MIstatus::success;
	}

	return MIstatus::failure;
}