std:: to_chars

value 값을 [ first , last ) 범위를 연속적으로 채워 문자 문자열로 변환합니다. 여기서 [ first , last ) 는 유효한 범위 여야 합니다.

매개변수

반환값

성공 시, std::to_chars_result 타입의 값을 반환하며, ec 는 값 초기화된 std::errc 와 같고 ptr 은 기록된 문자들의 끝 다음을 가리키는 포인터입니다. 문자열이 NUL로 종료되지 않음 에 유의하십시오.

오류 발생 시, std::to_chars_result 타입의 값을 반환하며, std::errc::value_too_large 를 ec 에 저장하고, last 값의 사본을 ptr 에 저장하며, 범위 [ first , last ) 의 내용을 지정되지 않은 상태로 둡니다.

예외

아무것도 던지지 않습니다.

참고 사항

C++ 및 C 라이브러리의 다른 포맷팅 함수들과 달리, std::to_chars 는 로케일 독립적이며, 메모리 할당을 하지 않고, 예외를 발생시키지 않습니다. 다른 라이브러리들(예: std::sprintf )에서 사용되는 포맷팅 정책들의 작은 부분집합만 제공됩니다. 이는 JSON이나 XML과 같은 텍스트 기반 교환 환경에서 일반적으로 사용되는 고처리량 상황에서 가능한 가장 빠른 구현을 허용하기 위함입니다.

std::from_chars 가 std::to_chars 에 의해 형식화된 모든 부동 소수점 값을 정확히 복원할 수 있다는 보장은 두 함수가 동일한 구현체에서 제공된 경우에만 적용됩니다.

bool 값을 "0" / "1" 로 포맷하려면 std::to_chars 를 사용할 때 값을 다른 정수 타입으로 캐스팅해야 합니다.

예제

#include <charconv>
#include <iomanip>
#include <iostream>
#include <string_view>
#include <system_error>
void show_to_chars(auto... format_args)
{
    const size_t buf_size = 10;
    char buf[buf_size]{};
    std::to_chars_result result = std::to_chars(buf, buf + buf_size, format_args...);
    if (result.ec != std::errc())
        std::cout << std::make_error_code(result.ec).message() << '\n';
    else
    {
        std::string_view str(buf, result.ptr - buf);
        std::cout << std::quoted(str) << '\n';
    }
}
int main()
{
    show_to_chars(42);
    show_to_chars(+3.14159F);
    show_to_chars(-3.14159, std::chars_format::fixed);
    show_to_chars(-3.14159, std::chars_format::scientific, 3);
    show_to_chars(3.1415926535, std::chars_format::fixed, 10);
}

"42"
"3.14159"
"-3.14159"
"-3.142e+00"
Value too large for defined data type

결함 보고서

다음의 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.

참고 항목