<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <meta http-equiv="X-UA-Compatible" content="IE=9"/> <meta name="generator" content="Doxygen 1.8.13"/> <meta name="viewport" content="width=device-width, initial-scale=1"/> <title>libstdc++: std::allocator_traits< _Alloc > Struct Template Reference</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="dynsections.js"></script> <link href="navtree.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="resize.js"></script> <script type="text/javascript" src="navtreedata.js"></script> <script type="text/javascript" src="navtree.js"></script> <script type="text/javascript"> $(document).ready(initResizable); </script> <link href="doxygen.css" rel="stylesheet" type="text/css" /> </head> <body> <div id="top"><!-- do not remove this div, it is closed by doxygen! --> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td id="projectalign" style="padding-left: 0.5em;"> <div id="projectname">libstdc++ </div> </td> </tr> </tbody> </table> </div> <!-- end header part --> <!-- Generated by Doxygen 1.8.13 --> </div><!-- top --> <div id="side-nav" class="ui-resizable side-nav-resizable"> <div id="nav-tree"> <div id="nav-tree-contents"> <div id="nav-sync" class="sync"></div> </div> </div> <div id="splitbar" style="-moz-user-select:none;" class="ui-resizable-handle"> </div> </div> <script type="text/javascript"> $(document).ready(function(){initNavTree('a04085.html','');}); </script> <div id="doc-content"> <div class="header"> <div class="summary"> <a href="#pub-types">Public Types</a> | <a href="#pub-static-methods">Static Public Member Functions</a> | <a href="a04082.html">List of all members</a> </div> <div class="headertitle"> <div class="title">std::allocator_traits< _Alloc > Struct Template Reference<div class="ingroups"><a class="el" href="a01431.html">Utilities</a> » <a class="el" href="a01424.html">Memory</a> » <a class="el" href="a01443.html">Allocators</a></div></div> </div> </div><!--header--> <div class="contents"> <div class="dynheader"> Inheritance diagram for std::allocator_traits< _Alloc >:</div> <div class="dyncontent"> <div class="center"><iframe scrolling="no" frameborder="0" src="a04084.svg" width="139" height="136"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe> </div> <center><span class="legend">[<a target="top" href="graph_legend.html">legend</a>]</span></center></div> <table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-types"></a> Public Types</h2></td></tr> <tr class="memitem:afca1125c7f138bdffa1fda17a5181429"><td class="memItemLeft" align="right" valign="top">typedef _Alloc </td><td class="memItemRight" valign="bottom"><a class="el" href="a04085.html#afca1125c7f138bdffa1fda17a5181429">allocator_type</a></td></tr> <tr class="separator:afca1125c7f138bdffa1fda17a5181429"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a9f5af8cc851146c64ea7a846477c2c46"><td class="memItemLeft" align="right" valign="top">typedef __const_pointer </td><td class="memItemRight" valign="bottom"><a class="el" href="a04085.html#a9f5af8cc851146c64ea7a846477c2c46">const_pointer</a></td></tr> <tr class="separator:a9f5af8cc851146c64ea7a846477c2c46"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ad2eb6f18c8a2ff167bc276f2ca6c89e2"><td class="memItemLeft" align="right" valign="top">typedef __const_void_pointer </td><td class="memItemRight" valign="bottom"><a class="el" href="a04085.html#ad2eb6f18c8a2ff167bc276f2ca6c89e2">const_void_pointer</a></td></tr> <tr class="separator:ad2eb6f18c8a2ff167bc276f2ca6c89e2"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a3e7a121977c8b44d247526a3f8d655f8"><td class="memItemLeft" align="right" valign="top">typedef __difference_type </td><td class="memItemRight" valign="bottom"><a class="el" href="a04085.html#a3e7a121977c8b44d247526a3f8d655f8">difference_type</a></td></tr> <tr class="separator:a3e7a121977c8b44d247526a3f8d655f8"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a8fa48f2bd3c8a0c32836872689b2ca62"><td class="memItemLeft" align="right" valign="top">typedef __pointer </td><td class="memItemRight" valign="bottom"><a class="el" href="a04085.html#a8fa48f2bd3c8a0c32836872689b2ca62">pointer</a></td></tr> <tr class="separator:a8fa48f2bd3c8a0c32836872689b2ca62"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:aaf8537cdd5491ce78baf889aa79c9216"><td class="memItemLeft" align="right" valign="top">typedef __propagate_on_container_copy_assignment </td><td class="memItemRight" valign="bottom"><a class="el" href="a04085.html#aaf8537cdd5491ce78baf889aa79c9216">propagate_on_container_copy_assignment</a></td></tr> <tr class="separator:aaf8537cdd5491ce78baf889aa79c9216"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:aaa25d41df1ee33bc852b46687f42c8a2"><td class="memItemLeft" align="right" valign="top">typedef __propagate_on_container_move_assignment </td><td class="memItemRight" valign="bottom"><a class="el" href="a04085.html#aaa25d41df1ee33bc852b46687f42c8a2">propagate_on_container_move_assignment</a></td></tr> <tr class="separator:aaa25d41df1ee33bc852b46687f42c8a2"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ab473299e767e1bd58e5b71f0a87c05b1"><td class="memItemLeft" align="right" valign="top">typedef __propagate_on_container_swap </td><td class="memItemRight" valign="bottom"><a class="el" href="a04085.html#ab473299e767e1bd58e5b71f0a87c05b1">propagate_on_container_swap</a></td></tr> <tr class="separator:ab473299e767e1bd58e5b71f0a87c05b1"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a797b3c598e0d37018cb71b24637c7992"><td class="memTemplParams" colspan="2"><a id="a797b3c598e0d37018cb71b24637c7992"></a> template<typename _Tp > </td></tr> <tr class="memitem:a797b3c598e0d37018cb71b24637c7992"><td class="memTemplItemLeft" align="right" valign="top">using </td><td class="memTemplItemRight" valign="bottom"><b>rebind_alloc</b> = typename __alloctr_rebind< _Alloc, _Tp >::__type</td></tr> <tr class="separator:a797b3c598e0d37018cb71b24637c7992"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a04a8dd851f0d8effccc0a7c0f2e60f3e"><td class="memTemplParams" colspan="2"><a id="a04a8dd851f0d8effccc0a7c0f2e60f3e"></a> template<typename _Tp > </td></tr> <tr class="memitem:a04a8dd851f0d8effccc0a7c0f2e60f3e"><td class="memTemplItemLeft" align="right" valign="top">using </td><td class="memTemplItemRight" valign="bottom"><b>rebind_traits</b> = <a class="el" href="a04085.html">allocator_traits</a>< rebind_alloc< _Tp > ></td></tr> <tr class="separator:a04a8dd851f0d8effccc0a7c0f2e60f3e"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:aba783acc03d73b750b1525250084f104"><td class="memItemLeft" align="right" valign="top">typedef __size_type </td><td class="memItemRight" valign="bottom"><a class="el" href="a04085.html#aba783acc03d73b750b1525250084f104">size_type</a></td></tr> <tr class="separator:aba783acc03d73b750b1525250084f104"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:aa51dca0f6ab162918c10679e8feb57df"><td class="memItemLeft" align="right" valign="top">typedef _Alloc::value_type </td><td class="memItemRight" valign="bottom"><a class="el" href="a04085.html#aa51dca0f6ab162918c10679e8feb57df">value_type</a></td></tr> <tr class="separator:aa51dca0f6ab162918c10679e8feb57df"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a7bf3224b11fa6d5a86d3c9bcfa9bae40"><td class="memItemLeft" align="right" valign="top">typedef __void_pointer </td><td class="memItemRight" valign="bottom"><a class="el" href="a04085.html#a7bf3224b11fa6d5a86d3c9bcfa9bae40">void_pointer</a></td></tr> <tr class="separator:a7bf3224b11fa6d5a86d3c9bcfa9bae40"><td class="memSeparator" colspan="2"> </td></tr> </table><table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-static-methods"></a> Static Public Member Functions</h2></td></tr> <tr class="memitem:a1afbf725286c9e82ba6166dcc04b10bc"><td class="memItemLeft" align="right" valign="top">static <a class="el" href="a04085.html#a8fa48f2bd3c8a0c32836872689b2ca62">pointer</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="a04085.html#a1afbf725286c9e82ba6166dcc04b10bc">allocate</a> (_Alloc &__a, <a class="el" href="a04085.html#aba783acc03d73b750b1525250084f104">size_type</a> __n)</td></tr> <tr class="separator:a1afbf725286c9e82ba6166dcc04b10bc"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a79296fdf0f48ef0a49f2d5de6193f867"><td class="memItemLeft" align="right" valign="top">static <a class="el" href="a04085.html#a8fa48f2bd3c8a0c32836872689b2ca62">pointer</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="a04085.html#a79296fdf0f48ef0a49f2d5de6193f867">allocate</a> (_Alloc &__a, <a class="el" href="a04085.html#aba783acc03d73b750b1525250084f104">size_type</a> __n, <a class="el" href="a04085.html#ad2eb6f18c8a2ff167bc276f2ca6c89e2">const_void_pointer</a> __hint)</td></tr> <tr class="separator:a79296fdf0f48ef0a49f2d5de6193f867"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:aad7d7b8604439d1ecf953a1b9a426e7b"><td class="memTemplParams" colspan="2">template<typename _Tp , typename... _Args> </td></tr> <tr class="memitem:aad7d7b8604439d1ecf953a1b9a426e7b"><td class="memTemplItemLeft" align="right" valign="top">static auto </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="a04085.html#aad7d7b8604439d1ecf953a1b9a426e7b">construct</a> (_Alloc &__a, _Tp *__p, _Args &&... __args) -> decltype(_S_construct(__a, __p, <a class="el" href="a01431.html#gacb5baec338e12b99cb6bddea7506c7c6">std::forward</a>< _Args >(__args)...))</td></tr> <tr class="separator:aad7d7b8604439d1ecf953a1b9a426e7b"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ae5f6b86b98b17e2ba39243ca8eaf4ee1"><td class="memItemLeft" align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="a04085.html#ae5f6b86b98b17e2ba39243ca8eaf4ee1">deallocate</a> (_Alloc &__a, <a class="el" href="a04085.html#a8fa48f2bd3c8a0c32836872689b2ca62">pointer</a> __p, <a class="el" href="a04085.html#aba783acc03d73b750b1525250084f104">size_type</a> __n)</td></tr> <tr class="separator:ae5f6b86b98b17e2ba39243ca8eaf4ee1"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ac73f3d164cf01c9d61b44d42c30db3d3"><td class="memTemplParams" colspan="2">template<typename _Tp > </td></tr> <tr class="memitem:ac73f3d164cf01c9d61b44d42c30db3d3"><td class="memTemplItemLeft" align="right" valign="top">static void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="a04085.html#ac73f3d164cf01c9d61b44d42c30db3d3">destroy</a> (_Alloc &__a, _Tp *__p)</td></tr> <tr class="separator:ac73f3d164cf01c9d61b44d42c30db3d3"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a29c306bcb6a7676a516430a0e50b990a"><td class="memItemLeft" align="right" valign="top">static <a class="el" href="a04085.html#aba783acc03d73b750b1525250084f104">size_type</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="a04085.html#a29c306bcb6a7676a516430a0e50b990a">max_size</a> (const _Alloc &__a) noexcept</td></tr> <tr class="separator:a29c306bcb6a7676a516430a0e50b990a"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ac324d9065f45f7ae2dd1e0014c73f218"><td class="memItemLeft" align="right" valign="top">static _Alloc </td><td class="memItemRight" valign="bottom"><a class="el" href="a04085.html#ac324d9065f45f7ae2dd1e0014c73f218">select_on_container_copy_construction</a> (const _Alloc &__rhs)</td></tr> <tr class="separator:ac324d9065f45f7ae2dd1e0014c73f218"><td class="memSeparator" colspan="2"> </td></tr> </table> <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> <div class="textblock"><h3>template<typename _Alloc><br /> struct std::allocator_traits< _Alloc ></h3> <p>Uniform interface to all allocator types. </p> <p class="definition">Definition at line <a class="el" href="a14746_source.html#l00083">83</a> of file <a class="el" href="a14746_source.html">bits/alloc_traits.h</a>.</p> </div><h2 class="groupheader">Member Typedef Documentation</h2> <a id="afca1125c7f138bdffa1fda17a5181429"></a> <h2 class="memtitle"><span class="permalink"><a href="#afca1125c7f138bdffa1fda17a5181429">◆ </a></span>allocator_type</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Alloc> </div> <table class="memname"> <tr> <td class="memname">typedef _Alloc <a class="el" href="a04085.html">std::allocator_traits</a>< _Alloc >::<a class="el" href="a04085.html#afca1125c7f138bdffa1fda17a5181429">allocator_type</a></td> </tr> </table> </div><div class="memdoc"> <p>The allocator type. </p> <p class="definition">Definition at line <a class="el" href="a14746_source.html#l00086">86</a> of file <a class="el" href="a14746_source.html">bits/alloc_traits.h</a>.</p> </div> </div> <a id="a9f5af8cc851146c64ea7a846477c2c46"></a> <h2 class="memtitle"><span class="permalink"><a href="#a9f5af8cc851146c64ea7a846477c2c46">◆ </a></span>const_pointer</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Alloc> </div> <table class="memname"> <tr> <td class="memname">typedef __const_pointer <a class="el" href="a04085.html">std::allocator_traits</a>< _Alloc >::<a class="el" href="a04085.html#a9f5af8cc851146c64ea7a846477c2c46">const_pointer</a></td> </tr> </table> </div><div class="memdoc"> <p>The allocator's const pointer type. </p> <p><code>Alloc::const_pointer</code> if that type exists, otherwise <code> pointer_traits<pointer>::rebind<const value_type> </code> </p> <p class="definition">Definition at line <a class="el" href="a14746_source.html#l00116">116</a> of file <a class="el" href="a14746_source.html">bits/alloc_traits.h</a>.</p> </div> </div> <a id="ad2eb6f18c8a2ff167bc276f2ca6c89e2"></a> <h2 class="memtitle"><span class="permalink"><a href="#ad2eb6f18c8a2ff167bc276f2ca6c89e2">◆ </a></span>const_void_pointer</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Alloc> </div> <table class="memname"> <tr> <td class="memname">typedef __const_void_pointer <a class="el" href="a04085.html">std::allocator_traits</a>< _Alloc >::<a class="el" href="a04085.html#ad2eb6f18c8a2ff167bc276f2ca6c89e2">const_void_pointer</a></td> </tr> </table> </div><div class="memdoc"> <p>The allocator's const void pointer type. </p> <p><code>Alloc::const_void_pointer</code> if that type exists, otherwise <code> pointer_traits<pointer>::rebind<const void> </code> </p> <p class="definition">Definition at line <a class="el" href="a14746_source.html#l00138">138</a> of file <a class="el" href="a14746_source.html">bits/alloc_traits.h</a>.</p> </div> </div> <a id="a3e7a121977c8b44d247526a3f8d655f8"></a> <h2 class="memtitle"><span class="permalink"><a href="#a3e7a121977c8b44d247526a3f8d655f8">◆ </a></span>difference_type</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Alloc> </div> <table class="memname"> <tr> <td class="memname">typedef __difference_type <a class="el" href="a04085.html">std::allocator_traits</a>< _Alloc >::<a class="el" href="a04085.html#a3e7a121977c8b44d247526a3f8d655f8">difference_type</a></td> </tr> </table> </div><div class="memdoc"> <p>The allocator's difference type. </p> <p><code>Alloc::difference_type</code> if that type exists, otherwise <code> pointer_traits<pointer>::difference_type </code> </p> <p class="definition">Definition at line <a class="el" href="a14746_source.html#l00149">149</a> of file <a class="el" href="a14746_source.html">bits/alloc_traits.h</a>.</p> </div> </div> <a id="a8fa48f2bd3c8a0c32836872689b2ca62"></a> <h2 class="memtitle"><span class="permalink"><a href="#a8fa48f2bd3c8a0c32836872689b2ca62">◆ </a></span>pointer</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Alloc> </div> <table class="memname"> <tr> <td class="memname">typedef __pointer <a class="el" href="a04085.html">std::allocator_traits</a>< _Alloc >::<a class="el" href="a04085.html#a8fa48f2bd3c8a0c32836872689b2ca62">pointer</a></td> </tr> </table> </div><div class="memdoc"> <p>The allocator's pointer type. </p> <p><code>Alloc::pointer</code> if that type exists, otherwise <code>value_type*</code> </p> <p class="definition">Definition at line <a class="el" href="a14746_source.html#l00105">105</a> of file <a class="el" href="a14746_source.html">bits/alloc_traits.h</a>.</p> </div> </div> <a id="aaf8537cdd5491ce78baf889aa79c9216"></a> <h2 class="memtitle"><span class="permalink"><a href="#aaf8537cdd5491ce78baf889aa79c9216">◆ </a></span>propagate_on_container_copy_assignment</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Alloc> </div> <table class="memname"> <tr> <td class="memname">typedef __propagate_on_container_copy_assignment <a class="el" href="a04085.html">std::allocator_traits</a>< _Alloc >::<a class="el" href="a04085.html#aaf8537cdd5491ce78baf889aa79c9216">propagate_on_container_copy_assignment</a></td> </tr> </table> </div><div class="memdoc"> <p>How the allocator is propagated on copy assignment. </p> <p><code>Alloc::propagate_on_container_copy_assignment</code> if that type exists, otherwise <code>false_type</code> </p> <p class="definition">Definition at line <a class="el" href="a14746_source.html#l00172">172</a> of file <a class="el" href="a14746_source.html">bits/alloc_traits.h</a>.</p> </div> </div> <a id="aaa25d41df1ee33bc852b46687f42c8a2"></a> <h2 class="memtitle"><span class="permalink"><a href="#aaa25d41df1ee33bc852b46687f42c8a2">◆ </a></span>propagate_on_container_move_assignment</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Alloc> </div> <table class="memname"> <tr> <td class="memname">typedef __propagate_on_container_move_assignment <a class="el" href="a04085.html">std::allocator_traits</a>< _Alloc >::<a class="el" href="a04085.html#aaa25d41df1ee33bc852b46687f42c8a2">propagate_on_container_move_assignment</a></td> </tr> </table> </div><div class="memdoc"> <p>How the allocator is propagated on move assignment. </p> <p><code>Alloc::propagate_on_container_move_assignment</code> if that type exists, otherwise <code>false_type</code> </p> <p class="definition">Definition at line <a class="el" href="a14746_source.html#l00184">184</a> of file <a class="el" href="a14746_source.html">bits/alloc_traits.h</a>.</p> </div> </div> <a id="ab473299e767e1bd58e5b71f0a87c05b1"></a> <h2 class="memtitle"><span class="permalink"><a href="#ab473299e767e1bd58e5b71f0a87c05b1">◆ </a></span>propagate_on_container_swap</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Alloc> </div> <table class="memname"> <tr> <td class="memname">typedef __propagate_on_container_swap <a class="el" href="a04085.html">std::allocator_traits</a>< _Alloc >::<a class="el" href="a04085.html#ab473299e767e1bd58e5b71f0a87c05b1">propagate_on_container_swap</a></td> </tr> </table> </div><div class="memdoc"> <p>How the allocator is propagated on swap. </p> <p><code>Alloc::propagate_on_container_swap</code> if that type exists, otherwise <code>false_type</code> </p> <p class="definition">Definition at line <a class="el" href="a14746_source.html#l00195">195</a> of file <a class="el" href="a14746_source.html">bits/alloc_traits.h</a>.</p> </div> </div> <a id="aba783acc03d73b750b1525250084f104"></a> <h2 class="memtitle"><span class="permalink"><a href="#aba783acc03d73b750b1525250084f104">◆ </a></span>size_type</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Alloc> </div> <table class="memname"> <tr> <td class="memname">typedef __size_type <a class="el" href="a04085.html">std::allocator_traits</a>< _Alloc >::<a class="el" href="a04085.html#aba783acc03d73b750b1525250084f104">size_type</a></td> </tr> </table> </div><div class="memdoc"> <p>The allocator's size type. </p> <p><code>Alloc::size_type</code> if that type exists, otherwise <code> make_unsigned<difference_type>::type </code> </p> <p class="definition">Definition at line <a class="el" href="a14746_source.html#l00160">160</a> of file <a class="el" href="a14746_source.html">bits/alloc_traits.h</a>.</p> </div> </div> <a id="aa51dca0f6ab162918c10679e8feb57df"></a> <h2 class="memtitle"><span class="permalink"><a href="#aa51dca0f6ab162918c10679e8feb57df">◆ </a></span>value_type</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Alloc> </div> <table class="memname"> <tr> <td class="memname">typedef _Alloc::value_type <a class="el" href="a04085.html">std::allocator_traits</a>< _Alloc >::<a class="el" href="a04085.html#aa51dca0f6ab162918c10679e8feb57df">value_type</a></td> </tr> </table> </div><div class="memdoc"> <p>The allocated type. </p> <p class="definition">Definition at line <a class="el" href="a14746_source.html#l00088">88</a> of file <a class="el" href="a14746_source.html">bits/alloc_traits.h</a>.</p> </div> </div> <a id="a7bf3224b11fa6d5a86d3c9bcfa9bae40"></a> <h2 class="memtitle"><span class="permalink"><a href="#a7bf3224b11fa6d5a86d3c9bcfa9bae40">◆ </a></span>void_pointer</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Alloc> </div> <table class="memname"> <tr> <td class="memname">typedef __void_pointer <a class="el" href="a04085.html">std::allocator_traits</a>< _Alloc >::<a class="el" href="a04085.html#a7bf3224b11fa6d5a86d3c9bcfa9bae40">void_pointer</a></td> </tr> </table> </div><div class="memdoc"> <p>The allocator's void pointer type. </p> <p><code>Alloc::void_pointer</code> if that type exists, otherwise <code> pointer_traits<pointer>::rebind<void> </code> </p> <p class="definition">Definition at line <a class="el" href="a14746_source.html#l00127">127</a> of file <a class="el" href="a14746_source.html">bits/alloc_traits.h</a>.</p> </div> </div> <h2 class="groupheader">Member Function Documentation</h2> <a id="a1afbf725286c9e82ba6166dcc04b10bc"></a> <h2 class="memtitle"><span class="permalink"><a href="#a1afbf725286c9e82ba6166dcc04b10bc">◆ </a></span>allocate() <span class="overload">[1/2]</span></h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Alloc> </div> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static <a class="el" href="a04085.html#a8fa48f2bd3c8a0c32836872689b2ca62">pointer</a> <a class="el" href="a04085.html">std::allocator_traits</a>< _Alloc >::allocate </td> <td>(</td> <td class="paramtype">_Alloc & </td> <td class="paramname"><em>__a</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"><a class="el" href="a04085.html#aba783acc03d73b750b1525250084f104">size_type</a> </td> <td class="paramname"><em>__n</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Allocate memory. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">__a</td><td>An allocator. </td></tr> <tr><td class="paramname">__n</td><td>The number of objects to allocate space for.</td></tr> </table> </dd> </dl> <p>Calls <code>a.allocate(n)</code> </p> <p class="definition">Definition at line <a class="el" href="a14746_source.html#l00359">359</a> of file <a class="el" href="a14746_source.html">bits/alloc_traits.h</a>.</p> <p class="reference">Referenced by <a class="el" href="a00260_source.html#l00100">std::__allocate_guarded()</a>.</p> </div> </div> <a id="a79296fdf0f48ef0a49f2d5de6193f867"></a> <h2 class="memtitle"><span class="permalink"><a href="#a79296fdf0f48ef0a49f2d5de6193f867">◆ </a></span>allocate() <span class="overload">[2/2]</span></h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Alloc> </div> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static <a class="el" href="a04085.html#a8fa48f2bd3c8a0c32836872689b2ca62">pointer</a> <a class="el" href="a04085.html">std::allocator_traits</a>< _Alloc >::allocate </td> <td>(</td> <td class="paramtype">_Alloc & </td> <td class="paramname"><em>__a</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"><a class="el" href="a04085.html#aba783acc03d73b750b1525250084f104">size_type</a> </td> <td class="paramname"><em>__n</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"><a class="el" href="a04085.html#ad2eb6f18c8a2ff167bc276f2ca6c89e2">const_void_pointer</a> </td> <td class="paramname"><em>__hint</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Allocate memory. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">__a</td><td>An allocator. </td></tr> <tr><td class="paramname">__n</td><td>The number of objects to allocate space for. </td></tr> <tr><td class="paramname">__hint</td><td>Aid to locality. </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>Memory of suitable size and alignment for <em>n</em> objects of type <code>value_type</code> </dd></dl> <p>Returns <code> a.allocate(n, hint) </code> if that expression is well-formed, otherwise returns <code>a.allocate(n)</code> </p> <p class="definition">Definition at line <a class="el" href="a14746_source.html#l00374">374</a> of file <a class="el" href="a14746_source.html">bits/alloc_traits.h</a>.</p> </div> </div> <a id="aad7d7b8604439d1ecf953a1b9a426e7b"></a> <h2 class="memtitle"><span class="permalink"><a href="#aad7d7b8604439d1ecf953a1b9a426e7b">◆ </a></span>construct()</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Alloc> </div> <div class="memtemplate"> template<typename _Tp , typename... _Args> </div> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static auto <a class="el" href="a04085.html">std::allocator_traits</a>< _Alloc >::construct </td> <td>(</td> <td class="paramtype">_Alloc & </td> <td class="paramname"><em>__a</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">_Tp * </td> <td class="paramname"><em>__p</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">_Args &&... </td> <td class="paramname"><em>__args</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td> -> decltype(_S_construct(__a, __p, <a class="el" href="a01431.html#gacb5baec338e12b99cb6bddea7506c7c6">std::forward</a><_Args>(__args)...)) </td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Construct an object of type <em>_Tp</em>. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">__a</td><td>An allocator. </td></tr> <tr><td class="paramname">__p</td><td>Pointer to memory of suitable size and alignment for Tp </td></tr> <tr><td class="paramname">__args</td><td>Constructor arguments.</td></tr> </table> </dd> </dl> <p>Calls <code> __a.construct(__p, std::forward<Args>(__args)...) </code> if that expression is well-formed, otherwise uses placement-new to construct an object of type <em>_Tp</em> at location <em>__p</em> from the arguments <em>__args</em>... </p> <p class="definition">Definition at line <a class="el" href="a14746_source.html#l00400">400</a> of file <a class="el" href="a14746_source.html">bits/alloc_traits.h</a>.</p> </div> </div> <a id="ae5f6b86b98b17e2ba39243ca8eaf4ee1"></a> <h2 class="memtitle"><span class="permalink"><a href="#ae5f6b86b98b17e2ba39243ca8eaf4ee1">◆ </a></span>deallocate()</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Alloc> </div> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static void <a class="el" href="a04085.html">std::allocator_traits</a>< _Alloc >::deallocate </td> <td>(</td> <td class="paramtype">_Alloc & </td> <td class="paramname"><em>__a</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"><a class="el" href="a04085.html#a8fa48f2bd3c8a0c32836872689b2ca62">pointer</a> </td> <td class="paramname"><em>__p</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"><a class="el" href="a04085.html#aba783acc03d73b750b1525250084f104">size_type</a> </td> <td class="paramname"><em>__n</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Deallocate memory. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">__a</td><td>An allocator. </td></tr> <tr><td class="paramname">__p</td><td>Pointer to the memory to deallocate. </td></tr> <tr><td class="paramname">__n</td><td>The number of objects space was allocated for.</td></tr> </table> </dd> </dl> <p>Calls <code> a.deallocate(p, n) </code> </p> <p class="definition">Definition at line <a class="el" href="a14746_source.html#l00385">385</a> of file <a class="el" href="a14746_source.html">bits/alloc_traits.h</a>.</p> <p class="reference">Referenced by <a class="el" href="a00260_source.html#l00069">std::__allocated_ptr< _Alloc >::~__allocated_ptr()</a>.</p> </div> </div> <a id="ac73f3d164cf01c9d61b44d42c30db3d3"></a> <h2 class="memtitle"><span class="permalink"><a href="#ac73f3d164cf01c9d61b44d42c30db3d3">◆ </a></span>destroy()</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Alloc> </div> <div class="memtemplate"> template<typename _Tp > </div> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static void <a class="el" href="a04085.html">std::allocator_traits</a>< _Alloc >::destroy </td> <td>(</td> <td class="paramtype">_Alloc & </td> <td class="paramname"><em>__a</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">_Tp * </td> <td class="paramname"><em>__p</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Destroy an object of type <em>_Tp</em>. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">__a</td><td>An allocator. </td></tr> <tr><td class="paramname">__p</td><td>Pointer to the object to destroy</td></tr> </table> </dd> </dl> <p>Calls <code>__a.destroy(__p)</code> if that expression is well-formed, otherwise calls <code>__p->~_Tp()</code> </p> <p class="definition">Definition at line <a class="el" href="a14746_source.html#l00413">413</a> of file <a class="el" href="a14746_source.html">bits/alloc_traits.h</a>.</p> </div> </div> <a id="a29c306bcb6a7676a516430a0e50b990a"></a> <h2 class="memtitle"><span class="permalink"><a href="#a29c306bcb6a7676a516430a0e50b990a">◆ </a></span>max_size()</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Alloc> </div> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static <a class="el" href="a04085.html#aba783acc03d73b750b1525250084f104">size_type</a> <a class="el" href="a04085.html">std::allocator_traits</a>< _Alloc >::max_size </td> <td>(</td> <td class="paramtype">const _Alloc & </td> <td class="paramname"><em>__a</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span><span class="mlabel">noexcept</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>The maximum supported allocation size. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">__a</td><td>An allocator. </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd><code>__a.max_size()</code> or <code>numeric_limits<size_type>::max()</code> </dd></dl> <p>Returns <code>__a.max_size()</code> if that expression is well-formed, otherwise returns <code>numeric_limits<size_type>::max()</code> </p> <p class="definition">Definition at line <a class="el" href="a14746_source.html#l00424">424</a> of file <a class="el" href="a14746_source.html">bits/alloc_traits.h</a>.</p> </div> </div> <a id="ac324d9065f45f7ae2dd1e0014c73f218"></a> <h2 class="memtitle"><span class="permalink"><a href="#ac324d9065f45f7ae2dd1e0014c73f218">◆ </a></span>select_on_container_copy_construction()</h2> <div class="memitem"> <div class="memproto"> <div class="memtemplate"> template<typename _Alloc> </div> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static _Alloc <a class="el" href="a04085.html">std::allocator_traits</a>< _Alloc >::select_on_container_copy_construction </td> <td>(</td> <td class="paramtype">const _Alloc & </td> <td class="paramname"><em>__rhs</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Obtain an allocator to use when copying a container. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">__rhs</td><td>An allocator. </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd><code>__rhs.select_on_container_copy_construction()</code> or <em>__rhs</em> </dd></dl> <p>Returns <code>__rhs.select_on_container_copy_construction()</code> if that expression is well-formed, otherwise returns <em>__rhs</em> </p> <p class="definition">Definition at line <a class="el" href="a14746_source.html#l00436">436</a> of file <a class="el" href="a14746_source.html">bits/alloc_traits.h</a>.</p> </div> </div> <hr/>The documentation for this struct was generated from the following file:<ul> <li><a class="el" href="a14746_source.html">bits/alloc_traits.h</a></li> </ul> </div><!-- contents --> </div><!-- doc-content --> <!-- start footer part --> <div id="nav-path" class="navpath"><!-- id is needed for treeview function! --> <ul> <li class="navelem"><a class="el" href="a01487.html">std</a></li><li class="navelem"><a class="el" href="a04085.html">allocator_traits</a></li> <li class="footer">Generated by <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.13 </li> </ul> </div> </body> </html>