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
|
// file : build/config/utility -*- C++ -*-
// copyright : Copyright (c) 2014-2015 Code Synthesis Ltd
// license : MIT; see accompanying LICENSE file
#ifndef BUILD_CONFIG_UTILITY
#define BUILD_CONFIG_UTILITY
#include <string>
#include <utility> // pair
#include <functional> // reference_wrapper
#include <build/types>
#include <build/variable>
#include <build/diagnostics>
namespace build
{
class scope;
namespace config
{
// Set, if necessary, a required config.* variable.
//
// If override is true and the variable doesn't come from this root
// scope or from the command line, then its value is "overridden"
// for this root scope.
//
// Return the reference to the value as well as the indication of
// whether the variable has actually been set.
//
template <typename T>
std::pair<std::reference_wrapper<const value>, bool>
required (scope& root,
const variable&,
const T& default_value,
bool override = false);
template <typename T>
inline std::pair<std::reference_wrapper<const value>, bool>
required (scope& root,
const std::string& name,
const T& default_value,
bool override = false)
{
return required (root, var_pool.find (name), default_value, override);
}
inline std::pair<std::reference_wrapper<const value>, bool>
required (scope& root,
const std::string& name,
const char* default_value,
bool override = false)
{
return required (root, name, std::string (default_value), override);
}
// Set, if necessary, an optional config.* variable. In particular,
// an unspecified variable is set to NULL which is used to distinguish
// between the "configured as unspecified" and "not yet configured"
// cases.
//
// Return the value, which can be NULL.
//
const value&
optional (scope& root, const variable&);
inline const value&
optional (scope& root, const std::string& var)
{
return optional (root, var_pool.find (var));
}
// As above but assumes the value is dir_path and makes it
// absolute if the value specified on the command line is
// relative.
//
const value&
optional_absolute (scope& root, const variable&);
inline const value&
optional_absolute (scope& root, const std::string& var)
{
return optional_absolute (root, var_pool.find (var));
}
// Check whether there are any variables specified from the config
// namespace. The idea is that we can check if there are any, say,
// config.install.* values. If there are none, then we can assume
// this functionality is not (yet) used and omit writing a whole
// bunch of NULL config.install.* values to the config.build file.
// We call it omitted/delayed configuration.
//
// Note that this function detects and ignores the special
// config.*.configured variable which may be used by a module to
// "remember" that it is unconfigured.
//
bool
specified (scope& root, const std::string& ns);
// @@ Why are these here?
//
// Add all the values from a variable to the C-string list. T is
// either target or scope. The variable is expected to be of type
// strings.
//
template <typename T>
void
append_options (cstrings& args, T& s, const char* var);
// As above but from the strings value directly.
//
void
append_options (cstrings& args, const const_strings_value&);
// Check if a specified option is present in the variable value.
// T is either target or scope.
//
template <typename T>
bool
find_option (const char* option, T& s, const char* var);
}
}
#include <build/config/utility.txx>
#include <build/config/utility.ixx>
#endif // BUILD_CONFIG_UTILITY
|
