utility_to_chars

utility_to_chars (문자열 변환)

이 페이지는 C++17부터 제공되는 std::to_chars 함수에 대해 설명해요. 이 함수는 정수나 부동소수점 값을 문자열로 변환할 때 사용하며, 로케일 독립적이고 메모리 할당이 없으며 예외를 던지지 않는 특징이 있어요. 고속 텍스트 기반 데이터 교환(JSON, XML 등)에서 특히 유용해요.

출처: cppreference

본문

함수 정의

<charconv> 헤더에 정의되어 있어요.

value를 [first, last) 범위에 연속적으로 채워 문자 문자열로 변환해요. 이때 [first, last)는 유효한 범위여야 해요.

매개변수

반환값

성공하면 ec가 값 초기화된 std::errc와 같고 ptr이 작성된 문자의 바로 다음 위치를 가리키는 std::to_chars_result 타입 값을 반환해요. 문자열은 NUL로 종료되지 않아요.

오류가 발생하면 ec에 std::errc::value_too_large를 담고, ptr에 last 값의 복사본을 담은 std::to_chars_result 타입 값을 반환하며, [first, last) 범위의 내용은 지정되지 않은 상태로 남겨요.

예외

아무것도 던지지 않아요.

참고 사항

C++ 및 C 라이브러리의 다른 형식화 함수들과 달리 std::to_chars는 로케일 독립적이고, 할당을 하지 않으며, 예외를 던지지 않아요. 다른 라이브러리(예: std::sprintf)에서 사용되는 형식화 정책 중 극히 일부만 제공해요. 이는 JSON이나 XML 같은 텍스트 기반 교환에서 흔히 쓰이는 높은 처리량 상황에 유용한 가장 빠른 구현을 가능하게 하기 위한 의도예요.

std::from_chars가 std::to_chars로 형식화된 모든 부동소수점 값을 정확히 복구할 수 있다는 보장은 두 함수가 같은 구현에서 제공될 때만 성립해요.

bool 값을 "0"/"1"로 형식화하려면 다른 정수 타입으로 명시적으로 캐스팅해야 해요.

기능 테스트 매크로

예제

#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++ 표준에 소급 적용되었어요.

같이 보기

더 알아보기 (Learn more)

cppreference