0
0
Fork 0
mirror of https://github.com/matrix-construct/construct synced 2024-11-16 06:51:08 +01:00
construct/include/ircd/util/params.h

111 lines
2.5 KiB
C++

// Matrix Construct
//
// Copyright (C) Matrix Construct Developers, Authors & Contributors
// Copyright (C) 2016-2018 Jason Volk <jason@zemos.net>
//
// Permission to use, copy, modify, and/or distribute this software for any
// purpose with or without fee is hereby granted, provided that the above
// copyright notice and this permission notice is present in all copies. The
// full license for this software is available in the LICENSE file.
#pragma once
#define HAVE_IRCD_UTIL_PARAMS_H
// This file is not part of the standard include stack. It is included
// manually as needed.
namespace ircd::util
{
struct params;
}
class ircd::util::params
{
string_view in;
const char *sep;
std::vector<const char *> names;
const char *name(const size_t &i) const;
public:
IRCD_EXCEPTION(ircd::error, error)
IRCD_EXCEPTION(error, missing)
IRCD_EXCEPTION(error, invalid)
size_t count() const;
string_view operator[](const size_t &i) const; // returns empty
template<class T> T at(const size_t &i, const T &def) const; // throws invalid
template<class T> T at(const size_t &i) const; // throws missing or invalid
string_view at(const size_t &i) const; // throws missing
params(const string_view &in,
const char *const &sep,
const std::initializer_list<const char *> &names = {});
};
inline
ircd::util::params::params(const string_view &in,
const char *const &sep,
const std::initializer_list<const char *> &names)
:in{in}
,sep{sep}
,names{names}
{
}
template<class T>
T
ircd::util::params::at(const size_t &i,
const T &def)
const try
{
return count() > i? at<T>(i) : def;
}
catch(const bad_lex_cast &e)
{
throw invalid("parameter #%zu <%s>", i, name(i));
}
template<class T>
T
ircd::util::params::at(const size_t &i)
const try
{
return lex_cast<T>(at(i));
}
catch(const bad_lex_cast &e)
{
throw invalid("parameter #%zu <%s>", i, name(i));
}
inline ircd::string_view
ircd::util::params::at(const size_t &i)
const try
{
return token(in, sep, i);
}
catch(const std::out_of_range &e)
{
throw missing("required parameter #%zu <%s>", i, name(i));
}
inline ircd::string_view
ircd::util::params::operator[](const size_t &i)
const
{
return count() > i? token(in, sep, i) : string_view{};
}
inline size_t
ircd::util::params::count()
const
{
return token_count(in, sep);
}
inline const char *
ircd::util::params::name(const size_t &i)
const
{
return names.size() > i? *std::next(begin(names), i) : "<unnamed>";
}