Files
clang-p2996/libcxx/test/support/test_format_context.h
Mark de Wever 0922ce56f4 [libc++][format] Add __format_arg_store.
This implements the struct `__format_arg_store` and its dependencies:
* the class basic_format_arg,
* the class basic_format_args,
* the class basic_format_context,
* the function make_format_args,
* the function wmake_format_args,
* the function visit_format_arg,
* several Standard required typedefs.

The following parts will be implemented in a later patch:

* the child class `basic_format_arg::handle`,
* the function `basic_format_arg::basic_format_arg(const T* p)`.

The following extension has been implemented:
* the class basic_format_arg supports `__[u]int128_t` on platform where libc++ supports 128 bit integrals.

Implements parts of:
* P0645 Text Formatting

Completes:
* LWG3371 visit_format_arg and make_format_args are not hidden friends
* LWG3542 basic_format_arg mishandles basic_string_view with custom traits

Note https://mordante.github.io/blog/2021/06/05/format.html gives a bit more information about the goals and non-goals of this initial patch series.

Reviewed By: #libc, ldionne, vitaut

Differential Revision: https://reviews.llvm.org/D103357
2021-09-01 19:45:02 +02:00

63 lines
2.2 KiB
C++

// -*- 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 SUPPORT_TEST_FORMAT_CONTEXT_HPP
#define SUPPORT_TEST_FORMAT_CONTEXT_HPP
/**
* @file Helper functions to create a @ref std::basic_format_context.
*
* Since the standard doesn't specify how a @ref std::basic_format_context is
* constructed this is implementation defined. To make the public API tests of
* the class generic this header defines helper functions to create the
* required object.
*
* @note This requires every standard library implementation to write their own
* helper function. Vendors are encouraged to file a review at
* https://reviews.llvm.org/ so their specific implementation can be part of
* this file.
*/
#if TEST_STD_VER < 20
#error "The format header requires at least C++20"
#endif
#include <format>
#ifndef _LIBCPP_HAS_NO_LOCALIZATION
#include <locale>
#endif
#if defined(_LIBCPP_VERSION)
/** Creates a std::basic_format_context as-if the formatting function takes no locale. */
template <class OutIt, class CharT>
std::basic_format_context<OutIt, CharT> test_format_context_create(
OutIt out_it,
std::basic_format_args<std::basic_format_context<OutIt, CharT>> args) {
return std::__format_context_create(std::move(out_it), args);
}
#ifndef _LIBCPP_HAS_NO_LOCALIZATION
/** Creates a std::basic_format_context as-if the formatting function takes locale. */
template <class OutIt, class CharT>
std::basic_format_context<OutIt, CharT> test_format_context_create(
OutIt out_it,
std::basic_format_args<std::basic_format_context<OutIt, CharT>> args,
std::locale loc) {
return std::__format_context_create(std::move(out_it), args, std::move(loc));
}
#endif
#else
#error \
"Please create a vendor specific version of the test functions and file a review at https://reviews.llvm.org/"
#endif
#endif // SUPPORT_TEST_FORMAT_CONTEXT_HPP