From 88e602c57797660ebe0f9e15dbd64c1ff16dead3 Mon Sep 17 00:00:00 2001 From: DongHun Kwak Date: Wed, 13 Sep 2017 11:26:20 +0900 Subject: Imported Upstream version 1.65.1 Change-Id: Ie4005d637141f8311f4b6d46b613478a2b3dae59 Signed-off-by: DongHun Kwak --- doc/html/boost/container/node_handle.html | 88 +++++++++++++++---------------- 1 file changed, 44 insertions(+), 44 deletions(-) (limited to 'doc/html/boost/container/node_handle.html') diff --git a/doc/html/boost/container/node_handle.html b/doc/html/boost/container/node_handle.html index f8911b08c1..5d8d571be1 100644 --- a/doc/html/boost/container/node_handle.html +++ b/doc/html/boost/container/node_handle.html @@ -43,32 +43,32 @@ typedef priv_node_t container_node_type; // construct/copy/destruct - node_handle() noexcept; - node_handle(node_pointer, const nallocator_type &) noexcept; + node_handle() noexcept; + node_handle(node_pointer, const nallocator_type &) noexcept; template<typename KeyMapped2> - node_handle(node_handle< NodeAllocator, KeyMapped2 > &&, unspecified = 0) noexcept; - node_handle(node_handle &&) noexcept; - node_handle & operator=(node_handle &&) noexcept; - ~node_handle(); + node_handle(node_handle< NodeAllocator, KeyMapped2 > &&, unspecified = 0) noexcept; + node_handle(node_handle &&) noexcept; + node_handle & operator=(node_handle &&) noexcept; + ~node_handle(); - // friend functions - friend void swap(node_handle &, node_handle &) noexcept(BOOST_NOEXCEPT(x.swap(y)))); + // friend functions + friend void swap(node_handle &, node_handle &) noexcept(BOOST_NOEXCEPT(x.swap(y)))); - // public member functions - value_type & value() const noexcept; - key_type & key() const noexcept; - mapped_type & mapped() const noexcept; - allocator_type get_allocator() const; - explicit operator bool() const noexcept; - bool empty() const noexcept; - void swap(node_handle &) noexcept(nator_traits::propagate_on_container_swap::value||nator_traits::is_always_equal::value)); - node_pointer release() noexcept; - node_pointer get() const noexcept; - nallocator_type & node_alloc() noexcept; - const nallocator_type & node_alloc() const noexcept; + // public member functions + value_type & value() const noexcept; + key_type & key() const noexcept; + mapped_type & mapped() const noexcept; + allocator_type get_allocator() const; + explicit operator bool() const noexcept; + bool empty() const noexcept; + void swap(node_handle &) noexcept(nator_traits::propagate_on_container_swap::value||nator_traits::is_always_equal::value)); + node_pointer release() noexcept; + node_pointer get() const noexcept; + nallocator_type & node_alloc() noexcept; + const nallocator_type & node_alloc() const noexcept; };
-

Description

+

Description

A node_handle is an object that accepts ownership of a single element from an associative container. It may be used to transfer that ownership to another container with compatible nodes. Containers with compatible nodes have the same node handle type. Elements may be transferred in either direction between container types in the same row:.

Container types with compatible nodes

map<K, T, C1, A> <-> map<K, T, C2, A>

@@ -77,113 +77,113 @@

set<K, C1, A> <-> multiset<K, C2, A>

If a node handle is not empty, then it contains an allocator that is equal to the allocator of the container when the element was extracted. If a node handle is empty, it contains no allocator.

-

+

node_handle public construct/copy/destruct

  1. -
    node_handle() noexcept;
    +
    node_handle() noexcept;

    Effects: Initializes m_ptr to nullptr.

    Postcondition: this->empty()

  2. -
    node_handle(node_pointer p, const nallocator_type & al) noexcept;
    +
    node_handle(node_pointer p, const nallocator_type & al) noexcept;

    Effects: Constructs a node_handle object initializing internal pointer with p. If p != nullptr copy constructs internal allocator from al. 

  3. template<typename KeyMapped2> 
