failable/docs/Extensions/CustomStringConvertible.html

313 lines
19 KiB
HTML

<!DOCTYPE html>
<html lang="en">
<head>
<title>CustomStringConvertible Extension Reference</title>
<link rel="stylesheet" type="text/css" href="../css/jazzy.css" />
<link rel="stylesheet" type="text/css" href="../css/highlight.css" />
<meta charset='utf-8'>
<script src="../js/jquery.min.js" defer></script>
<script src="../js/jazzy.js" defer></script>
</head>
<body>
<a name="//apple_ref/swift/Extension/CustomStringConvertible" class="dashAnchor"></a>
<a title="CustomStringConvertible Extension Reference"></a>
<header>
<div class="content-wrapper">
<p><a href="../index.html"> Docs</a> (98% documented)</p>
</div>
</header>
<div class="content-wrapper">
<p id="breadcrumbs">
<a href="../index.html"> Reference</a>
<img id="carat" src="../img/carat.png" />
CustomStringConvertible Extension Reference
</p>
</div>
<div class="content-wrapper">
<nav class="sidebar">
<ul class="nav-groups">
<li class="nav-group-name">
<a href="../Extensions.html">Extensions</a>
<ul class="nav-group-tasks">
<li class="nav-group-task">
<a href="../Extensions/CustomStringConvertible.html">CustomStringConvertible</a>
</li>
</ul>
</li>
<li class="nav-group-name">
<a href="../Functions.html">Functions</a>
<ul class="nav-group-tasks">
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2neoiySbAA8FailableVyxq_G_ADyxq0_GtSQRz9SupportedQy_RszA2AR_A2AR0_AGQy0_AHRSr1_lF">!=(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2neoiySbAA8FailableVyxq_G_ADyxq0_GtSzRz9SupportedQy_RszA2AR_A2AR0_AGQy0_AHRSr1_lF">!=(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1roiyAA8FailableVyxAA19AppendedValidationsVyxq_q0_GGADyxq_G_ADyxq0_GtKSzRz9SupportedQy_RszA2AR_A2AR0_AKQy0_ALRSr1_lF">%(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1aoiyAA8FailableVyxAA19AppendedValidationsVyxq_q0_GGADyxq_G_ADyxq0_GtKSzRz9SupportedQy_RszA2AR_A2AR0_AKQy0_ALRSr1_lF">&amp;(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2amoiyAA8FailableVyxAA19AppendedValidationsVyxq_q0_GGADyxq_G_ADyxq0_GtKs17FixedWidthIntegerRz9SupportedQy_RszA2AR_A2AR0_ALQy0_AMRSr1_lF">&amp;*(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2apoiyAA8FailableVyxAA19AppendedValidationsVyxq_q0_GGADyxq_G_ADyxq0_GtKs17FixedWidthIntegerRz9SupportedQy_RszA2AR_A2AR0_ALQy0_AMRSr1_lF">&amp;+(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2asoiyAA8FailableVyxAA19AppendedValidationsVyxq_q0_GGADyxq_G_ADyxq0_GtKs17FixedWidthIntegerRz9SupportedQy_RszA2AR_A2AR0_ALQy0_AMRSr1_lF">&amp;-(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation3alloiyAA8FailableVyxAA19AppendedValidationsVyxq_q0_GGADyxq_G_ADyxq0_GtKs17FixedWidthIntegerRz9SupportedQy_RszA2AR_A2AR0_ALQy0_AMRSr1_lF">&amp;&lt;&lt;(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation3aggoiyAA8FailableVyxAA19AppendedValidationsVyxq_q0_GGADyxq_G_ADyxq0_GtKs17FixedWidthIntegerRz9SupportedQy_RszA2AR_A2AR0_ALQy0_AMRSr1_lF">&amp;&gt;&gt;(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1moiyAA8FailableVyxAA19AppendedValidationsVyxq_q0_GGADyxq_G_ADyxq0_GtKSFRz9SupportedQy_RszA2AR_A2AR0_AKQy0_ALRSr1_lF">*(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1moiyAA8FailableVyxAA19AppendedValidationsVyxq_q0_GGADyxq_G_ADyxq0_GtKSjRz9SupportedQy_RszA2AR_A2AR0_AKQy0_ALRSr1_lF">*(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1moiyAA8FailableVyxAA19AppendedValidationsVyxq_q0_GGADyxq_G_ADyxq0_GtKSzRz9SupportedQy_RszA2AR_A2AR0_AKQy0_ALRSr1_lF">*(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1moiyAA8FailableVyxq_GAE_xtKSjRz9SupportedQy_RszA2AR_r0_lF">*(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2meoiyyAA8FailableVyxq_Gz_ADyxq0_GtKSjRz9SupportedQy_RszA2AR_A2AR0_AGQy0_AHRSr1_lF">*=(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2meoiyyAA8FailableVyxq_Gz_xtKSjRz9SupportedQy_RszA2AR_r0_lF">*=(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1poiyAA8FailableVyxAA19AppendedValidationsVyxq_q0_GGADyxq_G_ADyxq0_GtKSFRz9SupportedQy_RszA2AR_A2AR0_AKQy0_ALRSr1_lF">+(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1poiyAA8FailableVyxAA19AppendedValidationsVyxq_q0_GGADyxq_G_ADyxq0_GtKSjRz9SupportedQy_RszA2AR_A2AR0_AKQy0_ALRSr1_lF">+(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1poiyAA8FailableVyxAA19AppendedValidationsVyxq_q0_GGADyxq_G_ADyxq0_GtKSzRz9SupportedQy_RszA2AR_A2AR0_AKQy0_ALRSr1_lF">+(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1poiyAA8FailableVyxq_GAE_xtKSjRz9SupportedQy_RszA2AR_r0_lF">+(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2peoiyyAA8FailableVyxq_Gz_ADyxq0_GtKSjRz9SupportedQy_RszA2AR_A2AR0_AGQy0_AHRSr1_lF">+=(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2peoiyyAA8FailableVyxq_Gz_xtKSjRz9SupportedQy_RszA2AR_r0_lF">+=(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1soiyAA8FailableVyxAA19AppendedValidationsVyxq_q0_GGADyxq_G_ADyxq0_GtKSFRz9SupportedQy_RszA2AR_A2AR0_AKQy0_ALRSr1_lF">-(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1soiyAA8FailableVyxAA19AppendedValidationsVyxq_q0_GGADyxq_G_ADyxq0_GtKSjRz9SupportedQy_RszA2AR_A2AR0_AKQy0_ALRSr1_lF">-(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1soiyAA8FailableVyxAA19AppendedValidationsVyxq_q0_GGADyxq_G_ADyxq0_GtKSzRz9SupportedQy_RszA2AR_A2AR0_AKQy0_ALRSr1_lF">-(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1soiyAA8FailableVyxq_GAE_xtKSjRz9SupportedQy_RszA2AR_r0_lF">-(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2seoiyyAA8FailableVyxq_Gz_ADyxq0_GtKSjRz9SupportedQy_RszA2AR_A2AR0_AGQy0_AHRSr1_lF">-=(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2seoiyyAA8FailableVyxq_Gz_xtKSjRz9SupportedQy_RszA2AR_r0_lF">-=(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/...(_:_:)">...(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation3zzloiyAA8FailableVySnyxGAA07ElementA0VyAeA19AppendedValidationsVyxq_q0_GGGADyxq_G_ADyxq0_GtKSxRz9SupportedQy_RszA2AR_A2AR0_SZ6StrideRpzAOQy0_APRSr1_lF">..&lt;(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1doiyAA8FailableVyxAA19AppendedValidationsVyxq_q0_GGADyxq_G_ADyxq0_GtKSFRz9SupportedQy_RszA2AR_A2AR0_AKQy0_ALRSr1_lF">/(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1doiyAA8FailableVyxAA19AppendedValidationsVyxq_q0_GGADyxq_G_ADyxq0_GtKSzRz9SupportedQy_RszA2AR_A2AR0_AKQy0_ALRSr1_lF">/(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1loiySbAA8FailableVyxq_G_ADyxq0_GtSFRz9SupportedQy_RszA2AR_A2AR0_AGQy0_AHRSr1_lF">&lt;(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1loiySbAA8FailableVyxq_G_ADyxq0_GtSLRz9SupportedQy_RszA2AR_A2AR0_AGQy0_AHRSr1_lF">&lt;(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2leoiySbAA8FailableVyxq_G_ADyxq0_GtSFRz9SupportedQy_RszA2AR_A2AR0_AGQy0_AHRSr1_lF">&lt;=(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2leoiySbAA8FailableVyxq_G_ADyxq0_GtSLRz9SupportedQy_RszA2AR_A2AR0_AGQy0_AHRSr1_lF">&lt;=(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2leoiySbAA8FailableVyxq_G_ADyxq0_GtSzRz9SupportedQy_RszA2AR_A2AR0_AGQy0_AHRSr1_lF">&lt;=(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2ltoiyyAA8FailableVyxq_Gz_xtK9SupportedQy_RszA2AR_r0_lF">&lt;~(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2eeoiySbAA8FailableVyxq_G_ADyxq0_GtSFRz9SupportedQy_RszA2AR_A2AR0_AGQy0_AHRSr1_lF">==(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2eeoiySbAA8FailableVyxq_G_ADyxq0_GtSQRz9SupportedQy_RszA2AR_A2AR0_AGQy0_AHRSr1_lF">==(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1goiySbAA8FailableVyxq_G_ADyxq0_GtSFRz9SupportedQy_RszA2AR_A2AR0_AGQy0_AHRSr1_lF">&gt;(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1goiySbAA8FailableVyxq_G_ADyxq0_GtSLRz9SupportedQy_RszA2AR_A2AR0_AGQy0_AHRSr1_lF">&gt;(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1goiySbAA8FailableVyxq_G_ADyxq0_GtSzRz9SupportedQy_RszA2AR_A2AR0_AGQy0_AHRSr1_lF">&gt;(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2geoiySbAA8FailableVyxq_G_ADyxq0_GtSFRz9SupportedQy_RszA2AR_A2AR0_AGQy0_AHRSr1_lF">&gt;=(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2geoiySbAA8FailableVyxq_G_ADyxq0_GtSLRz9SupportedQy_RszA2AR_A2AR0_AGQy0_AHRSr1_lF">&gt;=(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2geoiySbAA8FailableVyxq_G_ADyxq0_GtSzRz9SupportedQy_RszA2AR_A2AR0_AGQy0_AHRSr1_lF">&gt;=(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2qqoiyxAA8FailableVyxSgq_G_xyKXKtKA2AR_AE9SupportedRt_r0_lF">??(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation2qqoiyxSgAA8FailableVyACq_G_ACyKXKtKA2AR_AC9SupportedRt_r0_lF">??(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1xoiyAA8FailableVyxAA19AppendedValidationsVyxq_q0_GGADyxq_G_ADyxq0_GtKSzRz9SupportedQy_RszA2AR_A2AR0_AKQy0_ALRSr1_lF">^(_:_:)</a>
</li>
<li class="nav-group-task">
<a href="../Functions.html#/s:10Validation1ooiyAA8FailableVyxAA19AppendedValidationsVyxq_q0_GGADyxq_G_ADyxq0_GtKSzRz9SupportedQy_RszA2AR_A2AR0_AKQy0_ALRSr1_lF">|(_:_:)</a>
</li>
</ul>
</li>
<li class="nav-group-name">
<a href="../Protocols.html">Protocols</a>
<ul class="nav-group-tasks">
<li class="nav-group-task">
<a href="../Protocols/AnyValidation.html">AnyValidation</a>
</li>
<li class="nav-group-task">
<a href="../Protocols/InRangeValidation.html">InRangeValidation</a>
</li>
<li class="nav-group-task">
<a href="../Protocols/LengthValidation.html">LengthValidation</a>
</li>
<li class="nav-group-task">
<a href="../Protocols/RegexValidation.html">RegexValidation</a>
</li>
<li class="nav-group-task">
<a href="../Protocols/Validation.html">Validation</a>
</li>
</ul>
</li>
<li class="nav-group-name">
<a href="../Structs.html">Structures</a>
<ul class="nav-group-tasks">
<li class="nav-group-task">
<a href="../Structs/AppendedValidations.html">AppendedValidations</a>
</li>
<li class="nav-group-task">
<a href="../Structs/ElementValidation.html">ElementValidation</a>
</li>
<li class="nav-group-task">
<a href="../Structs/Failable.html">Failable</a>
</li>
<li class="nav-group-task">
<a href="../Structs/NotNil.html">NotNil</a>
</li>
<li class="nav-group-task">
<a href="../Structs/NotNilValidate.html">NotNilValidate</a>
</li>
<li class="nav-group-task">
<a href="../Structs/ValidationError.html">ValidationError</a>
</li>
</ul>
</li>
</ul>
</nav>
<article class="main-content">
<section>
<section class="section">
<h1>CustomStringConvertible</h1>
<div class="declaration">
<div class="language">
<pre class="highlight swift"><code><span class="kd">protocol</span> <span class="kt">CustomStringConvertible</span></code></pre>
</div>
</div>
</section>
<section class="section task-group-section">
<div class="task-group">
<ul>
<li class="item">
<div>
<code>
<a name="/s:s23CustomStringConvertibleP10ValidationE8failableyAC8FailableVyxqd__Gqd__mK9SupportedQyd__RszA2CRd__lF"></a>
<a name="//apple_ref/swift/Method/failable(_:)" class="dashAnchor"></a>
<a class="token" href="#/s:s23CustomStringConvertibleP10ValidationE8failableyAC8FailableVyxqd__Gqd__mK9SupportedQyd__RszA2CRd__lF">failable(_:)</a>
</code>
</div>
<div class="height-container">
<div class="pointer-container"></div>
<section class="section">
<div class="pointer"></div>
<div class="abstract">
<p>Easily create <code><a href="../Structs/Failable.html">Failable</a></code> versions of types conforming to <code>CustomStringConvertible</code>. This includes most, if not all, core Swift types.</p>
<p>This paramater defaults to its own type, so if the validation type can be infered, you don&rsquo;t need to pass the paramater in.</p>
<pre class="highlight swift"><code><span class="k">var</span> <span class="nv">story</span><span class="p">:</span> <span class="kt">Failable</span><span class="o">&lt;</span><span class="kt">String</span><span class="p">,</span> <span class="kt">Length1028</span><span class="o">&gt;</span> <span class="o">=</span> <span class="k">try</span> <span class="s">"Once upon a time..."</span><span class="o">.</span><span class="nf">failable</span><span class="p">()</span>
</code></pre>
</div>
<div class="declaration">
<h4>Declaration</h4>
<div class="language">
<p class="aside-title">Swift</p>
<pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">func</span> <span class="n">failable</span><span class="o">&lt;</span><span class="kt">Validations</span><span class="o">&gt;</span><span class="p">(</span><span class="n">_</span> <span class="nv">validations</span><span class="p">:</span> <span class="kt">Validations</span><span class="o">.</span><span class="k">Type</span> <span class="o">=</span> <span class="kt">Validations</span><span class="o">.</span><span class="k">self</span><span class="p">)</span><span class="k">throws</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Structs/Failable.html">Failable</a></span><span class="o">&lt;</span><span class="k">Self</span><span class="p">,</span> <span class="kt">Validations</span><span class="o">&gt;</span></code></pre>
</div>
</div>
<div>
<h4>Parameters</h4>
<table class="graybox">
<tbody>
<tr>
<td>
<code>
<em>validations</em>
</code>
</td>
<td>
<div>
<p>The validation type to use when mutating the stored value.</p>
</div>
</td>
</tr>
</tbody>
</table>
</div>
</section>
</div>
</li>
</ul>
</div>
</section>
</section>
<section id="footer">
<p>&copy; 2018 <a class="link" href="" target="_blank" rel="external"></a>. All rights reserved. (Last updated: 2018-12-10)</p>
<p>Generated by <a class="link" href="https://github.com/realm/jazzy" target="_blank" rel="external">jazzy ♪♫ v0.9.1</a>, a <a class="link" href="http://realm.io" target="_blank" rel="external">Realm</a> project.</p>
</section>
</article>
</div>
</body>
</div>
</html>