上传cppreference
This commit is contained in:
153
web/cppreference-zh/chmhelp/cpp-utility-any-any_cast.html
Normal file
153
web/cppreference-zh/chmhelp/cpp-utility-any-any_cast.html
Normal file
@@ -0,0 +1,153 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="zh" dir="ltr" class="client-nojs" xmlns="http://www.w3.org/1999/xhtml" xml:lang="zh">
|
||||
<head><meta http-equiv="x-ua-compatible" content="ie=edge">
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<title>std::any_cast</title>
|
||||
<link rel="stylesheet" href="ext.css" />
|
||||
<link rel="stylesheet" href="site_modules.css" />
|
||||
</head>
|
||||
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject page-cpp_utility_any_any_cast skin-cppreference2 action-view cpp-navbar">
|
||||
<div id="cpp-content-base">
|
||||
<div id="content"><a id="top"></a>
|
||||
<h1 id="firstHeading" class="firstHeading"><span style="font-size:0.7em; line-height:130%">std::</span>any_cast</h1>
|
||||
<div id="bodyContent">
|
||||
<div id="contentSub"><span class="subpages">< <a href="cpp.html">cpp</a>‎ | <a href="cpp-utility.html">utility</a>‎ | <a href="cpp-utility-any.html">any</a></span></div>
|
||||
<div id="mw-content-text" lang="zh" dir="ltr" class="mw-content-ltr" xml:lang="zh">
|
||||
<table class="t-dcl-begin">
|
||||
<tbody>
|
||||
<tr class="t-dcl t-since-cxx17">
|
||||
<td>
|
||||
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> T<span class="sy1">></span><br />
|
||||
T any_cast<span class="br0">(</span><span class="kw4">const</span> any<span class="sy3">&</span> operand<span class="br0">)</span><span class="sy4">;</span></span></div>
|
||||
</td>
|
||||
<td>(1)</td>
|
||||
<td><span class="t-mark-rev t-since-cxx17">(C++17 起)</span></td>
|
||||
</tr>
|
||||
<tr class="t-dcl t-since-cxx17">
|
||||
<td>
|
||||
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> T<span class="sy1">></span><br />
|
||||
T any_cast<span class="br0">(</span>any<span class="sy3">&</span> operand<span class="br0">)</span><span class="sy4">;</span></span></div>
|
||||
</td>
|
||||
<td>(2)</td>
|
||||
<td><span class="t-mark-rev t-since-cxx17">(C++17 起)</span></td>
|
||||
</tr>
|
||||
<tr class="t-dcl t-since-cxx17">
|
||||
<td>
|
||||
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> T<span class="sy1">></span><br />
|
||||
T any_cast<span class="br0">(</span>any<span class="sy3">&&</span> operand<span class="br0">)</span><span class="sy4">;</span></span></div>
|
||||
</td>
|
||||
<td>(3)</td>
|
||||
<td><span class="t-mark-rev t-since-cxx17">(C++17 起)</span></td>
|
||||
</tr>
|
||||
<tr class="t-dcl t-since-cxx17">
|
||||
<td>
|
||||
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> T<span class="sy1">></span><br />
|
||||
<span class="kw4">const</span> T<span class="sy2">*</span> any_cast<span class="br0">(</span><span class="kw4">const</span> any<span class="sy2">*</span> operand<span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span></span></div>
|
||||
</td>
|
||||
<td>(4)</td>
|
||||
<td><span class="t-mark-rev t-since-cxx17">(C++17 起)</span></td>
|
||||
</tr>
|
||||
<tr class="t-dcl t-since-cxx17">
|
||||
<td>
|
||||
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> T<span class="sy1">></span><br />
|
||||
T<span class="sy2">*</span> any_cast<span class="br0">(</span>any<span class="sy2">*</span> operand<span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span></span></div>
|
||||
</td>
|
||||
<td>(5)</td>
|
||||
<td><span class="t-mark-rev t-since-cxx17">(C++17 起)</span></td>
|
||||
</tr>
|
||||
<tr class="t-dcl-sep">
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p>进行对所含有对象的类型安全访问。</p>
|
||||
<p>令 <code>U</code> 为 <span class="t-c"><span class="mw-geshi cpp source-cpp"><a href="cpp-types-remove_cv.html"><span class="kw597">std::<span class="me2">remove_cv_t</span></span></a><span class="sy1"><</span><a href="cpp-types-remove_reference.html"><span class="kw607">std::<span class="me2">remove_reference_t</span></span></a><span class="sy1"><</span>T<span class="sy1">>></span></span></span> 。</p>
|
||||
<div class="t-li1"><span class="t-li">1)</span> 若 <span class="t-c"><span class="mw-geshi cpp source-cpp">is_constructible_v<span class="sy1"><</span>T, <span class="kw4">const</span> U<span class="sy3">&</span><span class="sy1">></span></span></span> 非 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw2">true</span></span></span> 则程序为病式。</div>
|
||||
<div class="t-li1"><span class="t-li">2)</span> 若 <span class="t-c"><span class="mw-geshi cpp source-cpp">is_constructible_v<span class="sy1"><</span>T, U<span class="sy3">&</span><span class="sy1">></span></span></span> 非 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw2">true</span></span></span> 则程序为病式。</div>
|
||||
<div class="t-li1"><span class="t-li">3)</span> 若 <span class="t-c"><span class="mw-geshi cpp source-cpp">is_constructible_v<span class="sy1"><</span>T, U<span class="sy1">></span></span></span> 非 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw2">true</span></span></span> 则程序为病式。</div>
|
||||
<h3><span class="mw-headline" id=".E5.8F.82.E6.95.B0">参数</span></h3>
|
||||
<table class="t-par-begin">
|
||||
<tr class="t-par">
|
||||
<td>operand</td>
|
||||
<td>-</td>
|
||||
<td>目标 <code>any</code> 对象</td>
|
||||
</tr>
|
||||
</table>
|
||||
<h3><span class="mw-headline" id=".E8.BF.94.E5.9B.9E.E5.80.BC">返回值</span></h3>
|
||||
<div class="t-li1"><span class="t-li">1-2)</span> 返回 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw1">static_cast</span><span class="sy1"><</span>T<span class="sy1">></span><span class="br0">(</span><span class="sy2">*</span>std<span class="sy4">::</span><span class="me2">any_cast</span><span class="sy1"><</span>U<span class="sy1">></span><span class="br0">(</span><span class="sy3">&</span>operand<span class="br0">)</span><span class="br0">)</span></span></span> 。</div>
|
||||
<div class="t-li1"><span class="t-li">3)</span> 返回 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw1">static_cast</span><span class="sy1"><</span>T<span class="sy1">></span><span class="br0">(</span>std<span class="sy4">::</span><span class="me2">move</span><span class="br0">(</span><span class="sy2">*</span>std<span class="sy4">::</span><span class="me2">any_cast</span><span class="sy1"><</span>U<span class="sy1">></span><span class="br0">(</span><span class="sy3">&</span>operand<span class="br0">)</span><span class="br0">)</span><span class="br0">)</span></span></span> 。</div>
|
||||
<div class="t-li1"><span class="t-li">4-5)</span> 若 <code>operand</code> 不是空指针,且请求的 <code>T</code> 的 <code>typeid</code> 匹配 <code>operand</code> 的 <code>typeid</code> ,则为指向所含值的指针,否则为空指针。</div>
|
||||
<h3><span class="mw-headline" id=".E5.BC.82.E5.B8.B8">异常</span></h3>
|
||||
<div class="t-li1"><span class="t-li">1-3)</span> 若请求的 <code>T</code> 的 <code>typeid</code> 不匹配 <code>operand</code> 内容的 <code>typeid</code> ,则抛出 <span class="t-lc"><a href="cpp-utility-any-bad_any_cast.html">std::bad_any_cast</a></span> 。</div>
|
||||
<h3><span class="mw-headline" id=".E7.A4.BA.E4.BE.8B">示例</span></h3>
|
||||
<div class="t-example">
|
||||
<div class="t-example-live-link"></div>
|
||||
<div dir="ltr" class="mw-geshi" style="text-align: left;">
|
||||
<div class="cpp source-cpp">
|
||||
<pre class="de1"><span class="co2">#include <string></span>
|
||||
<span class="co2">#include <iostream></span>
|
||||
<span class="co2">#include <any></span>
|
||||
<span class="co2">#include <utility></span>
|
||||
|
||||
<span class="kw4">int</span> main<span class="br0">(</span><span class="br0">)</span>
|
||||
<span class="br0">{</span>
|
||||
<span class="co1">// 简单示例</span>
|
||||
|
||||
<span class="kw4">auto</span> a <span class="sy1">=</span> <a href="cpp-utility-any.html"><span class="kw1071">std::<span class="me2">any</span></span></a><span class="br0">(</span><span class="nu0">12</span><span class="br0">)</span><span class="sy4">;</span>
|
||||
|
||||
<a href="cpp-io-cout.html"><span class="kw1757">std::<span class="me2">cout</span></span></a> <span class="sy1"><<</span> std<span class="sy4">::</span><span class="me2">any_cast</span><span class="sy1"><</span><span class="kw4">int</span><span class="sy1">></span><span class="br0">(</span>a<span class="br0">)</span> <span class="sy1"><<</span> <span class="st0">'<span class="es1">\n</span>'</span><span class="sy4">;</span>
|
||||
|
||||
<span class="kw1">try</span> <span class="br0">{</span>
|
||||
<a href="cpp-io-cout.html"><span class="kw1757">std::<span class="me2">cout</span></span></a> <span class="sy1"><<</span> std<span class="sy4">::</span><span class="me2">any_cast</span><span class="sy1"><</span><a href="cpp-string-basic_string.html"><span class="kw1229">std::<span class="me2">string</span></span></a><span class="sy1">></span><span class="br0">(</span>a<span class="br0">)</span> <span class="sy1"><<</span> <span class="st0">'<span class="es1">\n</span>'</span><span class="sy4">;</span>
|
||||
<span class="br0">}</span>
|
||||
<span class="kw1">catch</span><span class="br0">(</span><span class="kw4">const</span> <a href="cpp-utility-any-bad_any_cast.html"><span class="kw1073">std::<span class="me2">bad_any_cast</span></span></a><span class="sy3">&</span> e<span class="br0">)</span> <span class="br0">{</span>
|
||||
<a href="cpp-io-cout.html"><span class="kw1757">std::<span class="me2">cout</span></span></a> <span class="sy1"><<</span> e.<span class="me1">what</span><span class="br0">(</span><span class="br0">)</span> <span class="sy1"><<</span> <span class="st0">'<span class="es1">\n</span>'</span><span class="sy4">;</span>
|
||||
<span class="br0">}</span>
|
||||
|
||||
<span class="co1">// 指针示例</span>
|
||||
|
||||
<span class="kw1">if</span> <span class="br0">(</span><span class="kw4">int</span><span class="sy2">*</span> i <span class="sy1">=</span> std<span class="sy4">::</span><span class="me2">any_cast</span><span class="sy1"><</span><span class="kw4">int</span><span class="sy1">></span><span class="br0">(</span><span class="sy3">&</span>a<span class="br0">)</span><span class="br0">)</span> <span class="br0">{</span>
|
||||
<a href="cpp-io-cout.html"><span class="kw1757">std::<span class="me2">cout</span></span></a> <span class="sy1"><<</span> <span class="st0">"a is int: "</span> <span class="sy1"><<</span> <span class="sy2">*</span>i <span class="sy1"><<</span> <span class="st0">'<span class="es1">\n</span>'</span><span class="sy4">;</span>
|
||||
<span class="br0">}</span> <span class="kw1">else</span> <span class="kw1">if</span> <span class="br0">(</span><a href="cpp-string-basic_string.html"><span class="kw1229">std::<span class="me2">string</span></span></a><span class="sy2">*</span> s <span class="sy1">=</span> std<span class="sy4">::</span><span class="me2">any_cast</span><span class="sy1"><</span><a href="cpp-string-basic_string.html"><span class="kw1229">std::<span class="me2">string</span></span></a><span class="sy1">></span><span class="br0">(</span><span class="sy3">&</span>a<span class="br0">)</span><span class="br0">)</span> <span class="br0">{</span>
|
||||
<a href="cpp-io-cout.html"><span class="kw1757">std::<span class="me2">cout</span></span></a> <span class="sy1"><<</span> <span class="st0">"a is std::string: "</span> <span class="sy1"><<</span> <span class="sy2">*</span>s <span class="sy1"><<</span> <span class="st0">'<span class="es1">\n</span>'</span><span class="sy4">;</span>
|
||||
<span class="br0">}</span> <span class="kw1">else</span> <span class="br0">{</span>
|
||||
<a href="cpp-io-cout.html"><span class="kw1757">std::<span class="me2">cout</span></span></a> <span class="sy1"><<</span> <span class="st0">"a is another type or unset<span class="es1">\n</span>"</span><span class="sy4">;</span>
|
||||
<span class="br0">}</span>
|
||||
|
||||
<span class="co1">// 进阶示例</span>
|
||||
|
||||
a <span class="sy1">=</span> <a href="cpp-string-basic_string.html"><span class="kw1229">std::<span class="me2">string</span></span></a><span class="br0">(</span><span class="st0">"hello"</span><span class="br0">)</span><span class="sy4">;</span>
|
||||
|
||||
<span class="kw4">auto</span><span class="sy3">&</span> ra <span class="sy1">=</span> std<span class="sy4">::</span><span class="me2">any_cast</span><span class="sy1"><</span><a href="cpp-string-basic_string.html"><span class="kw1229">std::<span class="me2">string</span></span></a><span class="sy3">&</span><span class="sy1">></span><span class="br0">(</span>a<span class="br0">)</span><span class="sy4">;</span> <span class="co1">//< 引用</span>
|
||||
ra<span class="br0">[</span><span class="nu0">1</span><span class="br0">]</span> <span class="sy1">=</span> <span class="st0">'o'</span><span class="sy4">;</span>
|
||||
|
||||
<a href="cpp-io-cout.html"><span class="kw1757">std::<span class="me2">cout</span></span></a> <span class="sy1"><<</span> <span class="st0">"a: "</span>
|
||||
<span class="sy1"><<</span> std<span class="sy4">::</span><span class="me2">any_cast</span><span class="sy1"><</span><span class="kw4">const</span> <a href="cpp-string-basic_string.html"><span class="kw1229">std::<span class="me2">string</span></span></a><span class="sy3">&</span><span class="sy1">></span><span class="br0">(</span>a<span class="br0">)</span> <span class="sy1"><<</span> <span class="st0">'<span class="es1">\n</span>'</span><span class="sy4">;</span> <span class="co1">//< const 引用</span>
|
||||
|
||||
<span class="kw4">auto</span> b <span class="sy1">=</span> std<span class="sy4">::</span><span class="me2">any_cast</span><span class="sy1"><</span><a href="cpp-string-basic_string.html"><span class="kw1229">std::<span class="me2">string</span></span></a><span class="sy3">&&</span><span class="sy1">></span><span class="br0">(</span>std<span class="sy4">::</span><span class="me2">move</span><span class="br0">(</span>a<span class="br0">)</span><span class="br0">)</span><span class="sy4">;</span> <span class="co1">//< 右值引用</span>
|
||||
|
||||
<span class="co1">// 注意: 'b' 是移动构造的 std::string , 'a' 被置于合法但未指定的状态</span>
|
||||
|
||||
<a href="cpp-io-cout.html"><span class="kw1757">std::<span class="me2">cout</span></span></a> <span class="sy1"><<</span> <span class="st0">"a: "</span> <span class="sy1"><<</span> <span class="sy2">*</span>std<span class="sy4">::</span><span class="me2">any_cast</span><span class="sy1"><</span><a href="cpp-string-basic_string.html"><span class="kw1229">std::<span class="me2">string</span></span></a><span class="sy1">></span><span class="br0">(</span><span class="sy3">&</span>a<span class="br0">)</span> <span class="co1">//< 指针</span>
|
||||
<span class="sy1"><<</span> <span class="st0">"b: "</span> <span class="sy1"><<</span> b <span class="sy1"><<</span> <span class="st0">'<span class="es1">\n</span>'</span><span class="sy4">;</span>
|
||||
<span class="br0">}</span></pre></div>
|
||||
</div>
|
||||
<p>可能的输出:</p>
|
||||
<div dir="ltr" class="mw-geshi" style="text-align: left;">
|
||||
<div class="text source-text">
|
||||
<pre class="de1">12
|
||||
bad any_cast
|
||||
a is int: 12
|
||||
a: hollo
|
||||
a: b: hollo</pre></div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="visualClear"></div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user