2020-12-19 20:52:07 +08:00
|
|
|
// -*- C++ -*-
|
|
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
//
|
|
|
|
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
|
|
|
// See https://llvm.org/LICENSE.txt for license information.
|
|
|
|
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
|
|
|
//
|
|
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
|
|
|
|
#ifndef _LIBCPP___FORMAT_FORMATTER_H
|
|
|
|
#define _LIBCPP___FORMAT_FORMATTER_H
|
|
|
|
|
|
|
|
#include <__availability>
|
2022-06-11 01:53:10 +08:00
|
|
|
#include <__concepts/same_as.h>
|
2020-12-19 20:52:07 +08:00
|
|
|
#include <__config>
|
[libc++][format] Adds string formatter.
Implements the formatter for all string types.
[format.formatter.spec]/2.2
For each charT, the string type specializations
```
template<> struct formatter<charT*, charT>;
template<> struct formatter<const charT*, charT>;
template<size_t N> struct formatter<const charT[N], charT>;
template<class traits, class Allocator>
struct formatter<basic_string<charT, traits, Allocator>, charT>;
template<class traits>
struct formatter<basic_string_view<charT, traits>, charT>;
```
This removes the stub implemented in D96664.
Implements parts of:
- P0645 Text Formatting
- P1868 width: clarifying units of width and precision in std::format
Reviewed By: #libc, ldionne, vitaut
Differential Revision: https://reviews.llvm.org/D103425
2020-12-15 00:39:15 +08:00
|
|
|
#include <__format/format_fwd.h>
|
2020-12-19 20:52:07 +08:00
|
|
|
|
|
|
|
#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
|
2022-02-02 09:16:40 +08:00
|
|
|
# pragma GCC system_header
|
2020-12-19 20:52:07 +08:00
|
|
|
#endif
|
|
|
|
|
|
|
|
_LIBCPP_BEGIN_NAMESPACE_STD
|
|
|
|
|
|
|
|
#if _LIBCPP_STD_VER > 17
|
|
|
|
|
2021-12-15 02:46:10 +08:00
|
|
|
/// The default formatter template.
|
|
|
|
///
|
|
|
|
/// [format.formatter.spec]/5
|
|
|
|
/// If F is a disabled specialization of formatter, these values are false:
|
|
|
|
/// - is_default_constructible_v<F>,
|
|
|
|
/// - is_copy_constructible_v<F>,
|
|
|
|
/// - is_move_constructible_v<F>,
|
|
|
|
/// - is_copy_assignable<F>, and
|
|
|
|
/// - is_move_assignable<F>.
|
2020-12-19 20:52:07 +08:00
|
|
|
template <class _Tp, class _CharT>
|
|
|
|
struct _LIBCPP_TEMPLATE_VIS _LIBCPP_AVAILABILITY_FORMAT formatter {
|
2021-12-15 02:46:10 +08:00
|
|
|
formatter() = delete;
|
|
|
|
formatter(const formatter&) = delete;
|
|
|
|
formatter& operator=(const formatter&) = delete;
|
2020-12-19 20:52:07 +08:00
|
|
|
};
|
|
|
|
|
[libc++][format] Adds string formatter.
Implements the formatter for all string types.
[format.formatter.spec]/2.2
For each charT, the string type specializations
```
template<> struct formatter<charT*, charT>;
template<> struct formatter<const charT*, charT>;
template<size_t N> struct formatter<const charT[N], charT>;
template<class traits, class Allocator>
struct formatter<basic_string<charT, traits, Allocator>, charT>;
template<class traits>
struct formatter<basic_string_view<charT, traits>, charT>;
```
This removes the stub implemented in D96664.
Implements parts of:
- P0645 Text Formatting
- P1868 width: clarifying units of width and precision in std::format
Reviewed By: #libc, ldionne, vitaut
Differential Revision: https://reviews.llvm.org/D103425
2020-12-15 00:39:15 +08:00
|
|
|
namespace __formatter {
|
|
|
|
|
|
|
|
/** The character types that formatters are specialized for. */
|
|
|
|
template <class _CharT>
|
|
|
|
concept __char_type = same_as<_CharT, char> || same_as<_CharT, wchar_t>;
|
|
|
|
|
|
|
|
} // namespace __formatter
|
|
|
|
|
2020-12-19 20:52:07 +08:00
|
|
|
#endif //_LIBCPP_STD_VER > 17
|
|
|
|
|
|
|
|
_LIBCPP_END_NAMESPACE_STD
|
|
|
|
|
|
|
|
#endif // _LIBCPP___FORMAT_FORMATTER_H
|