Utilities. More...
Namespaces | |
namespace | datetime |
Date and time utilities. | |
namespace | generators |
Generators. | |
namespace | log |
Algorithms to aid logging. | |
namespace | text |
Text utilities. | |
Classes | |
class | AnyMovable |
Replacement for std::any that is not copyable. It allows to store non-copyable and even non-movable types. More... | |
class | AnyStorage |
map-like heterogeneous data storage More... | |
class | AnyStorageDataTag |
class | AtomicFlags |
Wrapper to extend enum with atomic flags interface. More... | |
class | bad_expected_access |
class | BadAnyMovableCast |
The exception that is thrown when AnyCast fails. More... | |
struct | CachedHash |
Holds the key and its hash for faster comparisons and hashing. More... | |
class | CachedHashKeyEqual |
Compares utils::CachedHash only by keys. More... | |
class | CachedHashKeyEqual< Equal, std::false_type > |
class | CheckedPtr |
Utility template for returning a pointer to an object that is owned by someone else; throws std::runtime_error if nullptr is stored. More... | |
class | CheckedPtr< T & > |
class | CpuRelax |
class | CurrentThreadNameGuard |
RAII helper to run some code with a temporary current thread name. More... | |
class | expected |
For holding a value or an error. More... | |
class | FastPimpl |
Implements pimpl idiom without dynamic memory allocation. More... | |
class | FastScopeGuard |
a helper class to perform actions on scope exit More... | |
class | FilterBloom |
Space-efficient probabilistic data structure. More... | |
class | FixedArray |
A fixed-size array with the size determined at runtime. More... | |
class | Flags |
Wrapper to extend enum with flags interface. More... | |
struct | HashSeed |
The seed structure used by underlying hashing implementation. More... | |
class | InvariantError |
Exception that is thrown on UINVARIANT violation. More... | |
class | LazyPrvalue |
Can be used with various emplace functions to allow in-place constructing a non-movable value using a callable. More... | |
class | LazySharedPtr |
A lazy wrapper around utils::SharedReadablePtr that fetches the data on first access. More... | |
class | MacaddrBase |
Base class for Macaddr/Macaddr8. More... | |
class | NotNull |
Restricts a pointer or smart pointer to only hold non-null values. More... | |
class | OptionalRef |
Class that behaves as a nullable reference. Main difference from the pointer - value comparison of pointed values. More... | |
struct | Overloaded |
Utility to define std::variant visitors in a simple way. More... | |
class | PeriodicTask |
Task that periodically runs a user callback. Callback is started after the previous callback execution is finished every period + A - B , where: More... | |
class | RandomBase |
Virtualized standard UniformRandomBitGenerator concept, for use with random number distributions. More... | |
class | regex |
Small alias for boost::regex / std::regex without huge includes. More... | |
class | ResultStore |
class | ResultStore< void > |
class | ScopeGuard |
a helper class to perform actions on scope exit More... | |
class | ScopeTimePause |
Utility to easily pause ScopeTime, e.g. when yielding. More... | |
class | SharedReadablePtr |
std::shared_ptr<const T> wrapper that makes sure that the pointer is stored before dereferencing. Protects from dangling references: More... | |
class | SlidingInterval |
Sliding interval of values that provides functions to compute average, min and max values from the last window_size values of interval. More... | |
class | SmallString |
An alternative to std::string with a custom SSO (small string optimization) container size. Unlike std::string, SmallString is not null-terminated thus it has no c_str(), data() returns a not null-terminated buffer. More... | |
class | StrCaseHash |
Case sensitive ASCII hashing functor. More... | |
class | StreamingCpuRelax |
class | StrIcaseCompareThreeWay |
Case insensitive ASCII 3-way comparison functor. More... | |
class | StrIcaseEqual |
Case insensitive ASCII equality comparison functor. More... | |
class | StrIcaseHash |
Case insensitive ASCII hashing functor. More... | |
class | StrIcaseLess |
Case insensitive ASCII less comparison functor. More... | |
class | StrongTypedef |
Strong typedef for a type T. More... | |
class | SwappingSmart |
class | TokenBucket |
class | TracefulException |
Exception that remembers the backtrace at the point of its construction. More... | |
class | TracefulExceptionBase |
Base class implementing backtrace storage and message builder, published only for documentation purposes, please inherit from utils::TracefulException instead. More... | |
class | TrivialBiMap |
Bidirectional unordered map for trivial types, including string literals; could be efficiently used as a unordered non-bidirectional map. More... | |
class | TrivialSet |
Unordered set for trivial types, including string literals. More... | |
class | unexpected |
Typedefs | |
using | Macaddr = MacaddrBase< 6 > |
48-bit MAC address | |
using | Macaddr8 = MacaddrBase< 8 > |
64-bit MAC address | |
template<typename U > | |
using | SharedRef = NotNull< std::shared_ptr< U > > |
A std::shared_ptr that is guaranteed to be not-null. | |
template<typename U > | |
using | UniqueRef = NotNull< std::unique_ptr< U > > |
A std::unique_ptr that is guaranteed to be not-null. | |
template<typename Value , auto Projection, typename Hash = void, typename Equal = std::equal_to<>, typename Allocator = std::allocator<Value>> | |
using | ProjectedUnorderedSet = std::unordered_set< Value, impl::projected_set::Hash< Value, Projection, Hash >, impl::projected_set::Compare< Value, Projection, Equal >, Allocator > |
A std::unordered_set that compares its elements (of type Value) based on their Projection. It allows to create, essentially, an equivalent of std::unordered_map where keys are stored inside values. | |
template<typename Value , auto Projection, typename Compare = std::less<>, typename Allocator = std::allocator<Value>> | |
using | ProjectedSet = std::set< Value, impl::projected_set::Compare< Value, Projection, Compare >, Allocator > |
Same as ProjectedUnorderedSet, but for std::set . | |
template<class Tag , class T > | |
using | NonLoggable = StrongTypedef< Tag, T, StrongTypedefOps::kCompareStrong|StrongTypedefOps::kNonLoggable > |
template<typename... T> | |
using | void_t = std::void_t< T... > |
std::void_t implementation with workarounds for compiler bugs | |
Enumerations | |
enum class | BytesPerSecond : long long |
Data type that represents bytes per second unit. More... | |
enum class | StrongTypedefOps { kNoCompare = 0 , kCompareStrong = 1 , kCompareTransparentOnly = 2 , kCompareTransparent = 3 , kNonLoggable = 4 } |
Functions | |
template<typename... Strings> | |
std::string | StrCat (const Strings &... strings) |
Concatenates multiple std::string_view -convertible items. | |
template<class Map , class Key > | |
auto * | FindOrNullptr (Map &map, const Key &key) |
Returns nullptr if no key in associative container, otherwise returns pointer to value. | |
template<class Map , class Key , class Default > | |
Map::mapped_type | FindOrDefault (Map &map, const Key &key, Default &&def) |
Returns default value if no key in associative container, otherwise returns a copy of the stored value. | |
template<class Map , class Key > | |
Map::mapped_type | FindOrDefault (Map &map, const Key &key) |
Returns default value if no key in associative container, otherwise returns a copy of the stored value. | |
template<class Map , class Key > | |
std::optional< typename Map::mapped_type > | FindOptional (Map &map, const Key &key) |
Returns std::nullopt if no key in associative container, otherwise returns std::optional with a copy of value. | |
template<typename Map , typename Key > | |
auto | CheckedFind (Map &map, const Key &key) -> decltype(utils::MakeCheckedPtr(&map.find(key) ->second)) |
Searches a map for an element and return a checked pointer to the found element. | |
template<class ToContainer , class FromContainer > | |
ToContainer | AsContainer (FromContainer &&container) |
Converts one container type to another. | |
template<class Container , class Pred > | |
auto | EraseIf (Container &container, Pred pred) |
Erased elements and returns number of deleted elements. | |
template<class Container , class T > | |
size_t | Erase (Container &container, const T &elem) |
Erased elements and returns number of deleted elements. | |
template<typename Container , typename Pred > | |
bool | ContainsIf (const Container &container, Pred pred) |
returns true if there is an element in container which satisfies the predicate | |
template<typename ValueType > | |
ValueType * | AnyCast (AnyMovable *operand) noexcept |
template<typename ValueType > | |
const ValueType * | AnyCast (const AnyMovable *operand) noexcept |
template<typename ValueType > | |
ValueType | AnyCast (AnyMovable &operand) |
template<typename ValueType > | |
ValueType | AnyCast (const AnyMovable &operand) |
template<typename ValueType > | |
ValueType | AnyCast (AnyMovable &&operand) |
template<typename T , typename Func > | |
T | AtomicUpdate (std::atomic< T > &atomic, Func updater) |
Atomically performs the operation of updater on atomic | |
template<typename T > | |
T | AtomicMin (std::atomic< T > &atomic, T value) |
Concurrently safe sets atomic to a value if value is less. | |
template<typename T > | |
T | AtomicMax (std::atomic< T > &atomic, T value) |
Concurrently safe sets atomic to a value if value is greater. | |
boost::uuids::uuid | BoostUuidFromString (std::string const &str) |
Parse string into boost::uuids::uuid. | |
std::string | ToString (const boost::uuids::uuid &) |
Serialize boost::uuids::uuid to string. | |
constexpr long long | ToLongLong (BytesPerSecond x) |
constexpr bool | operator== (BytesPerSecond lhs, BytesPerSecond rhs) |
constexpr bool | operator!= (BytesPerSecond lhs, BytesPerSecond rhs) |
BytesPerSecond | StringToBytesPerSecond (const std::string &data) |
template<class Value > | |
BytesPerSecond | Parse (const Value &v, formats::parse::To< BytesPerSecond >) |
template<class T > | |
constexpr bool | operator== (const CachedHash< T > &x, const CachedHash< T > &y) |
Compares utils::CachedHash by hash first and then by keys. | |
template<class T > | |
constexpr bool | operator!= (const CachedHash< T > &x, const CachedHash< T > &y) |
Compares utils::CachedHash by hash first and then by keys. | |
template<typename T > | |
constexpr CheckedPtr< T > | MakeCheckedPtr (T *ptr) noexcept |
template<typename Container > | |
constexpr auto | enumerate (Container &&iterable) |
Implementation of python-style enumerate function for range-for loops. | |
template<typename T = std::runtime_error> | |
void | LogErrorAndThrow (const std::string &error_message) |
Logs error_message and throws an exception ith that message. | |
template<class E > | |
unexpected (E) -> unexpected< E > | |
template<class GeneratorFunc > | |
auto | GenerateFixedArray (std::size_t size, GeneratorFunc &&generator) |
Applies generator to indices in the range [0, size) , storing the results in a new utils::FixedArray. The generator is guaranteed to be invoked in the first-to-last order. | |
template<typename Enum > | |
constexpr Flags< Enum > | operator| (Enum, Flags< Enum >) |
template<typename Enum > | |
constexpr Flags< Enum > | operator& (Enum, Flags< Enum >) |
template<typename Enum > | |
constexpr bool | operator== (Enum, Flags< Enum >) |
template<typename Enum > | |
constexpr bool | operator!= (Enum, Flags< Enum >) |
template<typename Enum > | |
Flags< Enum > | operator| (Enum, const AtomicFlags< Enum > &) |
template<typename Enum > | |
Flags< Enum > | operator& (Enum, const AtomicFlags< Enum > &) |
template<typename Enum > | |
bool | operator== (Enum, const AtomicFlags< Enum > &) |
template<typename Enum > | |
bool | operator!= (Enum, const AtomicFlags< Enum > &) |
template<typename T , typename StringType , typename = std::enable_if_t< std::is_convertible_v<StringType, std::string_view>>> | |
T | FromString (const StringType &str) |
Extract the number contained in the string. No space characters or other extra characters allowed. Supported types: | |
std::int64_t | FromHexString (const std::string &str) |
template<typename Leaf > | |
constexpr auto * | GetIf (Leaf &&leaf) |
template<typename Root , typename Head , typename... Tail> | |
constexpr auto * | GetIf (Root &&root, Head &&head, Tail &&... tail) |
Dereferences a chain of indirections and compositions, returns nullptr if one of the chain elements is not set. | |
std::string | MacaddrToString (Macaddr macaddr) |
Get 48-bit MAC address as a string in "xx:xx:.." format. | |
std::string | Macaddr8ToString (Macaddr8 macaddr) |
Get 64-bit MAC address as a string in "xx:xx:.." format. | |
Macaddr | MacaddrFromString (const std::string &str) |
Get 48-bit MAC address from std::string. | |
Macaddr8 | Macaddr8FromString (const std::string &str) |
Get 64-bit MAC address from std::string. | |
template<class Target , class... Args> | |
boost::intrusive_ptr< Target > | make_intrusive_ptr (Args &&... args) |
Factory function for boost::intrusive_ptr, like std::make_unique. | |
template<typename U , typename... Args> | |
SharedRef< U > | MakeSharedRef (Args &&... args) |
An equivalent of std::make_shared for SharedRef. | |
template<typename U , typename... Args> | |
UniqueRef< U > | MakeUniqueRef (Args &&... args) |
An equivalent of std::make_unique for UniqueRef. | |
template<class T , class U > | |
constexpr bool | operator== (OptionalRef< T > lhs, OptionalRef< U > rhs) noexcept |
template<class T , class U > | |
constexpr bool | operator!= (OptionalRef< T > lhs, OptionalRef< U > rhs) noexcept |
template<class T > | |
std::string | ToString (const std::optional< T > &from) |
Converts std::optional to a string, empty value represented as "--". | |
template<class... Ts> | |
Overloaded (Ts...) -> Overloaded< Ts... > | |
template<typename Container , typename Value > | |
void | ProjectedInsertOrAssign (Container &set, Value &&value) |
An equivalent of std::unordered_map::insert_or_assign for utils::ProjectedUnorderedSet and utils::ProjectedSet. | |
RandomBase & | DefaultRandom () |
Returns a thread-local UniformRandomBitGenerator. | |
template<typename T > | |
T | RandRange (T from_inclusive, T to_exclusive) |
Generates a random number in range [from, to) | |
template<typename T > | |
T | RandRange (T to_exclusive) |
Generates a random number in range [0, to) | |
uint32_t | Rand () |
Generate a random number in the whole uint32_t range. | |
bool | regex_match (std::string_view str, const regex &pattern) |
Determines whether the regular expression matches the entire target character sequence. | |
bool | regex_search (std::string_view str, const regex &pattern) |
Determines whether the regular expression matches anywhere in the target character sequence. | |
template<typename T > | |
bool | operator== (const SharedReadablePtr< T > &ptr, std::nullptr_t) |
template<typename T > | |
bool | operator== (std::nullptr_t, const SharedReadablePtr< T > &ptr) |
template<typename T > | |
bool | operator!= (const SharedReadablePtr< T > &ptr, std::nullptr_t) |
template<typename T > | |
bool | operator!= (std::nullptr_t, const SharedReadablePtr< T > &ptr) |
template<typename T , typename... Args> | |
SharedReadablePtr< T > | MakeSharedReadable (Args &&... args) |
template<std::size_t N> | |
bool | operator== (const SmallString< N > &str, std::string_view sv) |
template<std::size_t N> | |
bool | operator== (std::string_view sv, const SmallString< N > &str) |
template<std::size_t N> | |
bool | operator== (const SmallString< N > &str1, const SmallString< N > &str2) |
template<std::size_t N> | |
bool | operator!= (const SmallString< N > &str1, const SmallString< N > &str2) |
template<typename Value , std::size_t N> | |
Value | Serialize (const SmallString< N > &value, formats::serialize::To< Value >) |
template<typename Value , std::size_t N> | |
SmallString< N > | Parse (const Value &value, formats::parse::To< SmallString< N > >) |
template<typename Key , typename Value > | |
auto | WithSafeHash (const std::unordered_map< Key, Value > &map) |
Converts an unordered [multi-]map or set with the default hash to a map with utils::StrCaseHash. This might be useful when converting guaranteed-to-be-safe data to a common operating format. | |
template<typename Key , typename Value > | |
auto | WithSafeHash (std::unordered_map< Key, Value > &&map) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. | |
template<typename Key , typename Value > | |
auto | WithSafeHash (const std::unordered_multimap< Key, Value > &map) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. | |
template<typename Key , typename Value > | |
auto | WithSafeHash (std::unordered_multimap< Key, Value > &&map) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. | |
template<typename Key > | |
auto | WithSafeHash (const std::unordered_set< Key > &map) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. | |
template<typename Key > | |
auto | WithSafeHash (std::unordered_set< Key > &&map) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. | |
template<typename Key > | |
auto | WithSafeHash (const std::unordered_multiset< Key > &map) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. | |
template<typename Key > | |
auto | WithSafeHash (std::unordered_multiset< Key > &&map) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. | |
std::chrono::milliseconds | StringToDuration (const std::string &data) |
Converts strings like "10s", "5d", "1h" to durations. | |
constexpr bool | operator& (StrongTypedefOps op, StrongTypedefOps mask) noexcept |
constexpr auto | operator| (StrongTypedefOps op1, StrongTypedefOps op2) noexcept |
template<class Tag , class T , StrongTypedefOps Ops> | |
std::ostream & | operator<< (std::ostream &os, const StrongTypedef< Tag, T, Ops > &v) |
Ostreams and Logging. | |
template<class Tag , class T , StrongTypedefOps Ops> | |
logging::LogHelper & | operator<< (logging::LogHelper &os, const StrongTypedef< Tag, T, Ops > &v) |
template<class Tag , class T , StrongTypedefOps Ops> | |
constexpr decltype(auto) | UnderlyingValue (const StrongTypedef< Tag, T, Ops > &v) noexcept |
template<class Tag , class T , StrongTypedefOps Ops> | |
constexpr T | UnderlyingValue (StrongTypedef< Tag, T, Ops > &&v) noexcept |
constexpr bool | IsStrongTypedefLoggable (StrongTypedefOps Ops) |
template<typename Tag , typename T , StrongTypedefOps Ops, typename Enable , typename ValueType > | |
std::enable_if_t< formats::common::kIsFormatValue< ValueType >, StrongTypedef< Tag, T, Ops, Enable > > | Parse (const ValueType &source, formats::parse::To< StrongTypedef< Tag, T, Ops, Enable > >) |
template<typename Tag , typename T , StrongTypedefOps Ops, typename Enable , typename TargetType > | |
TargetType | Serialize (const StrongTypedef< Tag, T, Ops, Enable > &object, formats::serialize::To< TargetType >) |
template<typename Tag , typename T , StrongTypedefOps Ops, typename Enable , typename StringBuilder > | |
void | WriteToStream (const StrongTypedef< Tag, T, Ops, Enable > &object, StringBuilder &sw) |
template<typename Tag , StrongTypedefOps Ops> | |
std::string | ToString (const StrongTypedef< Tag, std::string, Ops > &object) |
template<typename Tag , typename T , StrongTypedefOps Ops, std::enable_if_t< meta::kIsInteger< T >, bool > = true> | |
std::string | ToString (const StrongTypedef< Tag, T, Ops > &object) |
template<typename Target , typename Tag , typename T , StrongTypedefOps Ops, typename Enable > | |
constexpr Target | StrongCast (const StrongTypedef< Tag, T, Ops, Enable > &src) |
template<typename Target , typename Tag , typename T , StrongTypedefOps Ops, typename Enable > | |
constexpr Target | StrongCast (StrongTypedef< Tag, T, Ops, Enable > &&src) |
template<class Tag , class T , StrongTypedefOps Ops> | |
std::size_t | hash_value (const StrongTypedef< Tag, T, Ops > &v) |
std::string | GetCurrentThreadName () |
Get the name of the current thread. | |
void | SetCurrentThreadName (std::string_view name) |
Set the name of the current thread. | |
bool | IsMainThread () noexcept |
void | SetCurrentThreadIdleScheduling () |
Set priority of the OS thread to IDLE (the lowest one) | |
void | SetCurrentThreadLowPriorityScheduling () |
Set priority of the OS thread to low (but not the lowest one) | |
template<typename BuilderFunc > | |
TrivialBiMap (BuilderFunc) -> TrivialBiMap< BuilderFunc > | |
template<typename BuilderFunc > | |
TrivialSet (BuilderFunc) -> TrivialSet< BuilderFunc > | |
template<typename ExceptionType = void, typename Value , typename BuilderFunc > | |
auto | ParseFromValueString (const Value &value, TrivialBiMap< BuilderFunc > map) |
Parses and returns whatever is specified by map from a formats::*::Value . | |
template<class T > | |
constexpr auto | UnderlyingValue (T v) noexcept |
Function that extracts integral value from enum or StrongTypedef. | |
template<typename Function , typename... Args> | |
auto | CriticalAsync (engine::TaskProcessor &task_processor, std::string name, Function &&f, Args &&... args) |
template<typename Function , typename... Args> | |
auto | SharedCriticalAsync (engine::TaskProcessor &task_processor, std::string name, Function &&f, Args &&... args) |
template<typename Function , typename... Args> | |
auto | Async (engine::TaskProcessor &task_processor, std::string name, Function &&f, Args &&... args) |
template<typename Function , typename... Args> | |
auto | SharedAsync (engine::TaskProcessor &task_processor, std::string name, Function &&f, Args &&... args) |
template<typename Function , typename... Args> | |
auto | Async (engine::TaskProcessor &task_processor, std::string name, engine::Deadline deadline, Function &&f, Args &&... args) |
template<typename Function , typename... Args> | |
auto | SharedAsync (engine::TaskProcessor &task_processor, std::string name, engine::Deadline deadline, Function &&f, Args &&... args) |
template<typename Function , typename... Args> | |
auto | CriticalAsync (std::string name, Function &&f, Args &&... args) |
template<typename Function , typename... Args> | |
auto | SharedCriticalAsync (std::string name, Function &&f, Args &&... args) |
template<typename Function , typename... Args> | |
auto | Async (std::string name, Function &&f, Args &&... args) |
template<typename Function , typename... Args> | |
auto | SharedAsync (std::string name, Function &&f, Args &&... args) |
template<typename Function , typename... Args> | |
auto | Async (std::string name, engine::Deadline deadline, Function &&f, Args &&... args) |
template<typename Function , typename... Args> | |
auto | SharedAsync (std::string name, engine::Deadline deadline, Function &&f, Args &&... args) |
template<typename Function , typename... Args> | |
auto | AsyncBackground (std::string name, engine::TaskProcessor &task_processor, Function &&f, Args &&... args) |
int | DaemonMain (int argc, const char *const argv[], const components::ComponentList &components_list) |
template<typename Cache > | |
LazySharedPtr< typename Cache::DataType > | MakeLazyCachePtr (Cache &cache) |
Make a lazy pointer to the data of a cache. | |
const char * | GetUserverVersion () noexcept |
const char * | GetUserverVcsRevision () noexcept |
const char * | GetUserverIdentifier () noexcept |
template<class Tag , class T , StrongTypedefOps Ops> | |
void | PrintTo (const StrongTypedef< Tag, T, Ops > &v, std::ostream *os) |
Variables | |
constexpr bool | kStrictMatch = true |
Helper constant to use with FastPimpl. | |
Utilities.
using utils::NonLoggable = typedef StrongTypedef< Tag, T, StrongTypedefOps::kCompareStrong | StrongTypedefOps::kNonLoggable> |
A StrongTypedef for data that MUST NOT be logged or outputted in some other way. Also prevents the data from appearing in backtrace prints of debugger.
Definition at line 420 of file strong_typedef.hpp.
|
strong |
Enumerator | |
---|---|
kCompareStrong | Forbid all comparisons for StrongTypedef. |
kCompareTransparentOnly | Allow comparing two StrongTypedef<Tag, T> |
kCompareTransparent | Allow comparing StrongTypedef<Tag, T> and T. |
kNonLoggable | Allow both of the above. |
Definition at line 29 of file strong_typedef.hpp.
ValueType utils::AnyCast | ( | AnyMovable && | operand | ) |
BadAnyMovableCast | if type of the data stored in operand does not match ValueType |
Definition at line 219 of file any_movable.hpp.
ValueType utils::AnyCast | ( | AnyMovable & | operand | ) |
BadAnyMovableCast | if type of the data stored in operand does not match ValueType |
Definition at line 201 of file any_movable.hpp.
|
noexcept |
Definition at line 189 of file any_movable.hpp.
ValueType utils::AnyCast | ( | const AnyMovable & | operand | ) |
BadAnyMovableCast | if type of the data stored in operand does not match ValueType |
Definition at line 211 of file any_movable.hpp.
|
noexcept |
Definition at line 194 of file any_movable.hpp.
ToContainer utils::AsContainer | ( | FromContainer && | container | ) |
int utils::DaemonMain | ( | int | argc, |
const char *const | argv[], | ||
const components::ComponentList & | components_list | ||
) |
Parses command line arguments and calls components::Run with config file from –config parameter.
Other command line arguments:
RandomBase & utils::DefaultRandom | ( | ) |
Returns a thread-local UniformRandomBitGenerator.
Random
instance is not cryptographically secure Random
across thread boundaries Implementation of python-style enumerate function for range-for loops.
iterable | Container to iterate |
Definition at line 65 of file enumerate.hpp.
Map::mapped_type utils::FindOrDefault | ( | Map & | map, |
const Key & | key | ||
) |
T utils::FromString | ( | const StringType & | str | ) |
Extract the number contained in the string. No space characters or other extra characters allowed. Supported types:
std::strtod
.T | The type of the number to be parsed |
str | The string that contains the number |
std::runtime_error | if the string does not contain an integer or floating-point number in the specified format, or the string contains extra junk, or the number does not fit into the provided type |
Definition at line 173 of file from_string.hpp.
auto utils::GenerateFixedArray | ( | std::size_t | size, |
GeneratorFunc && | generator | ||
) |
Applies generator
to indices in the range [0, size)
, storing the results in a new utils::FixedArray. The generator is guaranteed to be invoked in the first-to-last order.
size | How many objects to generate |
generator | A functor that takes an index and returns an object for the FixedArray |
FixedArray
with the return objects of generator
Definition at line 175 of file fixed_array.hpp.
std::string utils::GetCurrentThreadName | ( | ) |
Get the name of the current thread.
Thread names should only be used for debugging purposes. Thread names aren't required to be preserved exactly due to the system limit on thread name length.
std::system_error | on error |
Definition at line 30 of file get_if.hpp.
Dereferences a chain of indirections and compositions, returns nullptr if one of the chain elements is not set.
Definition at line 43 of file get_if.hpp.
std::size_t utils::hash_value | ( | const StrongTypedef< Tag, T, Ops > & | v | ) |
Definition at line 411 of file strong_typedef.hpp.
|
constexpr |
Definition at line 328 of file strong_typedef.hpp.
void utils::LogErrorAndThrow | ( | const std::string & | error_message | ) |
Logs error_message and throws an exception ith that message.
Definition at line 17 of file exception.hpp.
boost::intrusive_ptr< Target > utils::make_intrusive_ptr | ( | Args &&... | args | ) |
Factory function for boost::intrusive_ptr, like std::make_unique.
Definition at line 17 of file make_intrusive_ptr.hpp.
|
constexprnoexcept |
Definition at line 73 of file checked_pointer.hpp.
LazySharedPtr< typename Cache::DataType > utils::MakeLazyCachePtr | ( | Cache & | cache | ) |
Make a lazy pointer to the data of a cache.
The cache type must have:
DataType
member type;Get() -> utils::SharedReadablePtr<DataType>
method.For example, components::CachingComponentBase satisfies these requirements.
Definition at line 152 of file lazy_shared_ptr.hpp.
SharedReadablePtr< T > utils::MakeSharedReadable | ( | Args &&... | args | ) |
Definition at line 137 of file shared_readable_ptr.hpp.
An equivalent of std::make_shared
for SharedRef.
Definition at line 119 of file not_null.hpp.
An equivalent of std::make_unique
for UniqueRef.
Definition at line 125 of file not_null.hpp.
|
constexpr |
Definition at line 28 of file bytes_per_second.hpp.
|
constexpr |
Compares utils::CachedHash by hash first and then by keys.
Definition at line 30 of file cached_hash.hpp.
bool utils::operator!= | ( | const SharedReadablePtr< T > & | ptr, |
std::nullptr_t | |||
) |
Definition at line 127 of file shared_readable_ptr.hpp.
bool utils::operator!= | ( | const SmallString< N > & | str1, |
const SmallString< N > & | str2 | ||
) |
Definition at line 154 of file small_string.hpp.
|
constexprnoexcept |
Definition at line 114 of file optional_ref.hpp.
bool utils::operator!= | ( | std::nullptr_t | , |
const SharedReadablePtr< T > & | ptr | ||
) |
Definition at line 132 of file shared_readable_ptr.hpp.
Flags< Enum > utils::operator& | ( | Enum | lhs, |
const AtomicFlags< Enum > & | rhs | ||
) |
|
constexprnoexcept |
Definition at line 39 of file strong_typedef.hpp.
logging::LogHelper & utils::operator<< | ( | logging::LogHelper & | os, |
const StrongTypedef< Tag, T, Ops > & | v | ||
) |
Definition at line 310 of file strong_typedef.hpp.
std::ostream & utils::operator<< | ( | std::ostream & | os, |
const StrongTypedef< Tag, T, Ops > & | v | ||
) |
Ostreams and Logging.
Definition at line 303 of file strong_typedef.hpp.
|
constexpr |
Definition at line 24 of file bytes_per_second.hpp.
|
constexpr |
Compares utils::CachedHash by hash first and then by keys.
Definition at line 24 of file cached_hash.hpp.
bool utils::operator== | ( | const SharedReadablePtr< T > & | ptr, |
std::nullptr_t | |||
) |
Definition at line 117 of file shared_readable_ptr.hpp.
bool utils::operator== | ( | const SmallString< N > & | str, |
std::string_view | sv | ||
) |
Definition at line 139 of file small_string.hpp.
bool utils::operator== | ( | const SmallString< N > & | str1, |
const SmallString< N > & | str2 | ||
) |
Definition at line 149 of file small_string.hpp.
bool utils::operator== | ( | Enum | lhs, |
const AtomicFlags< Enum > & | rhs | ||
) |
|
constexprnoexcept |
Definition at line 108 of file optional_ref.hpp.
bool utils::operator== | ( | std::nullptr_t | , |
const SharedReadablePtr< T > & | ptr | ||
) |
Definition at line 122 of file shared_readable_ptr.hpp.
bool utils::operator== | ( | std::string_view | sv, |
const SmallString< N > & | str | ||
) |
Definition at line 144 of file small_string.hpp.
Flags< Enum > utils::operator| | ( | Enum | lhs, |
const AtomicFlags< Enum > & | rhs | ||
) |
|
constexprnoexcept |
Definition at line 43 of file strong_typedef.hpp.
BytesPerSecond utils::Parse | ( | const Value & | v, |
formats::parse::To< BytesPerSecond > | |||
) |
Definition at line 37 of file bytes_per_second.hpp.
SmallString< N > utils::Parse | ( | const Value & | value, |
formats::parse::To< SmallString< N > > | |||
) |
Definition at line 21 of file small_string_serialization.hpp.
std::enable_if_t< formats::common::kIsFormatValue< ValueType >, StrongTypedef< Tag, T, Ops, Enable > > utils::Parse | ( | const ValueType & | source, |
formats::parse::To< StrongTypedef< Tag, T, Ops, Enable > > | |||
) |
Definition at line 338 of file strong_typedef.hpp.
auto utils::ParseFromValueString | ( | const Value & | value, |
TrivialBiMap< BuilderFunc > | map | ||
) |
Parses and returns whatever is specified by map
from a formats::*::Value
.
ExceptionType | or Value::Exception by default, if value is not a string, or if value is not contained in map . |
Definition at line 694 of file trivial_map.hpp.
void utils::PrintTo | ( | const StrongTypedef< Tag, T, Ops > & | v, |
std::ostream * | os | ||
) |
void utils::ProjectedInsertOrAssign | ( | Container & | set, |
Value && | value | ||
) |
An equivalent of std::unordered_map::insert_or_assign
for utils::ProjectedUnorderedSet and utils::ProjectedSet.
Definition at line 104 of file projected_set.hpp.
uint32_t utils::Rand | ( | ) |
Generate a random number in the whole uint32_t
range.
Rand() % N
, use RandRange
instead T utils::RandRange | ( | T | from_inclusive, |
T | to_exclusive | ||
) |
T utils::RandRange | ( | T | to_exclusive | ) |
Value utils::Serialize | ( | const SmallString< N > & | value, |
formats::serialize::To< Value > | |||
) |
Definition at line 16 of file small_string_serialization.hpp.
TargetType utils::Serialize | ( | const StrongTypedef< Tag, T, Ops, Enable > & | object, |
formats::serialize::To< TargetType > | |||
) |
Definition at line 346 of file strong_typedef.hpp.
void utils::SetCurrentThreadIdleScheduling | ( | ) |
Set priority of the OS thread to IDLE (the lowest one)
std::system_error |
void utils::SetCurrentThreadLowPriorityScheduling | ( | ) |
Set priority of the OS thread to low (but not the lowest one)
std::system_error |
void utils::SetCurrentThreadName | ( | std::string_view | name | ) |
Set the name of the current thread.
This function should only be used from drivers that create their own threads! Users should normally rely on the coroutine engine instead of creating additional threads.
There is a system limit on thread name length, e.g. 15 chars on Linux. The name is automatically cut to fit the limit.
name | the new thread name |
std::system_error | on error |
BytesPerSecond utils::StringToBytesPerSecond | ( | const std::string & | data | ) |
Understands all the date-rate unit suffixes from https://en.wikipedia.org/wiki/Data-rate_units#Conversion_table
std::chrono::milliseconds utils::StringToDuration | ( | const std::string & | data | ) |
Converts strings like "10s", "5d", "1h" to durations.
Understands the following suffixes: s - seconds ms - milliseconds m - minutes h - hours d - days
Explicitly cast from one strong typedef to another, to replace constructions SomeStrongTydef{utils::UnderlyingValue(another_strong_val)}
with utils::StrongCast<SomeStrongTydef>(another_strong_val)
Definition at line 390 of file strong_typedef.hpp.
|
constexpr |
Definition at line 401 of file strong_typedef.hpp.
|
constexpr |
Definition at line 20 of file bytes_per_second.hpp.
Converts std::optional to a string, empty value represented as "--".
Definition at line 19 of file optionals.hpp.
std::string utils::ToString | ( | const StrongTypedef< Tag, std::string, Ops > & | object | ) |
Definition at line 361 of file strong_typedef.hpp.
std::string utils::ToString | ( | const StrongTypedef< Tag, T, Ops > & | object | ) |
Definition at line 369 of file strong_typedef.hpp.
|
constexprnoexcept |
Definition at line 318 of file strong_typedef.hpp.
|
constexprnoexcept |
Definition at line 324 of file strong_typedef.hpp.
Function that extracts integral value from enum or StrongTypedef.
Definition at line 15 of file underlying_value.hpp.
Converts an unordered [multi-]map or set with the default hash to a map with utils::StrCaseHash. This might be useful when converting guaranteed-to-be-safe data to a common operating format.
Definition at line 22 of file str_icase_containers.hpp.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Definition at line 36 of file str_icase_containers.hpp.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Definition at line 63 of file str_icase_containers.hpp.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Definition at line 50 of file str_icase_containers.hpp.
auto utils::WithSafeHash | ( | std::unordered_map< Key, Value > && | map | ) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Definition at line 29 of file str_icase_containers.hpp.
auto utils::WithSafeHash | ( | std::unordered_multimap< Key, Value > && | map | ) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Definition at line 43 of file str_icase_containers.hpp.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Definition at line 70 of file str_icase_containers.hpp.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Definition at line 56 of file str_icase_containers.hpp.
void utils::WriteToStream | ( | const StrongTypedef< Tag, T, Ops, Enable > & | object, |
StringBuilder & | sw | ||
) |
Definition at line 354 of file strong_typedef.hpp.