Difference between revisions of "cpp/utility"
(→Relational operators and comparison: P1959R0) |
m (→Elementary string conversions: ASCII is unrelated in the standard wording (https://wg21.link/charconv)) |
||
| Line 140: | Line 140: | ||
===Elementary string conversions=== | ===Elementary string conversions=== | ||
| − | In addition to sophisticated locale-dependent parsers and formatters provided by the [[cpp/io|C++ I/O]] library, the [[cpp/io/c|C I/O]] library, [[cpp/string/basic_string#Numeric_conversions|C++ string converters]], and [[cpp/string/byte#Conversions_to_numeric_formats|C string converters]], the header {{header|charconv}} provides light-weight, locale-independent, non-allocating, non-throwing | + | In addition to sophisticated locale-dependent parsers and formatters provided by the [[cpp/io|C++ I/O]] library, the [[cpp/io/c|C I/O]] library, [[cpp/string/basic_string#Numeric_conversions|C++ string converters]], and [[cpp/string/byte#Conversions_to_numeric_formats|C string converters]], the header {{header|charconv}} provides light-weight, locale-independent, non-allocating, non-throwing parsers and formatters for arithmetic types. |
{{dsc begin}} | {{dsc begin}} | ||
{{dsc header|charconv}} | {{dsc header|charconv}} | ||
Revision as of 17:10, 6 January 2020
C++ includes a variety of utility libraries that provide functionality ranging from bit-counting to partial function application. These libraries can be broadly divided into two groups:
- language support libraries, and
- general-purpose libraries.
Language support
Language support libraries provide classes and functions that interact closely with language features and support common language idioms.
Type support
Basic types (e.g. std::size_t, std::nullptr_t), RTTI (e.g. std::type_info), type traits (e.g. std::is_integral, std::rank)
Dynamic memory management
Smart pointers (e.g. std::shared_ptr), allocators (e.g. std::allocator or std::memory_resource), C-style memory management (e.g. std::malloc)
Error handling
Exceptions (e.g. std::exception, std::terminate), assertions (e.g. assert)
Initializer lists
| Defined in header
<initializer_list> | |
| (C++11) |
references a temporary array created in list-initialization (class template) |
Variadic functions
Support for functions that take an arbitrary number of parameters (via e.g. va_start, va_arg, va_end)
Implementation propertiesThe header <version> supplies implementation-dependent information about the C++ standard library (such as the version number and release date). It also defines the library feature-test macros. Source code information capture
|
(since C++20) | ||||
General-purpose utilities
Program utilities
Termination (e.g. std::abort, std::atexit), environment (e.g. std::system), signals (e.g. std::raise)
Date and time
Time tracking (e.g. std::chrono::time_point, std::chrono::duration), C-style date and time (e.g. std::time, std::clock)
Bitset
| Defined in header
<bitset> | |
| implements constant length bit array (class template) | |
Function objects
Partial function application (e.g. std::bind) and related utilities: utilities for binding such as std::ref and std::placeholders, polymorphic function wrappers: std::function, predefined functors (e.g. std::plus, std::equal_to), method to function converters std::mem_fn.
Optional, variant and any
| Defined in header
<optional> | |
| (C++17) |
a wrapper that may or may not hold an object (class template) |
| Defined in header
<variant> | |
| (C++17) |
a type-safe discriminated union (class template) |
| Defined in header
<any> | |
| (C++17) |
objects that hold instances of any CopyConstructible type (class) |
| Defined in header
<utility> | |
| in-place construction tag (tag) | |
Pairs and tuples
| implements binary tuple, i.e. a pair of values (class template) | |
| (C++11) |
implements fixed size container, which holds elements of possibly different types (class template) |
| (C++17) |
calls a function with a tuple of arguments (function template) |
| (C++17) |
construct an object with a tuple of arguments (function template) |
| (C++11) |
tag type used to select correct function overload for piecewise construction (class) |
| piecewise construction tag (tag) | |
| (C++14) |
implements compile-time sequence of integers (class template) |
Swap, forward and move
| Defined in header
<utility> | |
| swaps the values of two objects (function template) | |
| (C++14) |
replaces the argument with a new value and returns its previous value (function template) |
| (C++11) |
forwards a function argument and use the type template argument to preserve its value category (function template) |
| (C++11) |
converts the argument to an xvalue (function template) |
| (C++11) |
converts the argument to an xvalue if the move constructor does not throw (function template) |
| Defined in header
<concepts> | |
| (C++20) |
swaps the values of two objects (customization point object) |
Type operations
| Defined in header
<utility> | |
| (C++11) |
obtains a reference to an object of the template type argument for use in an unevaluated context (function template) |
| (C++17) |
obtains a reference to const to its argument (function template) |
| Defined in header
<new> | |
| (C++17) |
pointer optimization barrier (function template) |
Relational operators and comparison
| Defined in header
<compare> | |
| specifies that operator <=> produces consistent result on given types (concept) | |
| (C++20) |
the result type of 3-way comparison that supports all 6 operators, is not substitutable, and allows incomparable values (class) |
| (C++20) |
the result type of 3-way comparison that supports all 6 operators and is not substitutable (class) |
| (C++20) |
the result type of 3-way comparison that supports all 6 operators and is substitutable (class) |
| named comparison functions (function) | |
| (C++20) |
constrained function object implementing x <=> y (class) |
| (C++20) |
obtains the result type of the three-way comparison operator <=> on given types (class template) |
| (C++20) |
the strongest comparison category to which all of the given types can be converted (class template) |
| (C++20) |
performs 3-way comparison and produces a result of type std::strong_ordering(customization point object) |
| (C++20) |
performs 3-way comparison and produces a result of type std::weak_ordering(customization point object) |
| (C++20) |
performs 3-way comparison and produces a result of type std::partial_ordering(customization point object) |
performs 3-way comparison and produces a result of type std::strong_ordering, even if operator<=> is unavailable(customization point object) | |
| (C++20) |
performs 3-way comparison and produces a result of type std::weak_ordering, even if operator<=> is unavailable(customization point object) |
performs 3-way comparison and produces a result of type std::partial_ordering, even if operator<=> is unavailable(customization point object) | |
| Defined in header
<utility> | |
| Defined in namespace
std::rel_ops | |
| (deprecated in C++20) |
automatically generates comparison operators based on user-defined operator== and operator< (function template) |
Elementary string conversions
In addition to sophisticated locale-dependent parsers and formatters provided by the C++ I/O library, the C I/O library, C++ string converters, and C string converters, the header <charconv> provides light-weight, locale-independent, non-allocating, non-throwing parsers and formatters for arithmetic types.
| Defined in header
<charconv> | |
| (C++17) |
converts an integer or floating-point value to a character sequence (function) |
| (C++17) |
converts a character sequence to an integer or floating-point value (function) |
| (C++17) |
specifies formatting for std::to_chars and std::from_chars (enum) |
Formatting library (since C++20)
Facilities for type-safe string formatting, e.g. std::format std::format_to.
Hash support
| (C++11) |
hash function object (class template) |
