Movatterモバイル変換


[0]ホーム

URL:


cppreference.com
Namespaces
Variants
    Actions

      std::return_temporary_buffer

      From cppreference.com
      <cpp‎ |memory
       
       
      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)
       
      Defined in header<memory>
      template<class T>
      void return_temporary_buffer( T* p);
      (deprecated in C++17)
      (removed in C++20)

      Deallocates the storage referenced byp.

      Ifp is not a pointer value returned by an earlier call tostd::get_temporary_buffer, or has been invalidated by an interveningstd::return_temporary_buffer call, the behavior is undefined.

      Contents

      [edit]Parameters

      p - the pointer referring to the storage to be declloated

      [edit]Return value

      (none)

      [edit]Exceptions

      Throws nothing.

      [edit]Example

      [edit]
      Run this code
      #include <algorithm>#include <iostream>#include <iterator>#include <memory>#include <string> int main(){conststd::string s[]={"string","1","test","..."};constauto p=std::get_temporary_buffer<std::string>(4);// requires that p.first is passed to return_temporary_buffer// (beware of early exit points and exceptions), or better use: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));// has same effect as: std::uninitialized_copy(s, s + p.second, p.first);// requires that each string in p is individually destroyed// (beware of early exit points and exceptions) 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>();});// same as: std::destroy(p.first, p.first + p.second); // manually reclaim memory if unique_ptr-like technique is not used:// std::return_temporary_buffer(p.first);}

      Output:

      string1test...returning temporary buffer...

      [edit]Defect reports

      The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

      DRApplied toBehavior as publishedCorrect behavior
      LWG 2072C++98the storage allocated bystd::get_temporary_buffer
      could be deallocated multiple times
      the behavior is
      undefined in this case

      [edit]See also

      (deprecated in C++17)(removed in C++20)
      obtains uninitialized storage
      (function template)[edit]
      Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/memory/return_temporary_buffer&oldid=156973"

      [8]ページ先頭

      ©2009-2025 Movatter.jp