Namespaces
Variants

std:: return_temporary_buffer

From cppreference.net
Memory management library
( exposition only* )
Allocators
Uninitialized memory algorithms
Constrained uninitialized memory algorithms
Memory resources
Uninitialized storage (until C++20)
( until C++20* )
( until C++20* )
return_temporary_buffer
( until C++20* )

Garbage collector support (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
헤더 파일에 정의됨 <memory>
template < class T >
void return_temporary_buffer ( T * p ) ;
(C++17에서 사용 중단됨)
(C++20에서 제거됨)

p 가 참조하는 저장 공간을 해제합니다.

만약 p 가 이전 std::get_temporary_buffer 호출에서 반환된 포인터 값이 아니거나, 중간에 std::return_temporary_buffer 호출로 인해 무효화된 경우, 동작은 정의되지 않습니다.

목차

매개변수

p - 할당 해제될 저장 공간을 참조하는 포인터

반환값

(없음)

예외

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

예제

#include <algorithm>
#include <iostream>
#include <iterator>
#include <memory>
#include <string>
int main()
{
    const std::string s[] = {"string", "1", "test", "..."};
    const auto p = std::get_temporary_buffer<std::string>(4);
    // p.first가 return_temporary_buffer에 전달되어야 함
    // (조기 종료 지점과 예외에 주의), 또는 더 나은 방법:
    std::unique_ptr<std::string, void(*)(std::string*)> on_exit(p.first,
    [](std::string* p)
    {
        std::cout << "returning temporary buffer...\n";
        std::return_temporary_buffer(p);
    });
    std::copy(s, s + p.second,
              std::raw_storage_iterator<std::string*, std::string>(p.first));
    // std::uninitialized_copy(s, s + p.second, p.first);와 동일한 효과
    // p의 각 string을 개별적으로 파괴해야 함
    // (조기 종료 지점과 예외에 주의)
    std::copy(p.first, p.first + p.second,
              std::ostream_iterator<std::string>{std::cout, "\n"});
    std::for_each(p.first, p.first + p.second, [](std::string& e)
    {
        e.~basic_string<char>();
    }); // std::destroy(p.first, p.first + p.second);와 동일
    // unique_ptr과 같은 기법을 사용하지 않으면 수동으로 메모리 회수:
    // std::return_temporary_buffer(p.first);
}

출력:

string
1
test
...
returning temporary buffer...

결함 보고서

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

DR 적용 대상 게시된 동작 올바른 동작
LWG 2072 C++98 std::get_temporary_buffer
가 할당한 저장 공간이 여러 번 해제될 수 있었음
이 경우 동작은
정의되지 않음

참고 항목

(deprecated in C++17) (removed in C++20)
초기화되지 않은 저장 공간을 획득
(함수 템플릿)