Merge pull request #83 from cmazakas/contains-doc-updates

`contains()` Doc Updates
This commit is contained in:
Peter Dimov
2022-01-14 23:56:22 +02:00
committed by GitHub
3 changed files with 166 additions and 0 deletions

View File

@ -15,6 +15,7 @@
* Improved C++20 support:
* All containers have been updated to support
heterogeneous `count`, `equal_range` and `find`.
* All containers now implement the member function `contains`
* Improved C++23 support:
* All containers have been updated to support
heterogeneous `erase` and `extract`.

View File

@ -1406,6 +1406,39 @@ EOL;
</para>
</notes>
</overloaded-method>
<overloaded-method name="contains">
<signature cv="const">
<parameter name="key">
<paramtype>key_type const&amp;</paramtype>
</parameter>
<type>bool</type>
</signature>
<signature>
<template>
<template-type-parameter name="K" />
</template>
<parameter name="key">
<paramtype>K const&amp;</paramtype>
</parameter>
<type>bool</type>
</signature>
<returns>
<para>
A boolean indicating whether or not there is an element with key equal to <code>key</code> in the container
</para>
</returns>
<notes>
<para>
The <code>template &lt;typename K&gt;</code> overload only participates
in overload resolution if <code>Hash::is_transparent</code> and
<code>Pred::is_transparent</code> are valid member typedefs. The
library assumes that <code>Hash</code> is callable with both
<code>K</code> and <code>Key</code> and that <code>Pred</code> is
transparent. This enables heterogeneous lookup which avoids the cost of
instantiating an instance of the <code>Key</code> type.
</para>
</notes>
</overloaded-method>
<overloaded-method name="count">
<signature cv="const">
<parameter name="k">

View File

@ -1233,6 +1233,39 @@ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
</para>
</notes>
</overloaded-method>
<overloaded-method name="contains">
<signature cv="const">
<parameter name="key">
<paramtype>key_type const&amp;</paramtype>
</parameter>
<type>bool</type>
</signature>
<signature>
<template>
<template-type-parameter name="K" />
</template>
<parameter name="key">
<paramtype>K const&amp;</paramtype>
</parameter>
<type>bool</type>
</signature>
<returns>
<para>
A boolean indicating whether or not there is an element with key equal to <code>key</code> in the container
</para>
</returns>
<notes>
<para>
The <code>template &lt;typename K&gt;</code> overload only participates
in overload resolution if <code>Hash::is_transparent</code> and
<code>Pred::is_transparent</code> are valid member typedefs. The
library assumes that <code>Hash</code> is callable with both
<code>K</code> and <code>Key</code> and that <code>Pred</code> is
transparent. This enables heterogeneous lookup which avoids the cost of
instantiating an instance of the <code>Key</code> type.
</para>
</notes>
</overloaded-method>
<overloaded-method name="count">
<signature cv="const">
<parameter name="k">
@ -2772,6 +2805,39 @@ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
</para>
</notes>
</overloaded-method>
<overloaded-method name="contains">
<signature cv="const">
<parameter name="key">
<paramtype>key_type const&amp;</paramtype>
</parameter>
<type>bool</type>
</signature>
<signature>
<template>
<template-type-parameter name="K" />
</template>
<parameter name="key">
<paramtype>K const&amp;</paramtype>
</parameter>
<type>bool</type>
</signature>
<returns>
<para>
A boolean indicating whether or not there is an element with key equal to <code>key</code> in the container
</para>
</returns>
<notes>
<para>
The <code>template &lt;typename K&gt;</code> overload only participates
in overload resolution if <code>Hash::is_transparent</code> and
<code>Pred::is_transparent</code> are valid member typedefs. The
library assumes that <code>Hash</code> is callable with both
<code>K</code> and <code>Key</code> and that <code>Pred</code> is
transparent. This enables heterogeneous lookup which avoids the cost of
instantiating an instance of the <code>Key</code> type.
</para>
</notes>
</overloaded-method>
<overloaded-method name="count">
<signature cv="const">
<parameter name="k">
@ -4432,6 +4498,39 @@ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
</para>
</notes>
</overloaded-method>
<overloaded-method name="contains">
<signature cv="const">
<parameter name="key">
<paramtype>key_type const&amp;</paramtype>
</parameter>
<type>bool</type>
</signature>
<signature>
<template>
<template-type-parameter name="K" />
</template>
<parameter name="key">
<paramtype>K const&amp;</paramtype>
</parameter>
<type>bool</type>
</signature>
<returns>
<para>
A boolean indicating whether or not there is an element with key equal to <code>key</code> in the container
</para>
</returns>
<notes>
<para>
The <code>template &lt;typename K&gt;</code> overload only participates
in overload resolution if <code>Hash::is_transparent</code> and
<code>Pred::is_transparent</code> are valid member typedefs. The
library assumes that <code>Hash</code> is callable with both
<code>K</code> and <code>Key</code> and that <code>Pred</code> is
transparent. This enables heterogeneous lookup which avoids the cost of
instantiating an instance of the <code>Key</code> type.
</para>
</notes>
</overloaded-method>
<overloaded-method name="count">
<signature cv="const">
<parameter name="k">
@ -6018,6 +6117,39 @@ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
</para>
</notes>
</overloaded-method>
<overloaded-method name="contains">
<signature cv="const">
<parameter name="key">
<paramtype>key_type const&amp;</paramtype>
</parameter>
<type>bool</type>
</signature>
<signature>
<template>
<template-type-parameter name="K" />
</template>
<parameter name="key">
<paramtype>K const&amp;</paramtype>
</parameter>
<type>bool</type>
</signature>
<returns>
<para>
A boolean indicating whether or not there is an element with key equal to <code>key</code> in the container
</para>
</returns>
<notes>
<para>
The <code>template &lt;typename K&gt;</code> overload only participates
in overload resolution if <code>Hash::is_transparent</code> and
<code>Pred::is_transparent</code> are valid member typedefs. The
library assumes that <code>Hash</code> is callable with both
<code>K</code> and <code>Key</code> and that <code>Pred</code> is
transparent. This enables heterogeneous lookup which avoids the cost of
instantiating an instance of the <code>Key</code> type.
</para>
</notes>
</overloaded-method>
<overloaded-method name="count">
<signature cv="const">
<parameter name="k">