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 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378
|
/*
* Copyright 2012 Open Source Robotics Foundation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*/
#ifndef SDFORMAT_PARAM_HH_
#define SDFORMAT_PARAM_HH_
#include <any>
#include <algorithm>
#include <cctype>
#include <cstdint>
#include <functional>
#include <memory>
#include <sstream>
#include <string>
#include <typeinfo>
#include <variant>
#include <vector>
#include <ignition/math.hh>
#include "sdf/Console.hh"
#include "sdf/sdf_config.h"
#include "sdf/system_util.hh"
#include "sdf/Types.hh"
#ifdef _WIN32
// Disable warning C4251 which is triggered by
// std::unique_ptr
#pragma warning(push)
#pragma warning(disable: 4251)
#endif
namespace sdf
{
// Inline bracket to help doxygen filtering.
inline namespace SDF_VERSION_NAMESPACE {
//
class SDFORMAT_VISIBLE Param;
/// \def ParamPtr
/// \brief Shared pointer to a Param
typedef std::shared_ptr<Param> ParamPtr;
/// \def Param_V
/// \brief vector of shared pointers to a Param
typedef std::vector<ParamPtr> Param_V;
/// \internal
class ParamPrivate;
template<class T>
struct ParamStreamer
{
const T &val;
};
template<class T> ParamStreamer(T) -> ParamStreamer<T>;
template<class T>
std::ostream& operator<<(std::ostream &os, ParamStreamer<T> s)
{
os << s.val;
return os;
}
template<class... Ts>
std::ostream& operator<<(std::ostream& os,
ParamStreamer<std::variant<Ts...>> sv)
{
std::visit([&os](auto const &v)
{
os << ParamStreamer{v};
}, sv.val);
return os;
}
/// \class Param Param.hh sdf/sdf.hh
/// \brief A parameter class
class SDFORMAT_VISIBLE Param
{
/// \brief Constructor.
/// \param[in] _key Key for the parameter.
/// \param[in] _typeName String name for the value type (double,
/// int,...).
/// \param[in] _default Default value.
/// \param[in] _required True if the parameter is required to be set.
/// \param[in] _description Description of the parameter.
/// \throws sdf::AssertionInternalError if an invalid type is given.
public: Param(const std::string &_key, const std::string &_typeName,
const std::string &_default, bool _required,
const std::string &_description = "");
/// \brief Destructor
public: virtual ~Param();
/// \brief Get the value as a string.
/// \return String containing the value of the parameter.
public: std::string GetAsString() const;
/// \brief Get the default value as a string.
/// \return String containing the default value of the parameter.
public: std::string GetDefaultAsString() const;
/// \brief Set the parameter value from a string.
/// \param[in] _value New value for the parameter in string form.
public: bool SetFromString(const std::string &_value);
/// \brief Reset the parameter to the default value.
public: void Reset();
/// \brief Get the key value.
/// \return The key.
public: const std::string &GetKey() const;
/// \brief Return true if the param is a particular type
/// \return True if the type held by this Param matches the Type
/// template parameter.
public: template<typename Type>
bool IsType() const;
/// \brief Get the type name value.
/// \return The type name.
public: const std::string &GetTypeName() const;
/// \brief Return whether the parameter is required.
/// \return True if the parameter is required.
public: bool GetRequired() const;
/// \brief Return true if the parameter has been set.
/// \return True if the parameter has been set.
public: bool GetSet() const;
/// \brief Clone the parameter.
/// \return A new parameter that is the clone of this.
public: ParamPtr Clone() const;
/// \brief Set the update function. The updateFunc will be used to
/// set the parameter's value when Param::Update is called.
/// \param[in] _updateFunc Function pointer to an update function.
public: template<typename T>
void SetUpdateFunc(T _updateFunc);
/// \brief Set the parameter's value using the updateFunc.
/// \sa Param::SetUpdateFunc
public: void Update();
/// \brief Set the parameter's value.
///
/// The passed in value value must have an input and output stream operator.
/// \param[in] _value The value to set the parameter to.
/// \return True if the value was successfully set.
public: template<typename T>
bool Set(const T &_value);
/// \brief Get the value of the parameter as a std::any.
/// \param[out] _anyVal The std::any object to set.
/// \return True if successfully fetched _anyVal, false otherwise.
public: bool GetAny(std::any &_anyVal) const;
/// \brief Get the value of the parameter.
/// \param[out] _value The value of the parameter.
/// \return True if parameter was successfully cast to the value type
/// passed in.
public: template<typename T>
bool Get(T &_value) const;
/// \brief Get the default value of the parameter.
/// \param[out] _value The default value of the parameter.
/// \return True if parameter was successfully cast to the value type
/// passed in.
public: template<typename T>
bool GetDefault(T &_value) const;
/// \brief Equal operator. Set's the value and default value from the
/// provided Param.
/// \param[in] _param The parameter to set values from.
/// \return *This
public: Param &operator=(const Param &_param);
/// \brief Set the description of the parameter.
/// \param[in] _desc New description for the parameter.
public: void SetDescription(const std::string &_desc);
/// \brief Get the description of the parameter.
/// \return The description of the parameter.
public: std::string GetDescription() const;
/// \brief Ostream operator. Outputs the parameter's value.
/// \param[in] _out Output stream.
/// \param[in] _p The parameter to output.
/// \return The output stream.
public: friend std::ostream &operator<<(std::ostream &_out,
const Param &_p)
{
_out << _p.GetAsString();
return _out;
}
/// \brief Private method to set the Element from a passed-in string.
/// \param[in] _value Value to set the parameter to.
private: bool ValueFromString(const std::string &_value);
/// \brief Private data
private: std::unique_ptr<ParamPrivate> dataPtr;
};
/// \internal
/// \brief Private data for the param class
class ParamPrivate
{
/// \brief Key value
public: std::string key;
/// \brief True if the parameter is required.
public: bool required;
/// \brief True if the parameter is set.
public: bool set;
//// \brief Name of the type.
public: std::string typeName;
/// \brief Description of the parameter.
public: std::string description;
/// \brief Update function pointer.
public: std::function<std::any ()> updateFunc;
/// \def ParamVariant
/// \brief Variant type def.
public: typedef std::variant<bool, char, std::string, int, std::uint64_t,
unsigned int, double, float, sdf::Time,
ignition::math::Angle,
ignition::math::Color,
ignition::math::Vector2i,
ignition::math::Vector2d,
ignition::math::Vector3d,
ignition::math::Quaterniond,
ignition::math::Pose3d> ParamVariant;
/// \brief This parameter's value
public: ParamVariant value;
/// \brief This parameter's default value
public: ParamVariant defaultValue;
};
///////////////////////////////////////////////
template<typename T>
void Param::SetUpdateFunc(T _updateFunc)
{
this->dataPtr->updateFunc = _updateFunc;
}
///////////////////////////////////////////////
template<typename T>
bool Param::Set(const T &_value)
{
try
{
std::stringstream ss;
ss << _value;
return this->SetFromString(ss.str());
}
catch(...)
{
sdferr << "Unable to set parameter["
<< this->dataPtr->key << "]."
<< "Type used must have a stream input and output operator,"
<< "which allows proper functioning of Param.\n";
return false;
}
}
///////////////////////////////////////////////
template<typename T>
bool Param::Get(T &_value) const
{
try
{
if (typeid(T) == typeid(bool) && this->dataPtr->typeName == "string")
{
std::string strValue = std::get<std::string>(this->dataPtr->value);
std::transform(strValue.begin(), strValue.end(), strValue.begin(),
[](unsigned char c)
{
return static_cast<unsigned char>(std::tolower(c));
});
std::stringstream tmp;
if (strValue == "true" || strValue == "1")
{
tmp << "1";
}
else
{
tmp << "0";
}
tmp >> _value;
}
else
{
T *value = std::get_if<T>(&this->dataPtr->value);
if (value)
_value = *value;
else
{
std::stringstream ss;
ss << ParamStreamer{this->dataPtr->value};
ss >> _value;
}
}
}
catch(...)
{
sdferr << "Unable to convert parameter["
<< this->dataPtr->key << "] "
<< "whose type is["
<< this->dataPtr->typeName << "], to "
<< "type[" << typeid(T).name() << "]\n";
return false;
}
return true;
}
///////////////////////////////////////////////
template<typename T>
bool Param::GetDefault(T &_value) const
{
std::stringstream ss;
try
{
ss << ParamStreamer{this->dataPtr->defaultValue};
ss >> _value;
}
catch(...)
{
sdferr << "Unable to convert parameter["
<< this->dataPtr->key << "] "
<< "whose type is["
<< this->dataPtr->typeName << "], to "
<< "type[" << typeid(T).name() << "]\n";
return false;
}
return true;
}
///////////////////////////////////////////////
template<typename Type>
bool Param::IsType() const
{
return std::holds_alternative<Type>(this->dataPtr->value);
}
}
}
#ifdef _WIN32
#pragma warning(pop)
#endif
#endif
|