Files
clang-p2996/libcxx/test/std/thread/thread.threads/thread.thread.class/thread.thread.id/format.functions.tests.h
Mark de Wever 402eb2ef09 [libc++][format] Improves diagnostics.
Improves both the compile-time and run-time errors.
At compile-time it does a bit more work to get more specific errors.
This could be done at run-time too, but that has a performance penalty.
Since it's expected most use-cases use format* instead of vformat* the
compile-time errors are more common.

For example when using

  std::format_to("{:-c}", 42);

Before compile output would contain

  std::__throw_format_error("The format-spec should consume the input or end with a '}'");

Now it contains

  std::__throw_format_error("The format specifier does not allow the sign option");

Given a better indication the sign option is not allowed. Note the
output is still not user-friendly; C++ doesn't have good facilities to
generate nice messages from the library.

In general all messages have been reviewed and improved, using a more
consistent style and using less terms used in the standard. For example

  format-spec -> format specifier
  arg-id -> argument index

Reviewed By: #libc, ldionne

Differential Revision: https://reviews.llvm.org/D152624
2023-07-18 21:11:12 +02:00

79 lines
3.4 KiB
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 TEST_STD_THREAD_THREAD_THREADS_THREAD_THREAD_CLASS_THREAD_THREAD_ID_FORMAT_FUNCTIONS_TESTS_H
#define TEST_STD_THREAD_THREAD_THREADS_THREAD_THREAD_CLASS_THREAD_THREAD_ID_FORMAT_FUNCTIONS_TESTS_H
#include <thread>
#include "format.functions.common.h"
#include "test_macros.h"
template <class CharT, class TestFunction, class ExceptionTest>
void format_tests(TestFunction check, ExceptionTest check_exception) {
// Note the output of std::thread::id is unspecified. The output text is the
// same as the stream operator. Since that format is already released this
// test follows the practice on existing systems.
std::thread::id input{};
/***** Test the type specific part *****/
#if !defined(__APPLE__) && !defined(__FreeBSD__)
check(SV("0"), SV("{}"), input);
// *** align-fill & width ***
check(SV(" 0"), SV("{:5}"), input);
check(SV("0****"), SV("{:*<5}"), input);
check(SV("__0__"), SV("{:_^5}"), input);
check(SV("::::0"), SV("{::>5}"), input); // This is not a range, so : is allowed as fill character.
check(SV(" 0"), SV("{:{}}"), input, 5);
check(SV("0****"), SV("{:*<{}}"), input, 5);
check(SV("__0__"), SV("{:_^{}}"), input, 5);
check(SV("####0"), SV("{:#>{}}"), input, 5);
#else // !defined(__APPLE__) && !defined(__FreeBSD__)
check(SV("0x0"), SV("{}"), input);
// *** align-fill & width ***
check(SV(" 0x0"), SV("{:7}"), input);
check(SV("0x0****"), SV("{:*<7}"), input);
check(SV("__0x0__"), SV("{:_^7}"), input);
check(SV("::::0x0"), SV("{::>7}"), input); // This is not a range, so : is allowed as fill character.
check(SV(" 0x0"), SV("{:{}}"), input, 7);
check(SV("0x0****"), SV("{:*<{}}"), input, 7);
check(SV("__0x0__"), SV("{:_^{}}"), input, 7);
check(SV("####0x0"), SV("{:#>{}}"), input, 7);
#endif // !defined(__APPLE__) && !defined(__FreeBSD__)
/***** Test the type generic part *****/
check_exception("The fill option contains an invalid value", SV("{:}<}"), input);
check_exception("The fill option contains an invalid value", SV("{:{<}"), input);
// *** sign ***
check_exception("The replacement field misses a terminating '}'", SV("{:-}"), input);
check_exception("The replacement field misses a terminating '}'", SV("{:+}"), input);
check_exception("The replacement field misses a terminating '}'", SV("{: }"), input);
// *** alternate form ***
check_exception("The replacement field misses a terminating '}'", SV("{:#}"), input);
// *** zero-padding ***
check_exception("The width option should not have a leading zero", SV("{:0}"), input);
// *** precision ***
check_exception("The replacement field misses a terminating '}'", SV("{:.}"), input);
// *** locale-specific form ***
check_exception("The replacement field misses a terminating '}'", SV("{:L}"), input);
// *** type ***
for (std::basic_string_view<CharT> fmt : fmt_invalid_types<CharT>(""))
check_exception("The replacement field misses a terminating '}'", fmt, input);
}
#endif // TEST_STD_THREAD_THREAD_THREADS_THREAD_THREAD_CLASS_THREAD_THREAD_ID_FORMAT_FUNCTIONS_TESTS_H