mirror of
https://github.com/Naios/continuable.git
synced 2025-12-06 08:46:44 +08:00
257 lines
30 KiB
HTML
257 lines
30 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
|
|
|
|
<meta charset="UTF-8" />
|
|
<title>Tutorial » Connecting continuables | Continuable</title>
|
|
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Source+Sans+Pro:400,400i,600,600i%7CSource+Code+Pro:400,400i,600" />
|
|
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css"/>
|
|
<link rel="stylesheet" href="m-dark+doxygen.compiled.css" />
|
|
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css"/>
|
|
<link rel="stylesheet" href="base.css" />
|
|
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css"/>
|
|
<link rel="stylesheet" href="terminal.css" />
|
|
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css"/>
|
|
<link rel="stylesheet" href="atom-one-dark.css" />
|
|
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css"/>
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
<meta name="theme-color" content="#23373B" />
|
|
</head>
|
|
<body>
|
|
<header><nav id="navigation">
|
|
<div class="m-container">
|
|
<div class="m-row">
|
|
<a href="index.html" id="m-navbar-brand" class="m-col-t-8 m-col-m-none m-left-m">Continuable <span class="m-thin">4.1.0</span></a>
|
|
<div class="m-col-t-4 m-hide-m m-text-right m-nopadr">
|
|
<a href="#search" class="m-dox-search-icon" title="Search" onclick="return showSearch()"><svg style="height: 0.9rem;" viewBox="0 0 16 16">
|
|
<path d="m6 0c-3.3144 0-6 2.6856-6 6 0 3.3144 2.6856 6 6 6 1.4858 0 2.8463-0.54083 3.8945-1.4355-0.0164 0.33797 0.14734 0.75854 0.5 1.1504l3.2227 3.7891c0.55185 0.6139 1.4517 0.66544 2.002 0.11524 0.55022-0.55022 0.49866-1.4501-0.11524-2.002l-3.7891-3.2246c-0.39184-0.35266-0.81242-0.51469-1.1504-0.5 0.89472-1.0482 1.4355-2.4088 1.4355-3.8945 0-3.3128-2.6856-5.998-6-5.998zm0 1.5625a4.4375 4.4375 0 0 1 4.4375 4.4375 4.4375 4.4375 0 0 1-4.4375 4.4375 4.4375 4.4375 0 0 1-4.4375-4.4375 4.4375 4.4375 0 0 1 4.4375-4.4375z"/>
|
|
</svg></a>
|
|
<a id="m-navbar-show" href="#navigation" title="Show navigation"></a>
|
|
<a id="m-navbar-hide" href="#" title="Hide navigation"></a>
|
|
</div>
|
|
<div id="m-navbar-collapse" class="m-col-t-12 m-show-m m-col-m-none m-right-m">
|
|
<div class="m-row">
|
|
<ol class="m-col-t-6 m-col-m-none">
|
|
<li>
|
|
<a href="tutorial.html">Tutorial</a>
|
|
<ol>
|
|
<li><a href="tutorial-creating-continuables.html">Creating continuables</a></li>
|
|
<li><a href="tutorial-chaining-continuables.html">Chaining continuables</a></li>
|
|
<li><a href="tutorial-connecting-continuables.html" id="m-navbar-current">Connecting continuables</a></li>
|
|
<li><a href="tutorial-transforming-continuables.html">Transforming continuables</a></li>
|
|
<li><a href="tutorial-awaiting-continuables.html">Awaiting continuables</a></li>
|
|
<li><a href="tutorial-promisify-continuables.html">Promisify functions</a></li>
|
|
</ol>
|
|
</li>
|
|
<li>
|
|
<a href="pages.html">Pages</a>
|
|
<ol>
|
|
<li><a href="installation.html">Installation</a></li>
|
|
<li><a href="tutorial.html">Tutorial</a></li>
|
|
<li><a href="configuration.html">Configuration</a></li>
|
|
<li><a href="changelog.html">Changelog</a></li>
|
|
</ol>
|
|
</li>
|
|
<li>
|
|
<a href="modules.html">Modules</a>
|
|
<ol>
|
|
<li><a href="group___base.html">Base</a></li>
|
|
<li><a href="group___connections.html">Connections</a></li>
|
|
<li><a href="group___promisify.html">Promisify</a></li>
|
|
<li><a href="group___testing.html">Testing</a></li>
|
|
<li><a href="group___types.html">Types</a></li>
|
|
<li><a href="group___transforms.html">Transforms</a></li>
|
|
<li><a href="group___traversal.html">Traversal</a></li>
|
|
</ol>
|
|
</li>
|
|
</ol>
|
|
<ol class="m-col-t-6 m-col-m-none" start="4">
|
|
<li>
|
|
<a href="namespacecti.html">cti</a>
|
|
<ol>
|
|
<li><a href="namespacecti_1_1transforms.html">cti::transforms</a></li>
|
|
<li><a href="classcti_1_1continuable__base.html">cti::continuable_base</a></li>
|
|
<li><a href="classcti_1_1promise__base.html">cti::promise_base</a></li>
|
|
</ol>
|
|
</li>
|
|
<li class="m-show-m"><a href="#search" class="m-dox-search-icon" title="Search" onclick="return showSearch()"><svg style="height: 0.9rem;" viewBox="0 0 16 16">
|
|
<path d="m6 0c-3.3144 0-6 2.6856-6 6 0 3.3144 2.6856 6 6 6 1.4858 0 2.8463-0.54083 3.8945-1.4355-0.0164 0.33797 0.14734 0.75854 0.5 1.1504l3.2227 3.7891c0.55185 0.6139 1.4517 0.66544 2.002 0.11524 0.55022-0.55022 0.49866-1.4501-0.11524-2.002l-3.7891-3.2246c-0.39184-0.35266-0.81242-0.51469-1.1504-0.5 0.89472-1.0482 1.4355-2.4088 1.4355-3.8945 0-3.3128-2.6856-5.998-6-5.998zm0 1.5625a4.4375 4.4375 0 0 1 4.4375 4.4375 4.4375 4.4375 0 0 1-4.4375 4.4375 4.4375 4.4375 0 0 1-4.4375-4.4375 4.4375 4.4375 0 0 1 4.4375-4.4375z"/>
|
|
</svg> Search</a></li>
|
|
</ol>
|
|
<ol class="m-col-t-6 m-col-m-none">
|
|
<li>
|
|
<a href="https://github.com/Naios/continuable" aria-label="View source on Github"><i class="fa fa-github"></i> Code</a>
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</nav></header>
|
|
<main><article>
|
|
<div class="m-container m-container-inflatable">
|
|
<div class="m-row">
|
|
<div class="m-col-l-10 m-push-l-1">
|
|
<h1>
|
|
<span class="m-breadcrumb"><a href="tutorial.html">Tutorial</a> »</span>
|
|
|
|
Connecting continuables
|
|
</h1>
|
|
|
|
<p>Explains how to connect various <a href="classcti_1_1continuable__base.html" class="m-dox">continuable_<wbr />base</a> objects together.</p>
|
|
<div class="m-block m-default">
|
|
<h3>Contents</h3>
|
|
<ul>
|
|
<li><a href="#tutorial-connecting-continuables-strategies">Connections and strategies</a></li>
|
|
<li>
|
|
<a href="#tutorial-connecting-continuables-aggregated">Using aggregated strategies</a>
|
|
<ul>
|
|
<li><a href="#tutorial-connecting-continuables-aggregated-all">Using the all connection</a></li>
|
|
<li><a href="#tutorial-connecting-continuables-aggregated-seq">Using the sequential connection</a></li>
|
|
|
|
</ul>
|
|
</li>
|
|
<li><a href="#tutorial-connecting-continuables-any">Using the any connection</a></li>
|
|
<li><a href="#tutorial-connecting-continuables-mixed">Mixing different strategies</a></li>
|
|
<li><a href="#tutorial-connecting-continuables-nested">Nested continuables and plain types</a></li>
|
|
<li><a href="#tutorial-connecting-continuables-populate">Populating a container from arbitrary continuables</a></li>
|
|
</ul>
|
|
</div>
|
|
<section id="tutorial-connecting-continuables-strategies"><h2><a href="#tutorial-connecting-continuables-strategies">Connections and strategies</a></h2><p>Connections make it possible to describe the dependencies between an arbitrary count of <a href="classcti_1_1continuable__base.html" class="m-dox">continuable_<wbr />base</a> objects in order resolve a returned <a href="classcti_1_1continuable__base.html" class="m-dox">continuable_<wbr />base</a> as soon as the dependencies are fulfilled.</p><p>For each connection strategy <a href="classcti_1_1continuable__base.html" class="m-dox">continuable_<wbr />base</a> provides an operator for for instance <a href="classcti_1_1continuable__base.html#ad5cbff40fcd03a6451eae06d310f1439" class="m-dox">continuable_base::<wbr />operator &&</a> and a free function, <a href="group___connections.html#gaef652b8561f76cad49e83cfa21a71734" class="m-dox">when_<wbr />all</a> for example. Both work similar however the free functions are capable of working with nested sequences as described in <a href="tutorial-connecting-continuables.html#tutorial-connecting-continuables-nested" class="m-dox">Nested continuables and plain types</a>.</p><aside class="m-note m-info"><h4>Note</h4><p>Connections between <a href="classcti_1_1continuable__base.html" class="m-dox">continuable_<wbr />base</a> objects are ensured to be <strong>thread-safe</strong> and <strong>wait-free</strong> by library design (when assuming that <code>std::call_once</code> is wait-free - which depends on the toolchain).</p></aside></section><section id="tutorial-connecting-continuables-aggregated"><h2><a href="#tutorial-connecting-continuables-aggregated">Using aggregated strategies</a></h2><p>Aggregated strategies will call the result handler with the compound result of all connected <a href="classcti_1_1continuable__base.html" class="m-dox">continuable_<wbr />base</a> objects.</p><p>The compound result is deduced as following. Every <a href="classcti_1_1continuable__base.html" class="m-dox">continuable_<wbr />base</a> maps its result to the result itself as shown below. When multiple <a href="classcti_1_1continuable__base.html" class="m-dox">continuable_<wbr />base</a> objects are connected on the same depth, the result is joined. See <a href="tutorial-connecting-continuables.html#tutorial-connecting-continuables-nested" class="m-dox">Nested continuables and plain types</a> for details.</p><table class="m-table"><thead><tr><th>Continuation type</th><th>In tuple like</th><th>In container (<code>std::vector</code>)</th></tr></thead><tbody><tr><td><code><a href="classcti_1_1continuable__base.html" class="m-dox">continuable_<wbr />base</a> with <></code></td><td><code><none></code></td><td><code><none></code></td></tr><tr><td><code><a href="classcti_1_1continuable__base.html" class="m-dox">continuable_<wbr />base</a> with <Arg></code></td><td><code>Arg</code></td><td><code>Arg</code></td></tr><tr><td><code><a href="classcti_1_1continuable__base.html" class="m-dox">continuable_<wbr />base</a> with <Args...></code></td><td><code>Args...</code></td><td><code>std::tuple<Args...></code></td></tr></tbody></table><section id="tutorial-connecting-continuables-aggregated-all"><h3><a href="#tutorial-connecting-continuables-aggregated-all">Using the all connection</a></h3><p>The <em>all</em> strategy invokes all connected continuable at once, it tries to resolve the connected <a href="classcti_1_1continuable__base.html" class="m-dox">continuable_<wbr />base</a> objects as fast as possible. It is possible to connect multiple <a href="classcti_1_1continuable__base.html" class="m-dox">continuable_<wbr />base</a> objects together through the <em>all</em> strategy by using <a href="classcti_1_1continuable__base.html#ad5cbff40fcd03a6451eae06d310f1439" class="m-dox">continuable_base::<wbr />operator &&</a> or <a href="group___connections.html#gaef652b8561f76cad49e83cfa21a71734" class="m-dox">when_<wbr />all</a>. In contrast to the operator the free functions are capable of workin with plain types and deeply nested <a href="classcti_1_1continuable__base.html" class="m-dox">continuable_<wbr />base</a> objects as described in <a href="tutorial-connecting-continuables.html#tutorial-connecting-continuables-nested" class="m-dox">Nested continuables and plain types</a> .</p><pre class="m-code"><span class="p">(</span><span class="n">http_request</span><span class="p">(</span><span class="s">"github.com"</span><span class="p">)</span> <span class="o">&&</span> <span class="n">http_request</span><span class="p">(</span><span class="s">"travis-ci.org"</span><span class="p">)</span> <span class="o">&&</span>
|
|
<span class="n">http_request</span><span class="p">(</span><span class="s">"atom.io"</span><span class="p">))</span>
|
|
<span class="p">.</span><span class="n">then</span><span class="p">([](</span><span class="n">std</span><span class="o">::</span><span class="n">string</span> <span class="n">github</span><span class="p">,</span> <span class="n">std</span><span class="o">::</span><span class="n">string</span> <span class="n">travis</span><span class="p">,</span>
|
|
<span class="n">std</span><span class="o">::</span><span class="n">string</span> <span class="n">atom</span><span class="p">)</span> <span class="p">{</span>
|
|
<span class="c1">// The callback is called with the</span>
|
|
<span class="c1">// response of github, travis and atom.</span>
|
|
<span class="p">});</span></pre></section><section id="tutorial-connecting-continuables-aggregated-seq"><h3><a href="#tutorial-connecting-continuables-aggregated-seq">Using the sequential connection</a></h3><p>The <em>sequential</em> strategy invokes all connected continuable one after each other, it tries to resolve the next connected <a href="classcti_1_1continuable__base.html" class="m-dox">continuable_<wbr />base</a> objects as soon as the previous one was resolved. It is possible to connect multiple <a href="classcti_1_1continuable__base.html" class="m-dox">continuable_<wbr />base</a> objects together through the <em>sequential</em> strategy by using <a href="classcti_1_1continuable__base.html#abaaaf8a35827456fead299851268760e" class="m-dox">continuable_base::<wbr />operator>></a> or <a href="group___connections.html#ga481c31024079b6074617c64b16e615dd" class="m-dox">when_<wbr />seq</a>.</p><pre class="m-code"><span class="p">(</span><span class="n">http_request</span><span class="p">(</span><span class="s">"github.com"</span><span class="p">)</span> <span class="o">>></span> <span class="n">http_request</span><span class="p">(</span><span class="s">"travis-ci.org"</span><span class="p">)</span> <span class="o">>></span>
|
|
<span class="n">http_request</span><span class="p">(</span><span class="s">"atom.io"</span><span class="p">))</span>
|
|
<span class="p">.</span><span class="n">then</span><span class="p">([](</span><span class="n">std</span><span class="o">::</span><span class="n">string</span> <span class="n">github</span><span class="p">,</span> <span class="n">std</span><span class="o">::</span><span class="n">string</span> <span class="n">travis</span><span class="p">,</span>
|
|
<span class="n">std</span><span class="o">::</span><span class="n">string</span> <span class="n">atom</span><span class="p">)</span> <span class="p">{</span>
|
|
<span class="c1">// The requests are invoked sequentially instead</span>
|
|
<span class="c1">// of requesting all at once.</span>
|
|
<span class="p">});</span></pre></section></section><section id="tutorial-connecting-continuables-any"><h2><a href="#tutorial-connecting-continuables-any">Using the any connection</a></h2><p>The any connection strategy is completely different from the two introduces before: It calls the result handler with the first result or exception available. All <a href="classcti_1_1continuable__base.html" class="m-dox">continuable_<wbr />base</a> objects are required to have the same types of arguments.</p><pre class="m-code"><span class="p">(</span><span class="n">http_request</span><span class="p">(</span><span class="s">"github.com"</span><span class="p">)</span> <span class="o">||</span> <span class="n">http_request</span><span class="p">(</span><span class="s">"travis-ci.org"</span><span class="p">)</span> <span class="o">||</span>
|
|
<span class="n">http_request</span><span class="p">(</span><span class="s">"atom.io"</span><span class="p">))</span>
|
|
<span class="p">.</span><span class="n">then</span><span class="p">([](</span><span class="n">std</span><span class="o">::</span><span class="n">string</span> <span class="n">github_or_travis_or_atom</span><span class="p">)</span> <span class="p">{</span>
|
|
<span class="c1">// The callback is called with the first response</span>
|
|
<span class="c1">// of either github, travis or atom.</span>
|
|
<span class="p">});</span></pre></section><section id="tutorial-connecting-continuables-mixed"><h2><a href="#tutorial-connecting-continuables-mixed">Mixing different strategies</a></h2><p>Mixing different strategies through operators and free functions is natively supported as shown below:</p><pre class="m-code"><span class="p">(</span><span class="n">http_request</span><span class="p">(</span><span class="s">"github.com"</span><span class="p">)</span> <span class="o">&&</span>
|
|
<span class="p">(</span><span class="n">http_request</span><span class="p">(</span><span class="s">"travis-ci.org"</span><span class="p">)</span> <span class="o">||</span> <span class="n">http_request</span><span class="p">(</span><span class="s">"atom.io"</span><span class="p">)))</span>
|
|
<span class="p">.</span><span class="n">then</span><span class="p">([](</span><span class="n">std</span><span class="o">::</span><span class="n">string</span> <span class="n">github</span><span class="p">,</span> <span class="n">std</span><span class="o">::</span><span class="n">string</span> <span class="n">travis_or_atom</span><span class="p">)</span> <span class="p">{</span>
|
|
<span class="c1">// The callback is called with the response of</span>
|
|
<span class="c1">// github for sure and the second parameter represents</span>
|
|
<span class="c1">// the response of travis or atom.</span>
|
|
<span class="p">});</span></pre></section><section id="tutorial-connecting-continuables-nested"><h2><a href="#tutorial-connecting-continuables-nested">Nested continuables and plain types</a></h2><p>For every operator that was shown above, there exists a free function that provides at least the same functionality:</p><pre class="m-code"><span class="n">cti</span><span class="o">::</span><span class="n">when_all</span><span class="p">(</span><span class="n">http_request</span><span class="p">(</span><span class="s">"github.com"</span><span class="p">),</span> <span class="n">http_request</span><span class="p">(</span><span class="s">"travis-ci.org"</span><span class="p">));</span>
|
|
<span class="n">cti</span><span class="o">::</span><span class="n">when_any</span><span class="p">(</span><span class="n">http_request</span><span class="p">(</span><span class="s">"github.com"</span><span class="p">),</span> <span class="n">http_request</span><span class="p">(</span><span class="s">"travis-ci.org"</span><span class="p">));</span>
|
|
<span class="n">cti</span><span class="o">::</span><span class="n">when_seq</span><span class="p">(</span><span class="n">http_request</span><span class="p">(</span><span class="s">"github.com"</span><span class="p">),</span> <span class="n">http_request</span><span class="p">(</span><span class="s">"travis-ci.org"</span><span class="p">));</span></pre><p>Additionally the free functions are capable of working with continuables deeply nested inside tuple like objects (<code>std::tuple</code>, <code>std::pair</code> and <code>std::array</code>) as well as homogeneous containers (<code>std::vector</code>, <code>std::list</code> etc.).</p><pre class="m-code"><span class="n">std</span><span class="o">::</span><span class="n">tuple</span><span class="o"><</span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o"><</span><span class="n">cti</span><span class="o">::</span><span class="n">continuable</span><span class="o"><</span><span class="kt">int</span><span class="o">>>></span> <span class="n">outstanding</span><span class="p">;</span>
|
|
<span class="c1">// ...</span>
|
|
|
|
<span class="n">cti</span><span class="o">::</span><span class="n">when_all</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">make_tuple</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">move</span><span class="p">(</span><span class="n">outstanding</span><span class="p">),</span>
|
|
<span class="n">http_request</span><span class="p">(</span><span class="s">"github.com"</span><span class="p">)))</span>
|
|
<span class="p">.</span><span class="n">then</span><span class="p">([](</span><span class="n">std</span><span class="o">::</span><span class="n">tuple</span><span class="o"><</span><span class="n">std</span><span class="o">::</span><span class="n">tuple</span><span class="o"><</span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o"><</span><span class="kt">int</span><span class="o">>></span><span class="p">,</span>
|
|
<span class="n">std</span><span class="o">::</span><span class="n">string</span><span class="o">></span> <span class="n">result</span><span class="p">)</span> <span class="p">{</span>
|
|
<span class="c1">// ...</span>
|
|
<span class="p">});</span></pre><p>Values which are given to such a free function are preserved and later passed to the result handler:</p><pre class="m-code"><span class="n">cti</span><span class="o">::</span><span class="n">when_seq</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span>
|
|
<span class="n">cti</span><span class="o">::</span><span class="n">make_ready_continuable</span><span class="p">(</span><span class="mi">2</span><span class="p">,</span> <span class="mi">3</span><span class="p">),</span>
|
|
<span class="mi">4</span><span class="p">,</span> <span class="mi">5</span><span class="p">)</span>
|
|
<span class="p">.</span><span class="n">then</span><span class="p">([](</span><span class="kt">int</span> <span class="n">r0</span><span class="p">,</span> <span class="kt">int</span> <span class="n">r1</span><span class="p">,</span> <span class="kt">int</span> <span class="n">r2</span><span class="p">,</span>
|
|
<span class="kt">int</span> <span class="n">r3</span><span class="p">,</span> <span class="kt">int</span> <span class="n">r4</span><span class="p">)</span> <span class="p">{</span>
|
|
<span class="c1">// ...</span>
|
|
<span class="p">});</span></pre><p>When combining both capabilities it's even possible do something like this:</p><pre class="m-code"><span class="n">cti</span><span class="o">::</span><span class="n">when_all</span><span class="p">(</span>
|
|
<span class="n">cti</span><span class="o">::</span><span class="n">make_ready_continuable</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">),</span>
|
|
<span class="mi">2</span><span class="p">,</span> <span class="c1">//< See this plain value</span>
|
|
<span class="n">cti</span><span class="o">::</span><span class="n">populate</span><span class="p">(</span><span class="n">cti</span><span class="o">::</span><span class="n">make_ready_continuable</span><span class="p">(</span><span class="mi">3</span><span class="p">),</span> <span class="c1">// Creates a runtime</span>
|
|
<span class="n">cti</span><span class="o">::</span><span class="n">make_ready_continuable</span><span class="p">(</span><span class="mi">4</span><span class="p">)),</span> <span class="c1">// sized container.</span>
|
|
<span class="n">std</span><span class="o">::</span><span class="n">make_tuple</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">make_tuple</span><span class="p">(</span><span class="n">cti</span><span class="o">::</span><span class="n">make_ready_continuable</span><span class="p">(</span><span class="mi">5</span><span class="p">))))</span>
|
|
<span class="p">.</span><span class="n">then</span><span class="p">([](</span><span class="kt">int</span> <span class="n">r0</span><span class="p">,</span> <span class="kt">int</span> <span class="n">r1</span><span class="p">,</span> <span class="kt">int</span> <span class="n">r2</span><span class="p">,</span> <span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o"><</span><span class="kt">int</span><span class="o">></span> <span class="n">r34</span><span class="p">,</span>
|
|
<span class="n">std</span><span class="o">::</span><span class="n">tuple</span><span class="o"><</span><span class="n">std</span><span class="o">::</span><span class="n">tuple</span><span class="o"><</span><span class="kt">int</span><span class="o">>></span> <span class="n">r5</span><span class="p">)</span> <span class="p">{</span>
|
|
<span class="c1">// ...</span>
|
|
<span class="p">});</span></pre></section><section id="tutorial-connecting-continuables-populate"><h2><a href="#tutorial-connecting-continuables-populate">Populating a container from arbitrary continuables</a></h2><p><a href="group___connections.html#ga4f6ecedf4b4ccd5e1c28d937ad717b32" class="m-dox">populate</a> mainly helps to create a homogeneous container from a runtime known count of continuables which type isn't exactly known. All continuables which are passed to this function should be originating from the same source or a method called with the same types of arguments:</p><pre class="m-code"><span class="c1">// cti::populate just creates a std::vector from the two continuables.</span>
|
|
<span class="k">auto</span> <span class="n">v</span> <span class="o">=</span> <span class="n">cti</span><span class="o">::</span><span class="n">populate</span><span class="p">(</span><span class="n">cti</span><span class="o">::</span><span class="n">make_ready_continuable</span><span class="p">(</span><span class="mi">0</span><span class="p">),</span>
|
|
<span class="n">cti</span><span class="o">::</span><span class="n">make_ready_continuable</span><span class="p">(</span><span class="mi">1</span><span class="p">));</span>
|
|
|
|
<span class="k">for</span> <span class="p">(</span><span class="kt">int</span> <span class="n">i</span> <span class="o">=</span> <span class="mi">2</span><span class="p">;</span> <span class="n">i</span> <span class="o"><</span> <span class="mi">5</span><span class="p">;</span> <span class="o">++</span><span class="n">i</span><span class="p">)</span> <span class="p">{</span>
|
|
<span class="c1">// It is possible to add more continuables</span>
|
|
<span class="c1">// to the container afterwards</span>
|
|
<span class="n">container</span><span class="p">.</span><span class="n">emplace_back</span><span class="p">(</span><span class="n">cti</span><span class="o">::</span><span class="n">make_ready_continuable</span><span class="p">(</span><span class="n">i</span><span class="p">));</span>
|
|
<span class="p">}</span>
|
|
|
|
<span class="n">cti</span><span class="o">::</span><span class="n">when_all</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">move</span><span class="p">(</span><span class="n">v</span><span class="p">))</span>
|
|
<span class="p">.</span><span class="n">then</span><span class="p">([](</span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o"><</span><span class="kt">int</span><span class="o">></span> <span class="n">resolved</span><span class="p">)</span> <span class="p">{</span>
|
|
<span class="c1">// ...</span>
|
|
<span class="p">});</span></pre></section>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</article></main>
|
|
<div class="m-dox-search" id="search">
|
|
<a href="#!" onclick="return hideSearch()"></a>
|
|
<div class="m-container">
|
|
<div class="m-row">
|
|
<div class="m-col-m-8 m-push-m-2">
|
|
<div class="m-dox-search-header m-text m-small">
|
|
<div><span class="m-label m-default">Tab</span> / <span class="m-label m-default">T</span> to search, <span class="m-label m-default">Esc</span> to close</div>
|
|
<div id="search-symbolcount">…</div>
|
|
</div>
|
|
<div class="m-dox-search-content">
|
|
<form>
|
|
<input type="search" name="q" id="search-input" placeholder="Loading …" disabled="disabled" autofocus="autofocus" autocomplete="off" spellcheck="false" />
|
|
</form>
|
|
<noscript class="m-text m-danger m-text-center">Unlike everything else in the docs, the search functionality <em>requires</em> JavaScript.</noscript>
|
|
<div id="search-help" class="m-text m-dim m-text-center">
|
|
<p class="m-noindent">Search for symbols, directories, files, pages or
|
|
modules. You can omit any prefix from the symbol or file path; adding a
|
|
<code>:</code> or <code>/</code> suffix lists all members of given symbol or
|
|
directory.</p>
|
|
<p class="m-noindent">Use <span class="m-label m-dim">↓</span>
|
|
/ <span class="m-label m-dim">↑</span> to navigate through the list,
|
|
<span class="m-label m-dim">Enter</span> to go.
|
|
<span class="m-label m-dim">Tab</span> autocompletes common prefix, you can
|
|
copy a link to the result using <span class="m-label m-dim">⌘</span>
|
|
<span class="m-label m-dim">L</span> while <span class="m-label m-dim">⌘</span>
|
|
<span class="m-label m-dim">M</span> produces a Markdown link.</p>
|
|
|
|
</div>
|
|
<div id="search-notfound" class="m-text m-warning m-text-center">Sorry, nothing was found.</div>
|
|
<ul id="search-results"></ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<script src="search.js"></script>
|
|
<script src="searchdata.js" async="async"></script>
|
|
<footer><nav>
|
|
<div class="m-container">
|
|
<div class="m-row">
|
|
<div class="m-col-l-10 m-push-l-1">
|
|
<b><a
|
|
href="https://github.com/Naios/continuable">continuable</a></b>
|
|
-
|
|
C++14
|
|
allocation
|
|
aware
|
|
futures</br>Copyright
|
|
2015–2020
|
|
<a
|
|
href="https://github.com/Naios">Denis
|
|
Blank</a>.
|
|
Contact
|
|
the
|
|
author
|
|
via
|
|
<a
|
|
href="mailto:denis.blank@outlook.com">e-mail</a>.</br>Powered
|
|
by
|
|
<a
|
|
href="http://doxygen.org/">Doxygen</a>
|
|
and
|
|
<a
|
|
href="http://mcss.mosra.cz/">m.css</a>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</nav></footer>
|
|
</body>
|
|
</html>
|