-  node_handle(node_handle< NodeAllocator, KeyMapped2 > && nh, unspecified = 0) noexcept;
    + node_handle(node_handle< NodeAllocator, KeyMapped2 > && nh, unspecified = 0) noexcept;

    Effects: Constructs a node_handle object initializing internal pointer with a related nh's internal pointer and assigns nullptr to the later. If nh's internal pointer was not nullptr, move constructs internal allocator with nh's internal allocator and destroy nh's internal allocator.

    Postcondition: nh.empty()

    Note: Two node_handle's are related if only one of KeyMapped template parameter of a node handle is void.

  4. -
    node_handle(node_handle && nh) noexcept;
    +
    node_handle(node_handle && nh) noexcept;

    Effects: Constructs a node_handle object initializing internal pointer with nh's internal pointer and assigns nullptr to the later. If nh's internal pointer was not nullptr, move constructs internal allocator with nh's internal allocator and destroy nh's internal allocator.

    Postcondition: nh.empty()

  5. -
    node_handle & operator=(node_handle && nh) noexcept;
    +
    node_handle & operator=(node_handle && nh) noexcept;

    Requires: Either this->empty(), or nator_traits::propagate_on_container_move_assignment is true, or node_alloc() == nh.node_alloc().

    Effects: If m_ptr != nullptr, destroys the value_type subobject in the container_node_type object pointed to by m_ptr by calling nator_traits::destroy, then deallocates m_ptr by calling nator_traits::deallocate. Assigns nh.m_ptr to m_ptr. If this->empty() or nator_traits::propagate_on_container_move_assignment is true, move assigns nh.node_alloc() to node_alloc(). Assigns nullptr to nh.m_ptr and assigns nullopt to nh.node_alloc().

    Returns: *this.

    Throws: Nothing.

  6. -
    ~node_handle();
    +
    ~node_handle();

    Effects: If !this->empty(), destroys the value_type subobject in the container_node_type object pointed to by c by calling allocator_traits<impl_defined>::destroy, then deallocates m_ptr by calling nator_traits::rebind_traits<container_node_type>::deallocate.

-

-node_handle friend functions

+

+node_handle friend functions

  1. -
    friend void swap(node_handle & x, node_handle & y) noexcept(BOOST_NOEXCEPT(x.swap(y))));
    +
    friend void swap(node_handle & x, node_handle & y) noexcept(BOOST_NOEXCEPT(x.swap(y))));

    Effects: x.swap(y).

-

-node_handle public member functions

+

+node_handle public member functions

  1. -
    value_type & value() const noexcept;
    +
    value_type & value() const noexcept;

    Requires: empty() == false.

    Returns: A reference to the value_type subobject in the container_node_type object pointed to by m_ptr

    Throws: Nothing.

  2. -
    key_type & key() const noexcept;
    +
    key_type & key() const noexcept;

    Requires: empty() == false.

    Returns: A non-const reference to the key_type member of the value_type subobject in the container_node_type object pointed to by m_ptr.

    Throws: Nothing.

    Requires: Modifying the key through the returned reference is permitted.

  3. -
    mapped_type & mapped() const noexcept;
    +
    mapped_type & mapped() const noexcept;

    Requires: empty() == false.

    Returns: A reference to the mapped_type member of the value_type subobject in the container_node_type object pointed to by m_ptr

    Throws: Nothing.

  4. -
    allocator_type get_allocator() const;
    +
    allocator_type get_allocator() const;

    Requires: empty() == false.

    Returns: A copy of the internally hold allocator.

    Throws: Nothing.

  5. -
    explicit operator bool() const noexcept;
    +
    explicit operator bool() const noexcept;

    Returns: m_ptr != nullptr.

  6. -
    bool empty() const noexcept;
    +
    bool empty() const noexcept;

    Returns: m_ptr == nullptr.

  7. -
    void swap(node_handle & nh) noexcept(nator_traits::propagate_on_container_swap::value||nator_traits::is_always_equal::value));
    +
    void swap(node_handle & nh) noexcept(nator_traits::propagate_on_container_swap::value||nator_traits::is_always_equal::value));

    Requires: this->empty(), or nh.empty(), or nator_traits::propagate_on_container_swap is true, or node_alloc() == nh.node_alloc().

    Effects: Calls swap(m_ptr, nh.m_ptr). If this->empty(), or nh.empty(), or nator_traits::propagate_on_- container_swap is true calls swap(node_alloc(), nh.node_alloc()).

  8. -
    node_pointer release() noexcept;
    +
    node_pointer release() noexcept;

    Effects: If this->empty() returns nullptr, otherwise returns m_ptr resets m_ptr to nullptr and destroys the internal allocator.

    Postcondition: this->empty()

    Note: Non-standard extensions

  9. -
    node_pointer get() const noexcept;
    +
    node_pointer get() const noexcept;

    Effects: Returns m_ptr.

    Note: Non-standard extensions

  10. -
    nallocator_type & node_alloc() noexcept;
    +
    nallocator_type & node_alloc() noexcept;

    Effects: Returns a reference to the internal node allocator.

    Note: Non-standard extensions

  11. -
    const nallocator_type & node_alloc() const noexcept;
    +
    const nallocator_type & node_alloc() const noexcept;

    Effects: Returns a reference to the internal node allocator.

    Note: Non-standard extensions

    12. -- cgit v1.2.3