@ -1116,23 +1116,23 @@ pool to disconnect within the given interval.</p><p>See <a href="https://hexdocs
<sectionclass="docstring">
<p>Similar to <ahref="#insert_all/2"><codeclass="inline">insert_all/2</code></a> but with the following differences:</p><ul><li>accepts rows as streams or lists</li><li>sends rows as a chunked request</li><li>doesn't autogenerate ids or does any other preprocessing</li></ul><p>Example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="nc">Repo</span><spanclass="o">.</span><spanclass="n">query!</span><spanclass="p"data-group-id="8257444827-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="8257444827-1">)</span><spanclass="w">
<p>Similar to <ahref="#insert_all/2"><codeclass="inline">insert_all/2</code></a> but with the following differences:</p><ul><li>accepts rows as streams or lists</li><li>sends rows as a chunked request</li><li>doesn't autogenerate ids or does any other preprocessing</li></ul><p>Example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="nc">Repo</span><spanclass="o">.</span><spanclass="n">query!</span><spanclass="p"data-group-id="4957912722-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="4957912722-1">)</span><spanclass="w">
<p>Parses HTTP <codeclass="inline">Accept-Language</code> header values as defined in
<ahref="https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.4">rfc2616</a>.</p><p>The Accept-Language request-header field is similar to Accept, but restricts
the set of natural languages that are preferred as a response to the request.
Language tags function are provided in <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a>.</p><p>The format of an <codeclass="inline">Accept-Language</code> header is as follows in <codeclass="inline">ABNF</code> format:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="w"></span><spanclass="nc">Accept</span><spanclass="o">-</span><spanclass="nc">Language</span><spanclass="w"></span><spanclass="o">=</span><spanclass="w"></span><spanclass="s">"Accept-Language"</span><spanclass="w"></span><spanclass="s">":"</span><spanclass="w">
Language tags function are provided in <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a>.</p><p>The format of an <codeclass="inline">Accept-Language</code> header is as follows in <codeclass="inline">ABNF</code> format:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="w"></span><spanclass="nc">Accept</span><spanclass="o">-</span><spanclass="nc">Language</span><spanclass="w"></span><spanclass="o">=</span><spanclass="w"></span><spanclass="s">"Accept-Language"</span><spanclass="w"></span><spanclass="s">":"</span><spanclass="w">
</span><spanclass="n">language</span><spanclass="o">-</span><spanclass="n">range</span><spanclass="w"></span><spanclass="o">=</span><spanclass="w"></span><spanclass="p"data-group-id="4247351913-1">(</span><spanclass="w"></span><spanclass="p"data-group-id="4247351913-2">(</span><spanclass="w"></span><spanclass="mi">1</span><spanclass="o">*</span><spanclass="mi">8</span><spanclass="nc">ALPHA</span><spanclass="w"></span><spanclass="o">*</span><spanclass="p"data-group-id="4247351913-3">(</span><spanclass="w"></span><spanclass="s">"-"</span><spanclass="w"></span><spanclass="mi">1</span><spanclass="o">*</span><spanclass="mi">8</span><spanclass="nc">ALPHA</span><spanclass="w"></span><spanclass="p"data-group-id="4247351913-3">)</span><spanclass="w"></span><spanclass="p"data-group-id="4247351913-2">)</span><spanclass="w"></span><spanclass="o">|</span><spanclass="w"></span><spanclass="s">"*"</span><spanclass="w"></span><spanclass="p"data-group-id="4247351913-1">)</span></code></pre><p>Each language-range MAY be given an associated quality value which represents an
</span><spanclass="n">language</span><spanclass="o">-</span><spanclass="n">range</span><spanclass="w"></span><spanclass="o">=</span><spanclass="w"></span><spanclass="p"data-group-id="4497825992-1">(</span><spanclass="w"></span><spanclass="p"data-group-id="4497825992-2">(</span><spanclass="w"></span><spanclass="mi">1</span><spanclass="o">*</span><spanclass="mi">8</span><spanclass="nc">ALPHA</span><spanclass="w"></span><spanclass="o">*</span><spanclass="p"data-group-id="4497825992-3">(</span><spanclass="w"></span><spanclass="s">"-"</span><spanclass="w"></span><spanclass="mi">1</span><spanclass="o">*</span><spanclass="mi">8</span><spanclass="nc">ALPHA</span><spanclass="w"></span><spanclass="p"data-group-id="4497825992-3">)</span><spanclass="w"></span><spanclass="p"data-group-id="4497825992-2">)</span><spanclass="w"></span><spanclass="o">|</span><spanclass="w"></span><spanclass="s">"*"</span><spanclass="w"></span><spanclass="p"data-group-id="4497825992-1">)</span></code></pre><p>Each language-range MAY be given an associated quality value which represents an
estimate of the user's preference for the languages specified by that range. The
quality value defaults to "q=1". For example,</p><pre><codeclass="makeup elixir"translate="no"><spanclass="w"></span><spanclass="nc">Accept</span><spanclass="o">-</span><spanclass="ss">Language</span><spanclass="p">:</span><spanclass="w"></span><spanclass="n">da</span><spanclass="p">,</span><spanclass="w"></span><spanclass="n">en</span><spanclass="o">-</span><spanclass="n">gb</span><spanclass="p">;</span><spanclass="n">q</span><spanclass="o">=</span><spanclass="mf">0.8</span><spanclass="p">,</span><spanclass="w"></span><spanclass="n">en</span><spanclass="p">;</span><spanclass="n">q</span><spanclass="o">=</span><spanclass="mf">0.7</span></code></pre><p>would mean: "I prefer Danish, but will accept British English and other types of English."</p>
</section>
@ -145,7 +145,7 @@ quality value defaults to "q=1". For example,</p><pre><code class="mak
</div>
<divclass="summary-synopsis"><p>Parse an <codeclass="inline">Accept-Language</code> string and return the best match for
a configured <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html"><codeclass="inline">Cldr</code></a> locale.</p></div>
a configured <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html"><codeclass="inline">Cldr</code></a> locale.</p></div>
<p>Parse an <codeclass="inline">Accept-Language</code> string and return the best match for
a configured <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html"><codeclass="inline">Cldr</code></a> locale.</p><h2id="best_match/1-arguments"class="section-heading">
a configured <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html"><codeclass="inline">Cldr</code></a> locale.</p><h2id="best_match/1-arguments"class="section-heading">
</span><spanclass="s">"No configured locale could be matched to </span><spanclass="se">\"</span><spanclass="s">xx,yy;q=0.3</span><spanclass="se">\"</span><spanclass="s">"</span><spanclass="p"data-group-id="1700283417-21">}</span><spanclass="p"data-group-id="1700283417-20">}</span><spanclass="w">
</span><spanclass="s">"Expected a BCP47 language tag. Could not parse the remaining </span><spanclass="se">\"</span><spanclass="s">g</span><spanclass="se">\"</span><spanclass="s"> starting at position 11"</span><spanclass="p"data-group-id="1700283417-24">}</span><spanclass="p"data-group-id="1700283417-23">}</span></code></pre>
</span><spanclass="s">"No configured locale could be matched to </span><spanclass="se">\"</span><spanclass="s">xx,yy;q=0.3</span><spanclass="se">\"</span><spanclass="s">"</span><spanclass="p"data-group-id="0542103352-21">}</span><spanclass="p"data-group-id="0542103352-20">}</span><spanclass="w">
</span><spanclass="s">"Expected a BCP47 language tag. Could not parse the remaining </span><spanclass="se">\"</span><spanclass="s">g</span><spanclass="se">\"</span><spanclass="s"> starting at position 11"</span><spanclass="p"data-group-id="0542103352-24">}</span><spanclass="p"data-group-id="0542103352-23">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="parse/1">
@ -310,7 +310,7 @@ a configured <a href="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html"><code class="
@ -328,7 +328,7 @@ or tokenized form to return a tuple of the form
</h2>
<ul><li><p><codeclass="inline">accept-language</code> is any string in the format defined by
<ahref="https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.4">rfc2616</a></p></li><li><p><codeclass="inline">backend</code> is any module that includes <codeclass="inline">use Cldr</code> and therefore
is a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html"><codeclass="inline">Cldr</code></a> backend module</p></li></ul><h2id="parse/1-returns"class="section-heading">
is a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html"><codeclass="inline">Cldr</code></a> backend module</p></li></ul><h2id="parse/1-returns"class="section-heading">
</span><spanclass="s">"Expected a BCP47 language tag. Could not parse the remaining </span><spanclass="se">\"</span><spanclass="s">g</span><spanclass="se">\"</span><spanclass="s"> starting at position 11"</span><spanclass="p"data-group-id="6777702066-22">}</span><spanclass="p"data-group-id="6777702066-21">}</span><spanclass="w">
</span><spanclass="s">"Expected a BCP47 language tag. Could not parse the remaining </span><spanclass="se">\"</span><spanclass="s">g</span><spanclass="se">\"</span><spanclass="s"> starting at position 11"</span><spanclass="p"data-group-id="3087902714-22">}</span><spanclass="p"data-group-id="3087902714-21">}</span><spanclass="w">
</span><spanclass="s">"Expected a BCP47 language tag. Could not parse the remaining </span><spanclass="se">\"</span><spanclass="s">g</span><spanclass="se">\"</span><spanclass="s"> starting at position 11"</span><spanclass="p"data-group-id="6777702066-43">}</span><spanclass="p"data-group-id="6777702066-42">}</span><spanclass="w">
</span><spanclass="s">"Expected a BCP47 language tag. Could not parse the remaining </span><spanclass="se">\"</span><spanclass="s">g</span><spanclass="se">\"</span><spanclass="s"> starting at position 11"</span><spanclass="p"data-group-id="3087902714-43">}</span><spanclass="p"data-group-id="3087902714-42">}</span><spanclass="w">
@ -467,7 +467,7 @@ in descending order.</p><h2 id="parse!/1-arguments" class="section-heading">
</a>
Returns
</h2>
<ul><li><p><codeclass="inline">{:ok, [{quality, language_tag}, ...]}</code> or</p></li><li><p>raises a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.AcceptLanguageError.html"><codeclass="inline">Cldr.AcceptLanguageError</code></a> exception</p></li></ul><p>If at least one valid language tag is found but errors are also
<ul><li><p><codeclass="inline">{:ok, [{quality, language_tag}, ...]}</code> or</p></li><li><p>raises a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.AcceptLanguageError.html"><codeclass="inline">Cldr.AcceptLanguageError</code></a> exception</p></li></ul><p>If at least one valid language tag is found but errors are also
detected on one more more tags, an <codeclass="inline">{ok, list}</code> tuple is returned
wuth an error tuple for each invalid tag added at the end of the list.</p><h2id="parse!/1-example"class="section-heading">
</span><spanclass="gt">** (Cldr.AcceptLanguageError) "Expected a BCP47 language tag. Could not parse the remaining "g" starting at position 11
</span><spanclass="s">"Expected a BCP47 language tag. Could not parse the remaining </span><spanclass="se">\"</span><spanclass="s">g</span><spanclass="se">\"</span><spanclass="s"> starting at position 11"</span><spanclass="p"data-group-id="3261214323-38">}</span><spanclass="p"data-group-id="3261214323-37">}</span><spanclass="w">
</span><spanclass="s">"Expected a BCP47 language tag. Could not parse the remaining </span><spanclass="se">\"</span><spanclass="s">g</span><spanclass="se">\"</span><spanclass="s"> starting at position 11"</span><spanclass="p"data-group-id="9049314333-38">}</span><spanclass="p"data-group-id="9049314333-37">}</span><spanclass="w">
@ -376,7 +376,7 @@ a given locale.</p><h2 id="currencies_for_locale/3-arguments" class="section-hea
Arguments
</h2>
<ul><li><p><codeclass="inline">locale</code> is any valid locale name returned by <codeclass="inline">MyApp.Cldr.known_locale_names/0</code>
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <codeclass="inline">MyApp.Cldr.Locale.new!/1</code></p></li><li><p><codeclass="inline">currency_status</code> is <codeclass="inline">:all</code>, <codeclass="inline">:current</code>, <codeclass="inline">:historic</code>,
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <codeclass="inline">MyApp.Cldr.Locale.new!/1</code></p></li><li><p><codeclass="inline">currency_status</code> is <codeclass="inline">:all</code>, <codeclass="inline">:current</code>, <codeclass="inline">:historic</code>,
<codeclass="inline">unannotated</code> or <codeclass="inline">:tender</code>; or a list of one or more status.
The default is <codeclass="inline">:all</code>. See <ahref="https://hexdocs.pm/ex_cldr_currencies/2.15.0/Cldr.Currency.html#currency_filter/2"><codeclass="inline">Cldr.Currency.currency_filter/2</code></a>.</p></li></ul><h2id="currencies_for_locale/3-returns"class="section-heading">
@ -457,7 +457,7 @@ a given locale and raises on error.</p><h2 id="currencies_for_locale!/3-argument
Arguments
</h2>
<ul><li><p><codeclass="inline">locale</code> is any valid locale name returned by <codeclass="inline">MyApp.Cldr.known_locale_names/0</code>
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <codeclass="inline">MyApp.Cldr.Locale.new!/1</code></p></li><li><p><codeclass="inline">currency_status</code> is <codeclass="inline">:all</code>, <codeclass="inline">:current</code>, <codeclass="inline">:historic</code>,
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <codeclass="inline">MyApp.Cldr.Locale.new!/1</code></p></li><li><p><codeclass="inline">currency_status</code> is <codeclass="inline">:all</code>, <codeclass="inline">:current</code>, <codeclass="inline">:historic</code>,
<codeclass="inline">unannotated</code> or <codeclass="inline">:tender</code>; or a list of one or more status.
The default is <codeclass="inline">:all</code>. See <ahref="https://hexdocs.pm/ex_cldr_currencies/2.15.0/Cldr.Currency.html#currency_filter/2"><codeclass="inline">Cldr.Currency.currency_filter/2</code></a>.</p></li></ul><h2id="currencies_for_locale!/3-returns"class="section-heading">
@ -546,8 +546,8 @@ The default is <code class="inline">:all</code>. See <a href="https://hexdocs.pm
</a>
Options
</h2>
<ul><li><codeclass="inline">:locale</code> is any valid locale name returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.Locale.html#new!/2"><codeclass="inline">Cldr.Locale.new!/2</code></a></li></ul><h2id="currency_for_code/2-returns"class="section-heading">
<ul><li><codeclass="inline">:locale</code> is any valid locale name returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.Locale.html#new!/2"><codeclass="inline">Cldr.Locale.new!/2</code></a></li></ul><h2id="currency_for_code/2-returns"class="section-heading">
@ -635,8 +635,8 @@ or a <a href="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><code cla
</a>
Options
</h2>
<ul><li><codeclass="inline">:locale</code> is any valid locale name returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.Locale.html#new!/2"><codeclass="inline">Cldr.Locale.new!/2</code></a></li></ul><h2id="currency_for_code!/2-returns"class="section-heading">
<ul><li><codeclass="inline">:locale</code> is any valid locale name returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.Locale.html#new!/2"><codeclass="inline">Cldr.Locale.new!/2</code></a></li></ul><h2id="currency_for_code!/2-returns"class="section-heading">
@ -704,8 +704,8 @@ or a <a href="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><code cla
</a>
Arguments
</h2>
<ul><li><codeclass="inline">locale</code> is a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by
<ul><li><codeclass="inline">locale</code> is a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by
@ -763,20 +763,20 @@ currency for a given locale.</p><h2 id="currency_history_for_locale/1-arguments"
Arguments
</h2>
<ul><li><codeclass="inline">locale</code> is any valid locale name returned by <codeclass="inline">MyApp.Cldr.known_locale_names/0</code>
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <codeclass="inline">MyApp.Cldr.Locale.new!/1</code></li></ul><h2id="currency_history_for_locale/1-example"class="section-heading">
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <codeclass="inline">MyApp.Cldr.Locale.new!/1</code></li></ul><h2id="currency_history_for_locale/1-example"class="section-heading">
@ -821,7 +821,7 @@ representing a currency in a locale-specific manner.</p><h2 id="currency_strings
Arguments
</h2>
<ul><li><p><codeclass="inline">locale</code> is any valid locale name returned by <codeclass="inline">MyApp.Cldr.known_locale_names/0</code>
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <codeclass="inline">MyApp.Cldr.Locale.new!/1</code></p></li><li><p><codeclass="inline">currency_status</code> is <codeclass="inline">:all</code>, <codeclass="inline">:current</code>, <codeclass="inline">:historic</code>,
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <codeclass="inline">MyApp.Cldr.Locale.new!/1</code></p></li><li><p><codeclass="inline">currency_status</code> is <codeclass="inline">:all</code>, <codeclass="inline">:current</code>, <codeclass="inline">:historic</code>,
<codeclass="inline">unannotated</code> or <codeclass="inline">:tender</code>; or a list of one or more status.
The default is <codeclass="inline">:all</code>. See <ahref="https://hexdocs.pm/ex_cldr_currencies/2.15.0/Cldr.Currency.html#currency_filter/2"><codeclass="inline">Cldr.Currency.currency_filter/2</code></a>.</p></li></ul><h2id="currency_strings/3-returns"class="section-heading">
@ -892,7 +892,7 @@ representing a currency in a locale-specific manner.</p><h2 id="currency_strings
Arguments
</h2>
<ul><li><p><codeclass="inline">locale</code> is any valid locale name returned by <codeclass="inline">MyApp.Cldr.known_locale_names/0</code>
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <codeclass="inline">MyApp.Cldr.Locale.new!/1</code></p></li><li><p><codeclass="inline">currency_status</code> is <codeclass="inline">:all</code>, <codeclass="inline">:current</code>, <codeclass="inline">:historic</code>,
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <codeclass="inline">MyApp.Cldr.Locale.new!/1</code></p></li><li><p><codeclass="inline">currency_status</code> is <codeclass="inline">:all</code>, <codeclass="inline">:current</code>, <codeclass="inline">:historic</code>,
<codeclass="inline">unannotated</code> or <codeclass="inline">:tender</code>; or a list of one or more status.
The default is <codeclass="inline">:all</code>. See <ahref="https://hexdocs.pm/ex_cldr_currencies/2.15.0/Cldr.Currency.html#currency_filter/2"><codeclass="inline">Cldr.Currency.currency_filter/2</code></a>.</p></li></ul><h2id="currency_strings!/3-returns"class="section-heading">
<ul><li><codeclass="inline">locale</code> is any valid locale name returned by <codeclass="inline">MyApp.Cldr.known_locale_names/0</code>
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <codeclass="inline">MyApp.Cldr.Locale.new!/1</code></li></ul><h2id="current_currency_from_locale/1-example"class="section-heading">
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <codeclass="inline">MyApp.Cldr.Locale.new!/1</code></li></ul><h2id="current_currency_from_locale/1-example"class="section-heading">
</span><spanclass="p"data-group-id="5947382235-2">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="5947382235-3">{</span><spanclass="nc">Cldr.UnknownCurrencyError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The currency </span><spanclass="se">\"</span><spanclass="s">GGG</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="5947382235-3">}</span><spanclass="p"data-group-id="5947382235-2">}</span></code></pre>
</span><spanclass="p"data-group-id="3695114458-2">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="3695114458-3">{</span><spanclass="nc">Cldr.UnknownCurrencyError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The currency </span><spanclass="se">\"</span><spanclass="s">GGG</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="3695114458-3">}</span><spanclass="p"data-group-id="3695114458-2">}</span></code></pre>
</span><spanclass="p"data-group-id="7890919763-6">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"Required options are missing. Required options are [:name, :digits]"</span><spanclass="p"data-group-id="7890919763-6">}</span><spanclass="w">
</span><spanclass="p"data-group-id="7890919763-8">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="7890919763-9">{</span><spanclass="nc">Cldr.CurrencyAlreadyDefined</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"Currency :XAE is already defined."</span><spanclass="p"data-group-id="7890919763-9">}</span><spanclass="p"data-group-id="7890919763-8">}</span></code></pre>
</span><spanclass="p"data-group-id="4481430544-6">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"Required options are missing. Required options are [:name, :digits]"</span><spanclass="p"data-group-id="4481430544-6">}</span><spanclass="w">
</span><spanclass="p"data-group-id="4481430544-8">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="4481430544-9">{</span><spanclass="nc">Cldr.CurrencyAlreadyDefined</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"Currency :XAE is already defined."</span><spanclass="p"data-group-id="4481430544-9">}</span><spanclass="p"data-group-id="4481430544-8">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="pluralize/3">
@ -1315,7 +1315,7 @@ on the plural rules in effect for the <code class="inline">locale</code>.</p><h2
Options
</h2>
<ul><li><codeclass="inline">locale</code> is any valid locale name returned by <codeclass="inline">MyApp.Cldr.known_locale_names/0</code>
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <codeclass="inline">MyApp.Cldr.Locale.new!/1</code>. The
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <codeclass="inline">MyApp.Cldr.Locale.new!/1</code>. The
default is <ahref="Plausible.Cldr.html#get_locale/0"><codeclass="inline">Plausible.Cldr.get_locale/0</code></a></li></ul><h2id="pluralize/3-returns"class="section-heading">
</span><spanclass="p"data-group-id="4271459082-4">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"dollars des États-Unis"</span><spanclass="p"data-group-id="4271459082-4">}</span><spanclass="w">
</span><spanclass="p"data-group-id="0804078241-4">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"dollars des États-Unis"</span><spanclass="p"data-group-id="0804078241-4">}</span><spanclass="w">
</span><spanclass="p"data-group-id="4271459082-5">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"dollar des États-Unis"</span><spanclass="p"data-group-id="4271459082-5">}</span></code></pre>
</span><spanclass="p"data-group-id="0804078241-5">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"dollar des États-Unis"</span><spanclass="p"data-group-id="0804078241-5">}</span></code></pre>
@ -1371,7 +1371,7 @@ in a given locale.</p><h2 id="strings_for_currency/2-arguments" class="section-h
Arguments
</h2>
<ul><li><p><codeclass="inline">currency</code> is an ISO4217 currency code</p></li><li><p><codeclass="inline">locale</code> is any valid locale name returned by <codeclass="inline">MyApp.Cldr.known_locale_names/0</code>
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <codeclass="inline">MyApp.Cldr.Locale.new!/1</code></p></li></ul><h2id="strings_for_currency/2-returns"class="section-heading">
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <codeclass="inline">MyApp.Cldr.Locale.new!/1</code></p></li></ul><h2id="strings_for_currency/2-returns"class="section-heading">
@ -291,16 +299,16 @@ are added to the chain.</p><h2 id="fallback_locale_names/1-arguments" class="sec
</a>
Examples
</h2>
<p>In these examples the default locale is <codeclass="inline">:"en-001"</code>.</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Locale</span><spanclass="o">.</span><spanclass="n">fallback_locale_names</span><spanclass="p"data-group-id="6452638439-1">(</span><spanclass="ss">:"fr-CA"</span><spanclass="p"data-group-id="6452638439-1">)</span><spanclass="w">
@ -356,20 +362,20 @@ are added to the chain.</p><h2 id="fallback_locales/1-arguments" class="section-
</a>
Examples
</h2>
<p>In these examples the default locale is <codeclass="inline">:"en-001"</code>.</p><pre><codeclass="makeup elixir"translate="no"><spanclass="nc">Plausible.Cldr.Locale</span><spanclass="o">.</span><spanclass="n">fallback_locales</span><spanclass="p"data-group-id="5345149310-1">(</span><spanclass="ss">:"fr-CA"</span><spanclass="p"data-group-id="5345149310-1">)</span><spanclass="w">
@ -413,7 +419,7 @@ is validated and if that fails, "en" is validated.</p><h2 id="locale_f
Arguments
</h2>
<ul><li><codeclass="inline">territory</code> is any ISO 3166 Alpha-2 territory
code that can be validated by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#validate_territory/1"><codeclass="inline">Cldr.validate_territory/1</code></a></li></ul><h2id="locale_for_territory/1-returns"class="section-heading">
code that can be validated by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#validate_territory/1"><codeclass="inline">Cldr.validate_territory/1</code></a></li></ul><h2id="locale_for_territory/1-returns"class="section-heading">
@ -476,7 +482,7 @@ is <code class="inline">[]</code>.</p></li></ul><h2 id="locale_from_host/2-optio
</h2>
<ul><li><codeclass="inline">:tlds</code> is a list of territory codes as upper-cased
atoms that are to be considered as top-level domains.
See <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.Locale.html#locale_from_host/2"><codeclass="inline">Cldr.Locale.locale_from_host/2</code></a> for the default
See <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.Locale.html#locale_from_host/2"><codeclass="inline">Cldr.Locale.locale_from_host/2</code></a> for the default
</span><spanclass="p"data-group-id="5715553352-4">{</span><spanclass="nc">Cldr.UnknownLocaleError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"No locale was identified for territory </span><spanclass="se">\"</span><spanclass="s">tv</span><spanclass="se">\"</span><spanclass="s">"</span><spanclass="p"data-group-id="5715553352-4">}</span><spanclass="p"data-group-id="5715553352-3">}</span><spanclass="w">
</span><spanclass="p"data-group-id="8229184312-4">{</span><spanclass="nc">Cldr.UnknownLocaleError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"No locale was identified for territory </span><spanclass="se">\"</span><spanclass="s">tv</span><spanclass="se">\"</span><spanclass="s">"</span><spanclass="p"data-group-id="8229184312-4">}</span><spanclass="p"data-group-id="8229184312-3">}</span><spanclass="w">
</span><spanclass="p"data-group-id="5715553352-7">{</span><spanclass="nc">Cldr.UnknownLocaleError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"No locale was identified for territory </span><spanclass="se">\"</span><spanclass="s">com</span><spanclass="se">\"</span><spanclass="s">"</span><spanclass="p"data-group-id="5715553352-7">}</span><spanclass="p"data-group-id="5715553352-6">}</span></code></pre>
</span><spanclass="p"data-group-id="8229184312-7">{</span><spanclass="nc">Cldr.UnknownLocaleError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"No locale was identified for territory </span><spanclass="se">\"</span><spanclass="s">com</span><spanclass="se">\"</span><spanclass="s">"</span><spanclass="p"data-group-id="8229184312-7">}</span><spanclass="p"data-group-id="8229184312-6">}</span></code></pre>
<ul><li><codeclass="inline">language_tag</code> is any language tag returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.Locale.html#new/2"><codeclass="inline">Cldr.Locale.new/2</code></a>
or any <codeclass="inline">locale_name</code> returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>.</li></ul><h2id="script_direction_from_locale/1-returns"class="section-heading">
</span><spanclass="p"data-group-id="0797739893-5">{</span><spanclass="nc">Cldr.UnknownLocaleError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"No locale was identified for territory </span><spanclass="se">\"</span><spanclass="s">com</span><spanclass="se">\"</span><spanclass="s">"</span><spanclass="p"data-group-id="0797739893-5">}</span><spanclass="p"data-group-id="0797739893-4">}</span></code></pre>
</span><spanclass="p"data-group-id="6771187542-5">{</span><spanclass="nc">Cldr.UnknownLocaleError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"No locale was identified for territory </span><spanclass="se">\"</span><spanclass="s">com</span><spanclass="se">\"</span><spanclass="s">"</span><spanclass="p"data-group-id="6771187542-5">}</span><spanclass="p"data-group-id="6771187542-4">}</span></code></pre>
<p>The configured locales for which plural rules are defined.</p><p>Returns the intersection of <ahref="Plausible.Cldr.html#known_locale_names/0"><codeclass="inline">Plausible.Cldr.known_locale_names/0</code></a> and
the locales for which Cardinal plural rules are defined.</p><p>There are many <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html"><codeclass="inline">Cldr</code></a> locales which don't have their own plural
rules so this list is the intersection of <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html"><codeclass="inline">Cldr</code></a>'s configured
the locales for which Cardinal plural rules are defined.</p><p>There are many <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html"><codeclass="inline">Cldr</code></a> locales which don't have their own plural
rules so this list is the intersection of <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html"><codeclass="inline">Cldr</code></a>'s configured
locales and those that have rules.</p>
</section>
</section>
@ -283,10 +283,10 @@ locales and those that have rules.</p>
@ -302,7 +302,7 @@ list or other content in a plural-sensitive way.</p><h2 id="plural_rule/3-argume
</a>
Arguments
</h2>
<ul><li><p><codeclass="inline">number</code> is any <codeclass="inline">integer</code>, <codeclass="inline">float</code> or <ahref="https://hexdocs.pm/decimal/2.1.1/Decimal.html"><codeclass="inline">Decimal</code></a></p></li><li><p><codeclass="inline">locale</code> is any locale returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.Locale.html#new!/2"><codeclass="inline">Cldr.Locale.new!/2</code></a> or any
<ul><li><p><codeclass="inline">number</code> is any <codeclass="inline">integer</code>, <codeclass="inline">float</code> or <ahref="https://hexdocs.pm/decimal/2.1.1/Decimal.html"><codeclass="inline">Decimal</code></a></p></li><li><p><codeclass="inline">locale</code> is any locale returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.Locale.html#new!/2"><codeclass="inline">Cldr.Locale.new!/2</code></a> or any
<codeclass="inline">locale_name</code> returned by <ahref="Plausible.Cldr.html#known_locale_names/0"><codeclass="inline">Plausible.Cldr.known_locale_names/0</code></a></p></li><li><p><codeclass="inline">rounding</code> is one of <codeclass="inline">[:down, :up, :ceiling, :floor, :half_even, :half_up, :half_down]</code>. The
default is <codeclass="inline">:half_even</code>.</p></li></ul><h2id="plural_rule/3-examples"class="section-heading">
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by
<ahref="Plausible.Cldr.Locale.html#new!/1"><codeclass="inline">Plausible.Cldr.Locale.new!/1</code></a>. The default
is <ahref="Plausible.Cldr.html#get_locale/0"><codeclass="inline">Plausible.Cldr.get_locale/0</code></a>.</li></ul><h2id="all_formats_for/1-returns"class="section-heading">
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by
<ahref="Plausible.Cldr.Locale.html#new!/1"><codeclass="inline">Plausible.Cldr.Locale.new!/1</code></a>. The default
is <ahref="Plausible.Cldr.html#get_locale/0"><codeclass="inline">Plausible.Cldr.get_locale/0</code></a>.</li></ul><h2id="all_formats_for!/1-returns"class="section-heading">
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by
<ahref="Plausible.Cldr.Locale.html#new!/1"><codeclass="inline">Plausible.Cldr.Locale.new!/1</code></a>. The default
is <ahref="Plausible.Cldr.html#get_locale/0"><codeclass="inline">Plausible.Cldr.get_locale/0</code></a>.</li></ul><p>This function exists to allow the decimal formatter to precompile all
the known formats at compile time. Its use is not otherwise recommended.</p><h2id="decimal_format_list_for/1-example"class="section-heading">
@ -499,8 +499,8 @@ the known formats at compile time. Its use is not otherwise recommended.</p><h2
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by
<ahref="Plausible.Cldr.Locale.html#new!/1"><codeclass="inline">Plausible.Cldr.Locale.new!/1</code></a>. The default
is <ahref="Plausible.Cldr.html#get_locale/0"><codeclass="inline">Plausible.Cldr.get_locale/0</code></a>.</li></ul><h2id="default_grouping_for/1-returns"class="section-heading">
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by
<ahref="Plausible.Cldr.Locale.html#new!/1"><codeclass="inline">Plausible.Cldr.Locale.new!/1</code></a>. The default
is <ahref="Plausible.Cldr.html#get_locale/0"><codeclass="inline">Plausible.Cldr.get_locale/0</code></a>.</li></ul><h2id="default_grouping_for!/1-returns"class="section-heading">
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by
<ahref="Plausible.Cldr.Locale.html#new!/1"><codeclass="inline">Plausible.Cldr.Locale.new!/1</code></a>. The default
is <ahref="Plausible.Cldr.html#get_locale/0"><codeclass="inline">Plausible.Cldr.get_locale/0</code></a>.</p></li><li><p><codeclass="inline">number_system</code> is any valid number system or number system type returned
by <ahref="Plausible.Cldr.Number.System.html#number_systems_for/1"><codeclass="inline">Plausible.Cldr.Number.System.number_systems_for/1</code></a>.</p></li></ul><h2id="formats_for/2-example"class="section-heading">
@ -672,18 +672,18 @@ by <a href="Plausible.Cldr.Number.System.html#number_systems_for/1"><code class=
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by
<ahref="Plausible.Cldr.Locale.html#new!/1"><codeclass="inline">Plausible.Cldr.Locale.new!/1</code></a>. The default
is <ahref="Plausible.Cldr.html#get_locale/0"><codeclass="inline">Plausible.Cldr.get_locale/0</code></a>.</li></ul><h2id="minimum_grouping_digits_for/1-returns"class="section-heading">
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by
<ahref="Plausible.Cldr.Locale.html#new!/1"><codeclass="inline">Plausible.Cldr.Locale.new!/1</code></a>. The default
is <ahref="Plausible.Cldr.html#get_locale/0"><codeclass="inline">Plausible.Cldr.get_locale/0</code></a>.</li></ul><h2id="minimum_grouping_digits_for!/1-returns"class="section-heading">
<p>The configured locales for which plural rules are defined.</p><p>Returns the intersection of <ahref="Plausible.Cldr.html#known_locale_names/0"><codeclass="inline">Plausible.Cldr.known_locale_names/0</code></a> and
the locales for which Ordinal plural rules are defined.</p><p>There are many <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html"><codeclass="inline">Cldr</code></a> locales which don't have their own plural
rules so this list is the intersection of <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html"><codeclass="inline">Cldr</code></a>'s configured
the locales for which Ordinal plural rules are defined.</p><p>There are many <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html"><codeclass="inline">Cldr</code></a> locales which don't have their own plural
rules so this list is the intersection of <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html"><codeclass="inline">Cldr</code></a>'s configured
locales and those that have rules.</p>
</section>
</section>
@ -283,10 +283,10 @@ locales and those that have rules.</p>
@ -302,7 +302,7 @@ list or other content in a plural-sensitive way.</p><h2 id="plural_rule/3-argume
</a>
Arguments
</h2>
<ul><li><p><codeclass="inline">number</code> is any <codeclass="inline">integer</code>, <codeclass="inline">float</code> or <ahref="https://hexdocs.pm/decimal/2.1.1/Decimal.html"><codeclass="inline">Decimal</code></a></p></li><li><p><codeclass="inline">locale</code> is any locale returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.Locale.html#new!/2"><codeclass="inline">Cldr.Locale.new!/2</code></a> or any
<ul><li><p><codeclass="inline">number</code> is any <codeclass="inline">integer</code>, <codeclass="inline">float</code> or <ahref="https://hexdocs.pm/decimal/2.1.1/Decimal.html"><codeclass="inline">Decimal</code></a></p></li><li><p><codeclass="inline">locale</code> is any locale returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.Locale.html#new!/2"><codeclass="inline">Cldr.Locale.new!/2</code></a> or any
<codeclass="inline">locale_name</code> returned by <ahref="Plausible.Cldr.html#known_locale_names/0"><codeclass="inline">Plausible.Cldr.known_locale_names/0</code></a></p></li><li><p><codeclass="inline">rounding</code> is one of <codeclass="inline">[:down, :up, :ceiling, :floor, :half_even, :half_up, :half_down]</code>. The
default is <codeclass="inline">:half_even</code>.</p></li></ul><h2id="plural_rule/3-examples"class="section-heading">
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by
<ahref="Plausible.Cldr.Locale.html#new!/1"><codeclass="inline">Plausible.Cldr.Locale.new!/1</code></a>. The default
is <ahref="Plausible.Cldr.html#get_locale/0"><codeclass="inline">Plausible.Cldr.get_locale/0</code></a>.</li></ul><h2id="number_symbols_for/1-example"class="section-heading">
<p>Returns the actual number system from a number system type.</p><ul><li><p><codeclass="inline">locale</code> is any valid locale name returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#known_locale_names/0"><codeclass="inline">Cldr.known_locale_names/0</code></a>
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.Locale.html#new!/2"><codeclass="inline">Cldr.Locale.new!/2</code></a></p></li><li><p><codeclass="inline">system_name</code> is any number system name returned by
<ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#known_number_systems/0"><codeclass="inline">Cldr.known_number_systems/0</code></a> or a number system type
returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#known_number_system_types/0"><codeclass="inline">Cldr.known_number_system_types/0</code></a></p></li></ul><p>This function will decode a number system type into the actual
<p>Returns the actual number system from a number system type.</p><ul><li><p><codeclass="inline">locale</code> is any valid locale name returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_locale_names/0"><codeclass="inline">Cldr.known_locale_names/0</code></a>
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.Locale.html#new!/2"><codeclass="inline">Cldr.Locale.new!/2</code></a></p></li><li><p><codeclass="inline">system_name</code> is any number system name returned by
<ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_number_systems/0"><codeclass="inline">Cldr.known_number_systems/0</code></a> or a number system type
returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_number_system_types/0"><codeclass="inline">Cldr.known_number_system_types/0</code></a></p></li></ul><p>This function will decode a number system type into the actual
number system. If the number system provided can't be decoded
it is returned as is.</p><h2id="number_system_for/2-examples"class="section-heading">
</span><spanclass="s">"The number system :finance is unknown for the locale named :en. Valid number systems are %{default: :latn, native: :latn}"</span><spanclass="p"data-group-id="2526503681-10">}</span><spanclass="w">
</span><spanclass="s">"The number system :finance is unknown for the locale named :en. Valid number systems are %{default: :latn, native: :latn}"</span><spanclass="p"data-group-id="6509027285-10">}</span><spanclass="w">
<ul><li><codeclass="inline">locale</code> is any language tag returned be <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.Locale.html#new/2"><codeclass="inline">Cldr.Locale.new/2</code></a>
or a locale name in the list returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a></li></ul><h2id="number_system_from_locale/1-returns"class="section-heading">
<ul><li><codeclass="inline">locale</code> is any language tag returned be <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.Locale.html#new/2"><codeclass="inline">Cldr.Locale.new/2</code></a>
or a locale name in the list returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a></li></ul><h2id="number_system_from_locale/1-returns"class="section-heading">
<p>Returns the number systems available for a locale
or <codeclass="inline">{:error, message}</code> if the locale is not known.</p><ul><li><codeclass="inline">locale</code> is any valid locale name returned by <ahref="Plausible.Cldr.html#known_locale_names/0"><codeclass="inline">Plausible.Cldr.known_locale_names/0</code></a>
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="Plausible.Cldr.Locale.html#new!/1"><codeclass="inline">Plausible.Cldr.Locale.new!/1</code></a></li></ul><h2id="number_system_names_for/1-examples"class="section-heading">
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="Plausible.Cldr.Locale.html#new!/1"><codeclass="inline">Plausible.Cldr.Locale.new!/1</code></a></li></ul><h2id="number_system_names_for/1-examples"class="section-heading">
</span><spanclass="p"data-group-id="4082688359-3">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="4082688359-4">{</span><spanclass="nc">Cldr.InvalidLanguageError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The language </span><spanclass="se">\"</span><spanclass="s">zz</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="4082688359-4">}</span><spanclass="p"data-group-id="4082688359-3">}</span></code></pre>
</span><spanclass="p"data-group-id="0465948966-3">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="0465948966-4">{</span><spanclass="nc">Cldr.InvalidLanguageError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The language </span><spanclass="se">\"</span><spanclass="s">zz</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="0465948966-4">}</span><spanclass="p"data-group-id="0465948966-3">}</span></code></pre>
<p>Returns the number systems available for a locale
or <codeclass="inline">{:error, message}</code> if the locale is not known.</p><ul><li><codeclass="inline">locale</code> is any valid locale name returned by <ahref="Plausible.Cldr.html#known_locale_names/0"><codeclass="inline">Plausible.Cldr.known_locale_names/0</code></a>
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="Plausible.Cldr.Locale.html#new!/1"><codeclass="inline">Plausible.Cldr.Locale.new!/1</code></a></li></ul><h2id="number_systems_for/1-examples"class="section-heading">
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="Plausible.Cldr.Locale.html#new!/1"><codeclass="inline">Plausible.Cldr.Locale.new!/1</code></a></li></ul><h2id="number_systems_for/1-examples"class="section-heading">
</span><spanclass="p"data-group-id="4401604037-5">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="4401604037-6">{</span><spanclass="nc">Cldr.InvalidLanguageError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The language </span><spanclass="se">\"</span><spanclass="s">zz</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="4401604037-6">}</span><spanclass="p"data-group-id="4401604037-5">}</span></code></pre>
</span><spanclass="p"data-group-id="6899095368-5">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="6899095368-6">{</span><spanclass="nc">Cldr.InvalidLanguageError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The language </span><spanclass="se">\"</span><spanclass="s">zz</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="6899095368-6">}</span><spanclass="p"data-group-id="6899095368-5">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="number_systems_for!/1">
@ -535,8 +535,8 @@ or a <a href="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><code cla
@ -576,7 +576,7 @@ or a <a href="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><code cla
<p>Returns a number system name for a given locale and number system reference.</p><ul><li><p><codeclass="inline">system_name</code> is any number system name returned by
<ahref="Plausible.Cldr.html#known_number_systems/0"><codeclass="inline">Plausible.Cldr.known_number_systems/0</code></a> or a number system type
returned by <ahref="Plausible.Cldr.html#known_number_system_types/0"><codeclass="inline">Plausible.Cldr.known_number_system_types/0</code></a></p></li><li><p><codeclass="inline">locale</code> is any valid locale name returned by <ahref="Plausible.Cldr.html#known_locale_names/0"><codeclass="inline">Plausible.Cldr.known_locale_names/0</code></a>
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="Plausible.Cldr.Locale.html#new!/1"><codeclass="inline">Plausible.Cldr.Locale.new!/1</code></a></p></li></ul><p>Number systems can be references in one of two ways:</p><ul><li><p>As a number system type such as :default, :native, :traditional and
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="Plausible.Cldr.Locale.html#new!/1"><codeclass="inline">Plausible.Cldr.Locale.new!/1</code></a></p></li></ul><p>Number systems can be references in one of two ways:</p><ul><li><p>As a number system type such as :default, :native, :traditional and
:finance. This allows references to a number system for a locale in a
consistent fashion for a given use</p></li><li><p>WIth the number system name directly, such as :latn, :arab or any of the
other 70 or so</p></li></ul><p>This function dereferences the supplied <codeclass="inline">system_name</code> and returns the
@ -586,20 +586,20 @@ actual system name.</p><h2 id="system_name_from/2-examples" class="section-headi
</span><spanclass="p"data-group-id="9646531626-9">{</span><spanclass="nc">Cldr.UnknownNumberSystemError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The number system :nope is unknown"</span><spanclass="p"data-group-id="9646531626-9">}</span><spanclass="w">
</span><spanclass="p"data-group-id="9646531626-8">}</span></code></pre><p>Note that return value is not guaranteed to be a valid
</span><spanclass="p"data-group-id="9682946431-9">{</span><spanclass="nc">Cldr.UnknownNumberSystemError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The number system :nope is unknown"</span><spanclass="p"data-group-id="9682946431-9">}</span><spanclass="w">
</span><spanclass="p"data-group-id="9682946431-8">}</span></code></pre><p>Note that return value is not guaranteed to be a valid
number system for the given locale as demonstrated in the third example.</p>
</section>
</section>
@ -626,16 +626,16 @@ number system for the given locale as demonstrated in the third example.</p>
a non-latin number system.</p><p>This function converts numbers to a known
number system only, it does not provide number
formatting.</p><ul><li><p><codeclass="inline">number</code> is a <codeclass="inline">float</code>, <codeclass="inline">integer</code> or <ahref="https://hexdocs.pm/decimal/2.1.1/Decimal.html"><codeclass="inline">Decimal</code></a></p></li><li><p><codeclass="inline">system_name</code> is any number system name returned by
<ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#known_number_systems/0"><codeclass="inline">Cldr.known_number_systems/0</code></a> or a number system type
returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#known_number_system_types/0"><codeclass="inline">Cldr.known_number_system_types/0</code></a></p></li></ul><p>There are two types of number systems in CLDR:</p><ul><li><p><codeclass="inline">:numeric</code> in which the number system defines
<ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_number_systems/0"><codeclass="inline">Cldr.known_number_systems/0</code></a> or a number system type
returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_number_system_types/0"><codeclass="inline">Cldr.known_number_system_types/0</code></a></p></li></ul><p>There are two types of number systems in CLDR:</p><ul><li><p><codeclass="inline">:numeric</code> in which the number system defines
a direct mapping between the latin digits <codeclass="inline">0..9</code>
into a the number system equivalent. In this case,
@ -128,18 +128,18 @@ fast than when formal transliteration is required.</p><h3 id="module-configuring
</a>
Configuring precompilation of digit transliterations
</h3>
<p>This module includes <ahref="https://hexdocs.pm/ex_cldr_numbers/2.30.1/Cldr.Number.Transliterate.html#transliterate_digits/3"><codeclass="inline">Cldr.Number.Transliterate.transliterate_digits/3</code></a> which transliterates
<p>This module includes <ahref="https://hexdocs.pm/ex_cldr_numbers/2.31.3/Cldr.Number.Transliterate.html#transliterate_digits/3"><codeclass="inline">Cldr.Number.Transliterate.transliterate_digits/3</code></a> which transliterates
digits between number systems. For example from :arabic to :latn. Since generating a
transliteration map is slow, pairs of transliterations can be configured so that the
transliteration map is created at compile time and therefore speeding up transliteration at
run time.</p><p>To configure these transliteration pairs, add the to the <codeclass="inline">use Cldr</code> configuration
in a backend module:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="kd">defmodule</span><spanclass="w"></span><spanclass="nc">MyApp.Cldr</span><spanclass="w"></span><spanclass="k"data-group-id="6515634579-1">do</span><spanclass="w">
in a backend module:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="kd">defmodule</span><spanclass="w"></span><spanclass="nc">MyApp.Cldr</span><spanclass="w"></span><spanclass="k"data-group-id="7464712177-1">do</span><spanclass="w">
</span><spanclass="k"data-group-id="6515634579-1">end</span></code></pre><p>Where each tuple in the list configures one transliteration map. In this example, two maps are
configured: from <codeclass="inline">:latn</code> to <codeclass="inline">:thai</code> and from <codeclass="inline">:arab</code> to <codeclass="inline">:thai</code>.</p><p>A list of configurable number systems is returned by <ahref="https://hexdocs.pm/ex_cldr_numbers/2.30.1/Cldr.Number.System.html#systems_with_digits/0"><codeclass="inline">Cldr.Number.System.systems_with_digits/0</code></a>.</p><p>If a transliteration is requested between two number pairs that have not been configured for
</span><spanclass="k"data-group-id="7464712177-1">end</span></code></pre><p>Where each tuple in the list configures one transliteration map. In this example, two maps are
configured: from <codeclass="inline">:latn</code> to <codeclass="inline">:thai</code> and from <codeclass="inline">:arab</code> to <codeclass="inline">:thai</code>.</p><p>A list of configurable number systems is returned by <ahref="https://hexdocs.pm/ex_cldr_numbers/2.31.3/Cldr.Number.System.html#systems_with_digits/0"><codeclass="inline">Cldr.Number.System.systems_with_digits/0</code></a>.</p><p>If a transliteration is requested between two number pairs that have not been configured for
@ -246,7 +246,7 @@ is the actual name of a known number system. If epressed as an <code class="inli
used as a key to look up a number system for the locale (the usual keys are
<codeclass="inline">:default</code> and <codeclass="inline">:native</code> but :traditional and :finance are also part of the
standard). See <ahref="Plausible.Cldr.Number.System.html#number_systems_for/1"><codeclass="inline">Plausible.Cldr.Number.System.number_systems_for/1</code></a> for a locale to
see what number system types are defined. The default is <codeclass="inline">:default</code>.</p></li></ul><p>For available number systems see <ahref="https://hexdocs.pm/ex_cldr_numbers/2.30.1/Cldr.Number.System.html#number_systems/0"><codeclass="inline">Cldr.Number.System.number_systems/0</code></a>
see what number system types are defined. The default is <codeclass="inline">:default</code>.</p></li></ul><p>For available number systems see <ahref="https://hexdocs.pm/ex_cldr_numbers/2.31.3/Cldr.Number.System.html#number_systems/0"><codeclass="inline">Cldr.Number.System.number_systems/0</code></a>
and <ahref="Plausible.Cldr.Number.System.html#number_systems_for/1"><codeclass="inline">Plausible.Cldr.Number.System.number_systems_for/1</code></a>. Also see
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number.Transliterate</span><spanclass="o">.</span><spanclass="n">transliterate</span><spanclass="p"data-group-id="5718620764-6">(</span><spanclass="s">"Some number is: 123556"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"th"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"thai"</span><spanclass="p"data-group-id="5718620764-6">)</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number.Transliterate</span><spanclass="o">.</span><spanclass="n">transliterate</span><spanclass="p"data-group-id="0042156105-6">(</span><spanclass="s">"Some number is: 123556"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"th"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"thai"</span><spanclass="p"data-group-id="0042156105-6">)</span><spanclass="w">
</span><spanclass="s">"Some number is: ๑๒๓๕๕๖"</span></code></pre>
</section>
</section>
@ -318,14 +318,14 @@ and <a href="Plausible.Cldr.Number.System.html#number_systems_for/1"><code class
<p>Transliterates digits from one number system to another number system</p><ul><li><p><codeclass="inline">digits</code> is binary representation of a number</p></li><li><p><codeclass="inline">from_system</code> and <codeclass="inline">to_system</code> are number system names in atom form. See
<ahref="https://hexdocs.pm/ex_cldr_numbers/2.30.1/Cldr.Number.System.html#systems_with_digits/0"><codeclass="inline">Cldr.Number.System.systems_with_digits/0</code></a> for available number systems.</p></li></ul><h2id="transliterate_digits/3-example"class="section-heading">
<ahref="https://hexdocs.pm/ex_cldr_numbers/2.31.3/Cldr.Number.System.html#systems_with_digits/0"><codeclass="inline">Cldr.Number.System.systems_with_digits/0</code></a> for available number systems.</p></li></ul><h2id="transliterate_digits/3-example"class="section-heading">
<p>Formats numbers and currencies based upon CLDR's decimal formats specification.</p><p>The format specification is documentated in <ahref="http://unicode.org/reports/tr35/tr35-numbers.html#Number_Formats">Unicode TR35</a>.
There are several classes of formatting including non-scientific, scientific,
rules based (for spelling and ordinal formats), compact formats that display <codeclass="inline">1k</code>
rather than <codeclass="inline">1,000</code> and so on. See <ahref="https://hexdocs.pm/ex_cldr_numbers/2.30.1/Cldr.Number.html#to_string/2"><codeclass="inline">Cldr.Number.to_string/2</code></a> for specific formatting
rather than <codeclass="inline">1,000</code> and so on. See <ahref="https://hexdocs.pm/ex_cldr_numbers/2.31.3/Cldr.Number.html#to_string/2"><codeclass="inline">Cldr.Number.to_string/2</code></a> for specific formatting
</span><spanclass="s">"The string </span><spanclass="se">\"</span><spanclass="s">+1.000,34</span><spanclass="se">\"</span><spanclass="s"> could not be parsed as a number"</span><spanclass="p"data-group-id="8740511091-9">}</span><spanclass="p"data-group-id="8740511091-8">}</span></code></pre>
</span><spanclass="s">"The string </span><spanclass="se">\"</span><spanclass="s">+1.000,34</span><spanclass="se">\"</span><spanclass="s"> could not be parsed as a number"</span><spanclass="p"data-group-id="3722544740-9">}</span><spanclass="p"data-group-id="3722544740-8">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="resolve_currencies/2">
@ -464,8 +464,8 @@ names and symbols are expected</p></li><li><p><code class="inline">options</code
</a>
Options
</h2>
<ul><li><p><codeclass="inline">:locale</code> is any valid locale returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.Locale.html#new!/2"><codeclass="inline">Cldr.Locale.new!/2</code></a>
<ul><li><p><codeclass="inline">:locale</code> is any valid locale returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.Locale.html#new!/2"><codeclass="inline">Cldr.Locale.new!/2</code></a>
The default is <codeclass="inline">Plausible.Cldr.get_locale()</code></p></li><li><p><codeclass="inline">:only</code> is an <codeclass="inline">atom</code> or list of <codeclass="inline">atoms</code> representing the
currencies or currency types to be considered for a match.
The equates to a list of acceptable currencies for parsing.
@ -498,17 +498,17 @@ financial instruments.</p></li></ul><h2 id="resolve_currencies/2-examples" class
</a>
Examples
</h2>
<pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="4359855336-1">(</span><spanclass="s">"100 US dollars"</span><spanclass="p"data-group-id="4359855336-1">)</span><spanclass="w">
<pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="7257081284-1">(</span><spanclass="s">"100 US dollars"</span><spanclass="p"data-group-id="7257081284-1">)</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="4359855336-6">(</span><spanclass="s">"100 dollars des États-Unis"</span><spanclass="p"data-group-id="4359855336-6">)</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="7257081284-6">(</span><spanclass="s">"100 dollars des États-Unis"</span><spanclass="p"data-group-id="7257081284-6">)</span><spanclass="w">
@ -545,8 +545,8 @@ names and symbols are expected</p></li><li><p><code class="inline">options</code
</a>
Options
</h2>
<ul><li><p><codeclass="inline">:locale</code> is any valid locale returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.Locale.html#new!/2"><codeclass="inline">Cldr.Locale.new!/2</code></a>
<ul><li><p><codeclass="inline">:locale</code> is any valid locale returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.Locale.html#new!/2"><codeclass="inline">Cldr.Locale.new!/2</code></a>
The default is <codeclass="inline">Plausible.Cldr.get_locale()</code></p></li><li><p><codeclass="inline">:only</code> is an <codeclass="inline">atom</code> or list of <codeclass="inline">atoms</code> representing the
currencies or currency types to be considered for a match.
The equates to a list of acceptable currencies for parsing.
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">resolve_currency</span><spanclass="p"data-group-id="9118603349-5">(</span><spanclass="s">"dollars des États-Unis"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"fr"</span><spanclass="p"data-group-id="9118603349-5">)</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">resolve_currency</span><spanclass="p"data-group-id="1872046209-5">(</span><spanclass="s">"dollars des États-Unis"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"fr"</span><spanclass="p"data-group-id="1872046209-5">)</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">resolve_currency</span><spanclass="p"data-group-id="9118603349-7">(</span><spanclass="s">"not a known currency"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"fr"</span><spanclass="p"data-group-id="9118603349-7">)</span><spanclass="w">
</span><spanclass="s">"The currency </span><spanclass="se">\"</span><spanclass="s">not a known currency</span><spanclass="se">\"</span><spanclass="s"> is unknown or not supported"</span><spanclass="p"data-group-id="9118603349-9">}</span><spanclass="p"data-group-id="9118603349-8">}</span></code></pre>
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">resolve_currency</span><spanclass="p"data-group-id="1872046209-7">(</span><spanclass="s">"not a known currency"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"fr"</span><spanclass="p"data-group-id="1872046209-7">)</span><spanclass="w">
</span><spanclass="s">"The currency </span><spanclass="se">\"</span><spanclass="s">not a known currency</span><spanclass="se">\"</span><spanclass="s"> is unknown or not supported"</span><spanclass="p"data-group-id="1872046209-9">}</span><spanclass="p"data-group-id="1872046209-8">}</span></code></pre>
@ -646,8 +646,8 @@ and permille symbols are expected</p></li><li><p><code class="inline">options</c
</a>
Options
</h2>
<ul><li><codeclass="inline">:locale</code> is any valid locale returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.Locale.html#new!/2"><codeclass="inline">Cldr.Locale.new!/2</code></a>
<ul><li><codeclass="inline">:locale</code> is any valid locale returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.Locale.html#new!/2"><codeclass="inline">Cldr.Locale.new!/2</code></a>
The default is <codeclass="inline">options[:backend].get_locale()</code></li></ul><h2id="resolve_per/2-returns"class="section-heading">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">resolve_per</span><spanclass="w"></span><spanclass="s">"% of linguists"</span><spanclass="w">
</span><spanclass="p"data-group-id="8100792597-2">[</span><spanclass="ss">:percent</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">" of linguists"</span><spanclass="p"data-group-id="8100792597-2">]</span><spanclass="w">
</span><spanclass="p"data-group-id="5871066644-2">[</span><spanclass="ss">:percent</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">" of linguists"</span><spanclass="p"data-group-id="5871066644-2">]</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">resolve_per</span><spanclass="w"></span><spanclass="s">"% of linguists %"</span><spanclass="w">
</span><spanclass="p"data-group-id="8100792597-3">[</span><spanclass="ss">:percent</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">" of linguists "</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:percent</span><spanclass="p"data-group-id="8100792597-3">]</span></code></pre>
</span><spanclass="p"data-group-id="5871066644-3">[</span><spanclass="ss">:percent</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">" of linguists "</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:percent</span><spanclass="p"data-group-id="5871066644-3">]</span></code></pre>
</section>
</section>
<sectionclass="detail"id="resolve_pers/2">
@ -696,7 +696,7 @@ The default is <code class="inline">options[:backend].get_locale()</code></li></
@ -716,17 +716,17 @@ permille symbols are expected</p></li><li><p><code class="inline">options</code>
</a>
Options
</h2>
<ul><li><codeclass="inline">:locale</code> is any valid locale returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>
or a <codeclass="inline">t:Cldr.LanguageTag</code> struct returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.Locale.html#new!/2"><codeclass="inline">Cldr.Locale.new!/2</code></a>
<ul><li><codeclass="inline">:locale</code> is any valid locale returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>
or a <codeclass="inline">t:Cldr.LanguageTag</code> struct returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.Locale.html#new!/2"><codeclass="inline">Cldr.Locale.new!/2</code></a>
The default is <codeclass="inline">options[:backend].get_locale()</code></li></ul><h2id="resolve_pers/2-examples"class="section-heading">
@ -766,7 +766,7 @@ a list of strings and numbers.</p><h2 id="scan/2-arguments" class="section-headi
<ul><li><p><codeclass="inline">:number</code> is one of <codeclass="inline">:integer</code>, <codeclass="inline">:float</code>,
<codeclass="inline">:decimal</code> or <codeclass="inline">nil</code>. The default is <codeclass="inline">nil</code>
meaning that the type auto-detected as either
an <codeclass="inline">integer</code> or a <codeclass="inline">float</code>.</p></li><li><p><codeclass="inline">:locale</code> is any locale returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>
an <codeclass="inline">integer</code> or a <codeclass="inline">float</code>.</p></li><li><p><codeclass="inline">:locale</code> is any locale returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>
or a <codeclass="inline">Cldr.LanguageTag.t</code>. The default is <ahref="Plausible.Cldr.html#get_locale/0"><codeclass="inline">Plausible.Cldr.get_locale/0</code></a>.</p></li></ul><h2id="scan/2-returns"class="section-heading">
@ -779,27 +779,27 @@ or a <code class="inline">Cldr.LanguageTag.t</code>. The default is <a href="Pla
</a>
Notes
</h2>
<p>Number parsing is performed by <ahref="https://hexdocs.pm/ex_cldr_numbers/2.30.1/Cldr.Number.Parser.html#parse/2"><codeclass="inline">Cldr.Number.Parser.parse/2</code></a>
<p>Number parsing is performed by <ahref="https://hexdocs.pm/ex_cldr_numbers/2.31.3/Cldr.Number.Parser.html#parse/2"><codeclass="inline">Cldr.Number.Parser.parse/2</code></a>
and any options provided are passed to that function.</p><h2id="scan/2-examples"class="section-heading">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="0565525577-5">(</span><spanclass="s">"The prize is 23"</span><spanclass="p"data-group-id="0565525577-5">)</span><spanclass="w">
</span><spanclass="p"data-group-id="0565525577-6">[</span><spanclass="s">"The prize is "</span><spanclass="p">,</span><spanclass="w"></span><spanclass="mi">23</span><spanclass="p"data-group-id="0565525577-6">]</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="7136270898-5">(</span><spanclass="s">"The prize is 23"</span><spanclass="p"data-group-id="7136270898-5">)</span><spanclass="w">
</span><spanclass="p"data-group-id="7136270898-6">[</span><spanclass="s">"The prize is "</span><spanclass="p">,</span><spanclass="w"></span><spanclass="mi">23</span><spanclass="p"data-group-id="7136270898-6">]</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="0565525577-7">(</span><spanclass="s">"The lottery number is 23 for the next draw"</span><spanclass="p"data-group-id="0565525577-7">)</span><spanclass="w">
</span><spanclass="p"data-group-id="0565525577-8">[</span><spanclass="s">"The lottery number is "</span><spanclass="p">,</span><spanclass="w"></span><spanclass="mi">23</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">" for the next draw"</span><spanclass="p"data-group-id="0565525577-8">]</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="7136270898-7">(</span><spanclass="s">"The lottery number is 23 for the next draw"</span><spanclass="p"data-group-id="7136270898-7">)</span><spanclass="w">
</span><spanclass="p"data-group-id="7136270898-8">[</span><spanclass="s">"The lottery number is "</span><spanclass="p">,</span><spanclass="w"></span><spanclass="mi">23</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">" for the next draw"</span><spanclass="p"data-group-id="7136270898-8">]</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="0565525577-9">(</span><spanclass="s">"The loss is -1.000 euros"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"de"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">number</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:integer</span><spanclass="p"data-group-id="0565525577-9">)</span><spanclass="w">
</span><spanclass="p"data-group-id="0565525577-10">[</span><spanclass="s">"The loss is "</span><spanclass="p">,</span><spanclass="w"></span><spanclass="o">-</span><spanclass="mi">1000</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">" euros"</span><spanclass="p"data-group-id="0565525577-10">]</span></code></pre>
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="7136270898-9">(</span><spanclass="s">"The loss is -1.000 euros"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"de"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">number</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:integer</span><spanclass="p"data-group-id="7136270898-9">)</span><spanclass="w">
</span><spanclass="p"data-group-id="7136270898-10">[</span><spanclass="s">"The loss is "</span><spanclass="p">,</span><spanclass="w"></span><spanclass="o">-</span><spanclass="mi">1000</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">" euros"</span><spanclass="p"data-group-id="7136270898-10">]</span></code></pre>
</section>
</section>
<sectionclass="detail"id="to_approx_string/2">
@ -838,7 +838,7 @@ a locale and number system.</p><h2 id="to_approx_string/2-arguments" class="sect
Arguments
</h2>
<ul><li><p><codeclass="inline">number</code> is an integer, float or Decimal to be formatted</p></li><li><p><codeclass="inline">options</code> is a keyword list defining how the number is to be formatted.
See <ahref="https://hexdocs.pm/ex_cldr_numbers/2.30.1/Cldr.Number.html#to_string/3"><codeclass="inline">Cldr.Number.to_string/3</code></a> for a description of the available
See <ahref="https://hexdocs.pm/ex_cldr_numbers/2.31.3/Cldr.Number.html#to_string/3"><codeclass="inline">Cldr.Number.to_string/3</code></a> for a description of the available
@ -932,7 +932,7 @@ a locale and number system.</p><h2 id="to_at_most_string/2-arguments" class="sec
Arguments
</h2>
<ul><li><p><codeclass="inline">number</code> is an integer, float or Decimal to be formatted</p></li><li><p><codeclass="inline">options</code> is a keyword list defining how the number is to be formatted.
See <ahref="https://hexdocs.pm/ex_cldr_numbers/2.30.1/Cldr.Number.html#to_string/3"><codeclass="inline">Cldr.Number.to_string/3</code></a> for a description of the available
See <ahref="https://hexdocs.pm/ex_cldr_numbers/2.31.3/Cldr.Number.html#to_string/3"><codeclass="inline">Cldr.Number.to_string/3</code></a> for a description of the available
@ -979,7 +979,7 @@ the <code class="inline">:range</code> format for a locale and number system.</p
Arguments
</h2>
<ul><li><p><codeclass="inline">number</code> is an integer, float or Decimal to be formatted</p></li><li><p><codeclass="inline">options</code> is a keyword list defining how the number is to be formatted.
See <ahref="https://hexdocs.pm/ex_cldr_numbers/2.30.1/Cldr.Number.html#to_string/3"><codeclass="inline">Cldr.Number.to_string/3</code></a> for a description of the available
See <ahref="https://hexdocs.pm/ex_cldr_numbers/2.31.3/Cldr.Number.html#to_string/3"><codeclass="inline">Cldr.Number.to_string/3</code></a> for a description of the available
<ul><li><p><codeclass="inline">format</code>: the format style or a format string defining how the number is
formatted. See <ahref="https://hexdocs.pm/ex_cldr_numbers/2.30.1/Cldr.Number.Format.html"><codeclass="inline">Cldr.Number.Format</code></a> for how format strings can be constructed.
See <ahref="https://hexdocs.pm/ex_cldr_numbers/2.30.1/Cldr.Number.Format.html#format_styles_for/3"><codeclass="inline">Cldr.Number.Format.format_styles_for/3</code></a> to return available format styles
formatted. See <ahref="https://hexdocs.pm/ex_cldr_numbers/2.31.3/Cldr.Number.Format.html"><codeclass="inline">Cldr.Number.Format</code></a> for how format strings can be constructed.
See <ahref="https://hexdocs.pm/ex_cldr_numbers/2.31.3/Cldr.Number.Format.html#format_styles_for/3"><codeclass="inline">Cldr.Number.Format.format_styles_for/3</code></a> to return available format styles
for a locale. The default <codeclass="inline">format</code> is <codeclass="inline">:standard</code>.</p></li><li><p>If <codeclass="inline">:format</code> is set to <codeclass="inline">:long</code> or <codeclass="inline">:short</code> then the formatting depends on
whether <codeclass="inline">:currency</code> is specified. If not specified then the number is
formatted as <codeclass="inline">:decimal_long</code> or <codeclass="inline">:decimal_short</code>. If <codeclass="inline">:currency</code> is
specified the number is formatted as <codeclass="inline">:currency_long</code> or
<codeclass="inline">:currency_short</code> and <codeclass="inline">:fractional_digits</code> is set to 0 as a default.</p></li><li><p><codeclass="inline">:format</code> may also be a format defined by CLDR's Rules Based Number
Formats (RBNF). Further information is found in the module <ahref="https://hexdocs.pm/ex_cldr_numbers/2.30.1/Cldr.Rbnf.html"><codeclass="inline">Cldr.Rbnf</code></a>.
Formats (RBNF). Further information is found in the module <ahref="https://hexdocs.pm/ex_cldr_numbers/2.31.3/Cldr.Rbnf.html"><codeclass="inline">Cldr.Rbnf</code></a>.
The most commonly used formats in this category are to spell out the
number in a the locales language. The applicable formats are <codeclass="inline">:spellout</code>,
<codeclass="inline">:spellout_year</code>, <codeclass="inline">:ordinal</code>. A number can also be formatted as roman
@ -1065,10 +1065,10 @@ should be used to define the separators and digits for the formatted
number. If <codeclass="inline">number_system</code> is an <codeclass="inline">atom</code> then <codeclass="inline">number_system</code> is
interpreted as a number system. If the <codeclass="inline">:number_system</code> is
<codeclass="inline">binary</code> then it is interpreted as a number system name. See
<ahref="https://hexdocs.pm/ex_cldr_numbers/2.30.1/Cldr.Number.System.html#number_system_names_for/2"><codeclass="inline">Cldr.Number.System.number_system_names_for/2</code></a>. The default is <codeclass="inline">:default</code>.</p></li><li><p><codeclass="inline">:locale</code>: determines the locale in which the number is formatted. See
<ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#known_locale_names/0"><codeclass="inline">Cldr.known_locale_names/0</code></a>. The default is<ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#get_locale/0"><codeclass="inline">Cldr.get_locale/0</code></a> which is the
<ahref="https://hexdocs.pm/ex_cldr_numbers/2.31.3/Cldr.Number.System.html#number_system_names_for/2"><codeclass="inline">Cldr.Number.System.number_system_names_for/2</code></a>. The default is <codeclass="inline">:default</code>.</p></li><li><p><codeclass="inline">:locale</code>: determines the locale in which the number is formatted. See
<ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_locale_names/0"><codeclass="inline">Cldr.known_locale_names/0</code></a>. The default is<ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#get_locale/0"><codeclass="inline">Cldr.get_locale/0</code></a> which is the
locale currently in affect for this <ahref="https://hexdocs.pm/elixir/Process.html"><codeclass="inline">Process</code></a> and which is set by
<ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#put_locale/1"><codeclass="inline">Cldr.put_locale/1</code></a>.</p></li><li><p>If <codeclass="inline">:fractional_digits</code> is set to a positive integer value then the number
<ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#put_locale/1"><codeclass="inline">Cldr.put_locale/1</code></a>.</p></li><li><p>If <codeclass="inline">:fractional_digits</code> is set to a positive integer value then the number
will be rounded to that number of digits and displayed accordingly - overriding
settings that would be applied by default. For example, currencies have
fractional digits defined reflecting each currencies minor unit. Setting
<p>Wrapping elements is particularly useful when formatting a number with a
currency symbol and the requirement is to have different HTML formatting
applied to the symbol than the number. For example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="9629363654-1">(</span><spanclass="mi">100</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:currency</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">currency</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:USD</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">wrapper</span><spanclass="p">:</span><spanclass="w"></span><spanclass="k"data-group-id="9629363654-2">fn</span><spanclass="w">
applied to the symbol than the number. For example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="0711327112-1">(</span><spanclass="mi">100</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:currency</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">currency</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:USD</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">wrapper</span><spanclass="p">:</span><spanclass="w"></span><spanclass="k"data-group-id="0711327112-2">fn</span><spanclass="w">
</span><spanclass="p"data-group-id="9629363654-3">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"<span class=</span><spanclass="se">\"</span><spanclass="s">symbol</span><spanclass="se">\"</span><spanclass="s">>$</span><span class=</span><spanclass="se">\"</span><spanclass="s">number</span><spanclass="se">\"</span><spanclass="s">>100.00</span>"</span><spanclass="p"data-group-id="9629363654-3">}</span></code></pre><p>It is also possible and recommended to use the <ahref="https://hexdocs.pm/phoenix_html/3.3.1/Phoenix.HTML.Tag.html#content_tag/3"><codeclass="inline">Phoenix.HTML.Tag.content_tag/3</code></a>
</span><spanclass="p"data-group-id="0711327112-3">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"<span class=</span><spanclass="se">\"</span><spanclass="s">symbol</span><spanclass="se">\"</span><spanclass="s">>$</span><span class=</span><spanclass="se">\"</span><spanclass="s">number</span><spanclass="se">\"</span><spanclass="s">>100.00</span>"</span><spanclass="p"data-group-id="0711327112-3">}</span></code></pre><p>It is also possible and recommended to use the <ahref="https://hexdocs.pm/phoenix_html/3.3.1/Phoenix.HTML.Tag.html#content_tag/3"><codeclass="inline">Phoenix.HTML.Tag.content_tag/3</code></a>
function if wrapping HTML tags since these will ensure HTML entities are
correctly encoded. For example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="7405189700-1">(</span><spanclass="mi">100</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:currency</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">currency</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:USD</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">wrapper</span><spanclass="p">:</span><spanclass="w"></span><spanclass="k"data-group-id="7405189700-2">fn</span><spanclass="w">
</span><spanclass="p"data-group-id="7405189700-6">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"<span class=</span><spanclass="se">\"</span><spanclass="s">symbol</span><spanclass="se">\"</span><spanclass="s">>$</span><span class=</span><spanclass="se">\"</span><spanclass="s">number</span><spanclass="se">\"</span><spanclass="s">>100.00</span>"</span><spanclass="p"data-group-id="7405189700-6">}</span></code></pre><p>When formatting a number the format is parsed into format elements that might include
</span><spanclass="p"data-group-id="8422440487-6">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"<span class=</span><spanclass="se">\"</span><spanclass="s">symbol</span><spanclass="se">\"</span><spanclass="s">>$</span><span class=</span><spanclass="se">\"</span><spanclass="s">number</span><spanclass="se">\"</span><spanclass="s">>100.00</span>"</span><spanclass="p"data-group-id="8422440487-6">}</span></code></pre><p>When formatting a number the format is parsed into format elements that might include
a currency symbol, a literal string, inserted text between a currency symbol and the
currency amount, a percent sign, the number itself and several other elements. In
some cases it is helpful to be apply specific formatting to each element.
@ -1141,80 +1141,80 @@ inserted in the final formatted number.</p><h2 id="to_string/2-returns" class="s
</span><spanclass="p"data-group-id="9443141492-12">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"1,244 US dollars"</span><spanclass="p"data-group-id="9443141492-12">}</span><spanclass="w">
</span><spanclass="p"data-group-id="4507640006-12">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"1,244 US dollars"</span><spanclass="p"data-group-id="4507640006-12">}</span><spanclass="w">
</span><spanclass="p"data-group-id="9443141492-15">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"one thousand two hundred thirty-four"</span><spanclass="p"data-group-id="9443141492-15">}</span><spanclass="w">
</span><spanclass="p"data-group-id="4507640006-15">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"one thousand two hundred thirty-four"</span><spanclass="p"data-group-id="4507640006-15">}</span><spanclass="w">
</span><spanclass="p"data-group-id="9443141492-16">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"one thousand two hundred and thirty-four"</span><spanclass="p"data-group-id="9443141492-16">}</span><spanclass="w">
</span><spanclass="p"data-group-id="4507640006-16">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"one thousand two hundred and thirty-four"</span><spanclass="p"data-group-id="4507640006-16">}</span><spanclass="w">
<p>An error tuple <codeclass="inline">{:error, reason}</code> will be returned if an error is detected.
The two most likely causes of an error return are:</p><ul><li>A format cannot be compiled. In this case the error tuple will look like:</li></ul><pre><codeclass="makeup elixir"translate="no"><spanclass="w"></span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="8765242682-1">(</span><spanclass="mi">12345</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"0#"</span><spanclass="p"data-group-id="8765242682-1">)</span><spanclass="w">
</span><spanclass="s">"Decimal format compiler: syntax error before: </span><spanclass="se">\"</span><spanclass="s">#</span><spanclass="se">\"</span><spanclass="s">"</span><spanclass="p"data-group-id="8765242682-3">}</span><spanclass="p"data-group-id="8765242682-2">}</span></code></pre><ul><li>The format style requested is not defined for the <codeclass="inline">locale</code> and
The two most likely causes of an error return are:</p><ul><li>A format cannot be compiled. In this case the error tuple will look like:</li></ul><pre><codeclass="makeup elixir"translate="no"><spanclass="w"></span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="8496596036-1">(</span><spanclass="mi">12345</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"0#"</span><spanclass="p"data-group-id="8496596036-1">)</span><spanclass="w">
</span><spanclass="s">"Decimal format compiler: syntax error before: </span><spanclass="se">\"</span><spanclass="s">#</span><spanclass="se">\"</span><spanclass="s">"</span><spanclass="p"data-group-id="8496596036-3">}</span><spanclass="p"data-group-id="8496596036-2">}</span></code></pre><ul><li>The format style requested is not defined for the <codeclass="inline">locale</code> and
<codeclass="inline">number_system</code>. This happens typically when the number system is
<codeclass="inline">:algorithmic</code> rather than the more common <codeclass="inline">:numeric</code>. In this case the error
</span><spanclass="s">"The locale :he with number system :hebr does not define a format :standard"</span><spanclass="p"data-group-id="9924223580-3">}</span><spanclass="p"data-group-id="9924223580-2">}</span></code></pre>
</span><spanclass="s">"The locale :he with number system :hebr does not define a format :standard"</span><spanclass="p"data-group-id="0186197059-3">}</span><spanclass="p"data-group-id="0186197059-2">}</span></code></pre>
@ -1308,27 +1308,27 @@ underlying number system is returned.</p><h2 id="validate_number_system/2-argume
</a>
Arguments
</h2>
<ul><li><p><codeclass="inline">locale</code> is any valid locale name returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.Locale.html#new!/2"><codeclass="inline">Cldr.Locale.new!/2</code></a></p></li><li><p><codeclass="inline">system_name</code> is any number system name returned by
<ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#known_number_systems/0"><codeclass="inline">Cldr.known_number_systems/0</code></a> or a number system type
returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#known_number_system_types/0"><codeclass="inline">Cldr.known_number_system_types/0</code></a></p></li></ul><h2id="validate_number_system/2-examples"class="section-heading">
<ul><li><p><codeclass="inline">locale</code> is any valid locale name returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.Locale.html#new!/2"><codeclass="inline">Cldr.Locale.new!/2</code></a></p></li><li><p><codeclass="inline">system_name</code> is any number system name returned by
<ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_number_systems/0"><codeclass="inline">Cldr.known_number_systems/0</code></a> or a number system type
returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_number_system_types/0"><codeclass="inline">Cldr.known_number_system_types/0</code></a></p></li></ul><h2id="validate_number_system/2-examples"class="section-heading">
</span><spanclass="p"data-group-id="5863035240-4">{</span><spanclass="nc">Cldr.UnknownNumberSystemError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The number system :unknown is unknown"</span><spanclass="p"data-group-id="5863035240-4">}</span><spanclass="p"data-group-id="5863035240-3">}</span><spanclass="w">
</span><spanclass="p"data-group-id="0281351616-4">{</span><spanclass="nc">Cldr.UnknownNumberSystemError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The number system :unknown is unknown"</span><spanclass="p"data-group-id="0281351616-4">}</span><spanclass="p"data-group-id="0281351616-3">}</span><spanclass="w">
</span><spanclass="p"data-group-id="5863035240-5">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="5863035240-6">{</span><spanclass="nc">Cldr.InvalidLanguageError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The language </span><spanclass="se">\"</span><spanclass="s">zz</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="5863035240-6">}</span><spanclass="p"data-group-id="5863035240-5">}</span></code></pre>
</span><spanclass="p"data-group-id="0281351616-5">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="0281351616-6">{</span><spanclass="nc">Cldr.InvalidLanguageError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The language </span><spanclass="se">\"</span><spanclass="s">zz</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="0281351616-6">}</span><spanclass="p"data-group-id="0281351616-5">}</span></code></pre>
<p>Functions to implement the number system rule-based-number-format rules of CLDR.</p><p>These rules are defined only on the "und" locale and represent specialised
number formatting.</p><p>The standard public API for RBNF is via the <ahref="https://hexdocs.pm/ex_cldr_numbers/2.30.1/Cldr.Number.html#to_string/2"><codeclass="inline">Cldr.Number.to_string/2</code></a> function.</p><p>The functions on this module are defined at compile time based upon the RBNF rules
defined in the Unicode CLDR data repository. Available rules are identified by:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.NumberSystem</span><spanclass="o">.</span><spanclass="n">rule_sets</span><spanclass="p"data-group-id="0693193074-1">(</span><spanclass="ss">:und</span><spanclass="p"data-group-id="0693193074-1">)</span><spanclass="w">
</span><spanclass="ss">:ethiopic</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:cyrillic_lower</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:armenian_upper</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:armenian_lower</span><spanclass="p"data-group-id="0693193074-2">]</span></code></pre><p>A rule can then be invoked on an available rule_set. For example</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.NumberSystem</span><spanclass="o">.</span><spanclass="n">roman_upper</span><spanclass="p"data-group-id="4483217656-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:und</span><spanclass="p"data-group-id="4483217656-1">)</span><spanclass="w">
</span><spanclass="s">"CXXIII"</span></code></pre><p>This particular call is equivalent to the call through the public API of:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="8773106754-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:roman</span><spanclass="p"data-group-id="8773106754-1">)</span><spanclass="w">
number formatting.</p><p>The standard public API for RBNF is via the <ahref="https://hexdocs.pm/ex_cldr_numbers/2.31.3/Cldr.Number.html#to_string/2"><codeclass="inline">Cldr.Number.to_string/2</code></a> function.</p><p>The functions on this module are defined at compile time based upon the RBNF rules
defined in the Unicode CLDR data repository. Available rules are identified by:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.NumberSystem</span><spanclass="o">.</span><spanclass="n">rule_sets</span><spanclass="p"data-group-id="2180675098-1">(</span><spanclass="ss">:und</span><spanclass="p"data-group-id="2180675098-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="2180675098-3">]</span></code></pre><p>A rule can then be invoked on an available rule_set. For example</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.NumberSystem</span><spanclass="o">.</span><spanclass="n">roman_upper</span><spanclass="p"data-group-id="4544510567-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:und</span><spanclass="p"data-group-id="4544510567-1">)</span><spanclass="w">
</span><spanclass="s">"CXXIII"</span></code></pre><p>This particular call is equivalent to the call through the public API of:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="4640614666-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:roman</span><spanclass="p"data-group-id="4640614666-1">)</span><spanclass="w">
<p>Functions to implement the ordinal rule-based-number-format rules of CLDR.</p><p>As CLDR notes, the data is incomplete or non-existent for many languages. It
is considered complete for English however.</p><p>The standard public API for RBNF is via the <ahref="https://hexdocs.pm/ex_cldr_numbers/2.30.1/Cldr.Number.html#to_string/2"><codeclass="inline">Cldr.Number.to_string/2</code></a> function.</p><p>The functions on this module are defined at compile time based upon the RBNF rules
defined in the Unicode CLDR data repository. Available rules are identified by:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.Ordinal</span><spanclass="o">.</span><spanclass="n">rule_sets</span><spanclass="p"data-group-id="4369967951-1">(</span><spanclass="ss">:en</span><spanclass="p"data-group-id="4369967951-1">)</span><spanclass="w">
is considered complete for English however.</p><p>The standard public API for RBNF is via the <ahref="https://hexdocs.pm/ex_cldr_numbers/2.31.3/Cldr.Number.html#to_string/2"><codeclass="inline">Cldr.Number.to_string/2</code></a> function.</p><p>The functions on this module are defined at compile time based upon the RBNF rules
defined in the Unicode CLDR data repository. Available rules are identified by:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.Ordinal</span><spanclass="o">.</span><spanclass="n">rule_sets</span><spanclass="p"data-group-id="2814017135-1">(</span><spanclass="ss">:en</span><spanclass="p"data-group-id="2814017135-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="4369967951-4">]</span></code></pre><p>A rule can then be invoked on an available rule_set. For example</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.Ordinal</span><spanclass="o">.</span><spanclass="n">digits_ordinal</span><spanclass="p"data-group-id="1472870427-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:en</span><spanclass="p"data-group-id="1472870427-1">)</span><spanclass="w">
</span><spanclass="s">"123rd"</span></code></pre><p>This call is equivalent to the call through the public API of:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="8880841019-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:ordinal</span><spanclass="p"data-group-id="8880841019-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="2814017135-5">]</span></code></pre><p>A rule can then be invoked on an available rule_set. For example</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.Ordinal</span><spanclass="o">.</span><spanclass="n">digits_ordinal</span><spanclass="p"data-group-id="3449265235-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:en</span><spanclass="p"data-group-id="3449265235-1">)</span><spanclass="w">
</span><spanclass="s">"123rd"</span></code></pre><p>This call is equivalent to the call through the public API of:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="2918948911-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:ordinal</span><spanclass="p"data-group-id="2918948911-1">)</span><spanclass="w">
<p>Functions to implement the spellout rule-based-number-format rules of CLDR.</p><p>As CLDR notes, the data is incomplete or non-existent for many languages. It
is considered complete for English however.</p><p>The standard public API for RBNF is via the <ahref="https://hexdocs.pm/ex_cldr_numbers/2.30.1/Cldr.Number.html#to_string/2"><codeclass="inline">Cldr.Number.to_string/2</code></a> function.</p><p>The functions on this module are defined at compile time based upon the RBNF rules
defined in the Unicode CLDR data repository. Available rules are identified by:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.Spellout</span><spanclass="o">.</span><spanclass="n">rule_sets</span><spanclass="p"data-group-id="9657479954-1">(</span><spanclass="s">"en"</span><spanclass="p"data-group-id="9657479954-1">)</span><spanclass="w">
</span><spanclass="ss">:spellout_cardinal</span><spanclass="p"data-group-id="9657479954-2">]</span></code></pre><p>A rule can then be invoked on an available rule_set. For example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.Spellout</span><spanclass="o">.</span><spanclass="n">spellout_ordinal</span><spanclass="p"data-group-id="5651087231-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"en"</span><spanclass="p"data-group-id="5651087231-1">)</span><spanclass="w">
</span><spanclass="s">"one hundred twenty-third"</span></code></pre><p>This call is equivalent to the call through the public API of:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="3620060348-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:spellout</span><spanclass="p"data-group-id="3620060348-1">)</span><spanclass="w">
is considered complete for English however.</p><p>The standard public API for RBNF is via the <ahref="https://hexdocs.pm/ex_cldr_numbers/2.31.3/Cldr.Number.html#to_string/2"><codeclass="inline">Cldr.Number.to_string/2</code></a> function.</p><p>The functions on this module are defined at compile time based upon the RBNF rules
defined in the Unicode CLDR data repository. Available rules are identified by:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.Spellout</span><spanclass="o">.</span><spanclass="n">rule_sets</span><spanclass="p"data-group-id="3779024382-1">(</span><spanclass="s">"en"</span><spanclass="p"data-group-id="3779024382-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="3779024382-3">]</span></code></pre><p>A rule can then be invoked on an available rule_set. For example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.Spellout</span><spanclass="o">.</span><spanclass="n">spellout_ordinal</span><spanclass="p"data-group-id="9142501103-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"en"</span><spanclass="p"data-group-id="9142501103-1">)</span><spanclass="w">
</span><spanclass="s">"one hundred twenty-third"</span></code></pre><p>This call is equivalent to the call through the public API of:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="3279602466-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:spellout</span><spanclass="p"data-group-id="3279602466-1">)</span><spanclass="w">
@ -182,7 +182,7 @@ does not specify one and none can be inferred.</p></div>
</div>
<divclass="summary-synopsis"><p>Return the current locale to be used for <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html"><codeclass="inline">Cldr</code></a> functions that
<divclass="summary-synopsis"><p>Return the current locale to be used for <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html"><codeclass="inline">Cldr</code></a> functions that
take an optional locale parameter for which a locale is not supplied.</p></div>
</div>
@ -193,7 +193,7 @@ take an optional locale parameter for which a locale is not supplied.</p></div>
@ -238,7 +238,7 @@ name is configured and available in Gettext.</p></div>
<divclass="summary-synopsis"><p>Returns a list of Gettext locale names but in CLDR format with
underscore replaced by hyphen in order to facilitate comparisons
with <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html"><codeclass="inline">Cldr</code></a> locale names.</p></div>
with <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html"><codeclass="inline">Cldr</code></a> locale names.</p></div>
</div>
@ -249,7 +249,7 @@ with <a href="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html"><code class="inline">
</div>
<divclass="summary-synopsis"><p>Returns either the <codeclass="inline">locale_name</code> or <codeclass="inline">false</code> based upon
whether the locale name is configured in <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html"><codeclass="inline">Cldr</code></a>.</p></div>
whether the locale name is configured in <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html"><codeclass="inline">Cldr</code></a>.</p></div>
</div>
@ -280,7 +280,7 @@ name is configured and available in Cldr.</p></div>
</div>
<divclass="summary-synopsis"><p>Returns a list of atoms representing the number systems types known to <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html"><codeclass="inline">Cldr</code></a>.</p></div>
<divclass="summary-synopsis"><p>Returns a list of atoms representing the number systems types known to <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html"><codeclass="inline">Cldr</code></a>.</p></div>
</div>
@ -290,7 +290,7 @@ name is configured and available in Cldr.</p></div>
@ -356,7 +356,7 @@ of common symbols in numbers, currencies and dates</p></div>
</div>
<divclass="summary-synopsis"><p>Set the current locale to be used for <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html"><codeclass="inline">Cldr</code></a> functions that
<divclass="summary-synopsis"><p>Set the current locale to be used for <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html"><codeclass="inline">Cldr</code></a> functions that
take an optional locale parameter for which a locale is not supplied.</p></div>
</div>
@ -388,7 +388,7 @@ but not known in CLDR.</p></div>
@ -611,8 +611,8 @@ does not specify one and none can be inferred.</p><h2 id="default_territory/0-ex
</h2>
<ul><li><p><codeclass="inline">string</code> is any <codeclass="inline">String.t</code> or a 2-element list
of <codeclass="inline">String.t</code> between which the ellipsis is inserted.</p></li><li><p><codeclass="inline">backend</code> is any module that includes <codeclass="inline">use Cldr</code> and therefore
is a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html"><codeclass="inline">Cldr</code></a> backend module. The default is <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#default_backend!/0"><codeclass="inline">Cldr.default_backend!/0</code></a>.
Note that <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#default_backend!/0"><codeclass="inline">Cldr.default_backend!/0</code></a> will raise an exception if
is a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html"><codeclass="inline">Cldr</code></a> backend module. The default is <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#default_backend!/0"><codeclass="inline">Cldr.default_backend!/0</code></a>.
Note that <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#default_backend!/0"><codeclass="inline">Cldr.default_backend!/0</code></a> will raise an exception if
no <codeclass="inline">:default_backend</code> is configured under the <codeclass="inline">:ex_cldr</code> key in
<codeclass="inline">config.exs</code>.</p></li><li><p><codeclass="inline">options</code> is a keyword list of options</p></li></ul><h2id="ellipsis/2-options"class="section-heading">
@ -620,8 +620,8 @@ no <code class="inline">:default_backend</code> is configured under the <code cl
</a>
Options
</h2>
<ul><li><p><codeclass="inline">:locale</code> is any valid locale name returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>.
The default is <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#get_locale/0"><codeclass="inline">Cldr.get_locale/0</code></a>.</p></li><li><p><codeclass="inline">:location</code> determines where to place the ellipsis. The options are
<ul><li><p><codeclass="inline">:locale</code> is any valid locale name returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>.
The default is <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#get_locale/0"><codeclass="inline">Cldr.get_locale/0</code></a>.</p></li><li><p><codeclass="inline">:location</code> determines where to place the ellipsis. The options are
<codeclass="inline">:after</code> (the default for a single string argument), <codeclass="inline">:between</code>
(the default and only valid location for an argument that is a list
of two strings) and <codeclass="inline">:before</code>.</p></li><li><p><codeclass="inline">:format</code> formats based upon whether the ellipsis
@ -635,13 +635,13 @@ is inserted between words or sentences. The valid options are
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr</span><spanclass="o">.</span><spanclass="n">ellipsis</span><spanclass="w"></span><spanclass="p"data-group-id="4021685000-1">[</span><spanclass="s">"And furthermore"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"there is much to be done"</span><spanclass="p"data-group-id="4021685000-1">]</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:ja</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr</span><spanclass="o">.</span><spanclass="n">ellipsis</span><spanclass="w"></span><spanclass="p"data-group-id="3169984552-1">[</span><spanclass="s">"And furthermore"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"there is much to be done"</span><spanclass="p"data-group-id="3169984552-1">]</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:ja</span><spanclass="w">
</span><spanclass="s">"And furthermore…there is much to be done"</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr</span><spanclass="o">.</span><spanclass="n">ellipsis</span><spanclass="w"></span><spanclass="p"data-group-id="4021685000-2">[</span><spanclass="s">"And furthermore"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"there is much to be done"</span><spanclass="p"data-group-id="4021685000-2">]</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:ja</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:word</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr</span><spanclass="o">.</span><spanclass="n">ellipsis</span><spanclass="w"></span><spanclass="p"data-group-id="3169984552-2">[</span><spanclass="s">"And furthermore"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"there is much to be done"</span><spanclass="p"data-group-id="3169984552-2">]</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:ja</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:word</span><spanclass="w">
</span><spanclass="s">"And furthermore … there is much to be done"</span></code></pre>
</section>
</section>
@ -666,34 +666,34 @@ is inserted between words or sentences. The valid options are
<p>Returns either the <codeclass="inline">locale_name</code> or <codeclass="inline">false</code> based upon
whether the locale name is configured in <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html"><codeclass="inline">Cldr</code></a>.</p><p>This is helpful when building a list of <codeclass="inline">or</code> expressions
whether the locale name is configured in <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html"><codeclass="inline">Cldr</code></a>.</p><p>This is helpful when building a list of <codeclass="inline">or</code> expressions
to return the first known locale name from a list.</p><h2id="known_locale_name/1-arguments"class="section-heading">
@ -999,14 +999,14 @@ in this module or in <a href="https://hexdocs.pm/gettext/0.19.1/Gettext.html"><c
<sectionclass="docstring">
<p>Returns a list of atoms representing the number systems types known to <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html"><codeclass="inline">Cldr</code></a>.</p><h2id="known_number_system_types/0-example"class="section-heading">
<p>Returns a list of atoms representing the number systems types known to <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html"><codeclass="inline">Cldr</code></a>.</p><h2id="known_number_system_types/0-example"class="section-heading">
</span><spanclass="s">"Expected a BCP47 language tag. Could not parse the remaining </span><spanclass="se">\"</span><spanclass="s">!</span><spanclass="se">\"</span><spanclass="s"> starting at position 15"</span><spanclass="p"data-group-id="6057154255-12">}</span><spanclass="p"data-group-id="6057154255-11">}</span></code></pre>
</span><spanclass="s">"Expected a BCP47 language tag. Could not parse the remaining </span><spanclass="se">\"</span><spanclass="s">!</span><spanclass="se">\"</span><spanclass="s"> starting at position 15"</span><spanclass="p"data-group-id="1473274861-12">}</span><spanclass="p"data-group-id="1473274861-11">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="quote/2">
@ -1305,8 +1305,8 @@ of a language tag.</p><h2 id="put_locale/1-examples" class="section-heading">
</a>
Options
</h2>
<ul><li><codeclass="inline">locale</code> is any valid locale name returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>.
The default is <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#get_locale/0"><codeclass="inline">Cldr.get_locale/0</code></a></li></ul><h2id="quote/2-examples"class="section-heading">
<ul><li><codeclass="inline">locale</code> is any valid locale name returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>.
The default is <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#get_locale/0"><codeclass="inline">Cldr.get_locale/0</code></a></li></ul><h2id="quote/2-examples"class="section-heading">
<ul><li><codeclass="inline">locale</code> is any valid locale name returned by <ahref="#known_locale_names/0"><codeclass="inline">Plausible.Cldr.known_locale_names/0</code></a>
or a <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="Plausible.Cldr.Locale.html#new!/1"><codeclass="inline">Plausible.Cldr.Locale.new!/1</code></a></li></ul><h2id="validate_locale/1-returns"class="section-heading">
or a <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a> struct returned by <ahref="Plausible.Cldr.Locale.html#new!/1"><codeclass="inline">Plausible.Cldr.Locale.new!/1</code></a></li></ul><h2id="validate_locale/1-returns"class="section-heading">
</span><spanclass="p"data-group-id="8632856101-18">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="8632856101-19">{</span><spanclass="nc">Cldr.InvalidLanguageError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The language </span><spanclass="se">\"</span><spanclass="s">zzz</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="8632856101-19">}</span><spanclass="p"data-group-id="8632856101-18">}</span></code></pre>
</span><spanclass="p"data-group-id="2958785294-18">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="2958785294-19">{</span><spanclass="nc">Cldr.InvalidLanguageError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The language </span><spanclass="se">\"</span><spanclass="s">zzz</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="2958785294-19">}</span><spanclass="p"data-group-id="2958785294-18">}</span></code></pre>
</span><spanclass="p"data-group-id="4557930608-4">{</span><spanclass="nc">Cldr.UnknownNumberSystemTypeError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The number system type :latn is unknown"</span><spanclass="p"data-group-id="4557930608-4">}</span><spanclass="w">
</span><spanclass="p"data-group-id="9421371193-4">{</span><spanclass="nc">Cldr.UnknownNumberSystemTypeError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The number system type :latn is unknown"</span><spanclass="p"data-group-id="9421371193-4">}</span><spanclass="w">
</span><spanclass="p"data-group-id="4557930608-6">{</span><spanclass="nc">Cldr.UnknownNumberSystemTypeError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The number system type </span><spanclass="se">\"</span><spanclass="s">bork</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="4557930608-6">}</span><spanclass="w">
</span><spanclass="p"data-group-id="9421371193-6">{</span><spanclass="nc">Cldr.UnknownNumberSystemTypeError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The number system type </span><spanclass="se">\"</span><spanclass="s">bork</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="9421371193-6">}</span><spanclass="w">
@ -1633,7 +1633,7 @@ current locale is restored after the function.</p><h2 id="with_locale/2-argument
</a>
Arguments
</h2>
<ul><li><p><codeclass="inline">locale</code> is any valid locale name returned by <ahref="https://hexdocs.pm/ex_cldr/2.36.0/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>.</p></li><li><p><codeclass="inline">fun</code> is any 0-arity function or function capture.</p></li></ul><h2id="with_locale/2-returns"class="section-heading">
<ul><li><p><codeclass="inline">locale</code> is any valid locale name returned by <ahref="https://hexdocs.pm/ex_cldr/2.37.2/Cldr.html#known_locale_names/1"><codeclass="inline">Cldr.known_locale_names/1</code></a>.</p></li><li><p><codeclass="inline">fun</code> is any 0-arity function or function capture.</p></li></ul><h2id="with_locale/2-returns"class="section-heading">
@ -818,23 +818,23 @@ pool to disconnect within the given interval.</p><p>See <a href="https://hexdocs
<sectionclass="docstring">
<p>Similar to <codeclass="inline">insert_all/2</code> but with the following differences:</p><ul><li>accepts rows as streams or lists</li><li>sends rows as a chunked request</li><li>doesn't autogenerate ids or does any other preprocessing</li></ul><p>Example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="nc">Repo</span><spanclass="o">.</span><spanclass="n">query!</span><spanclass="p"data-group-id="6134838607-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="6134838607-1">)</span><spanclass="w">
<p>Similar to <codeclass="inline">insert_all/2</code> but with the following differences:</p><ul><li>accepts rows as streams or lists</li><li>sends rows as a chunked request</li><li>doesn't autogenerate ids or does any other preprocessing</li></ul><p>Example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="nc">Repo</span><spanclass="o">.</span><spanclass="n">query!</span><spanclass="p"data-group-id="1535738854-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="1535738854-1">)</span><spanclass="w">
@ -1125,23 +1125,23 @@ pool to disconnect within the given interval.</p><p>See <a href="https://hexdocs
<sectionclass="docstring">
<p>Similar to <ahref="#insert_all/2"><codeclass="inline">insert_all/2</code></a> but with the following differences:</p><ul><li>accepts rows as streams or lists</li><li>sends rows as a chunked request</li><li>doesn't autogenerate ids or does any other preprocessing</li></ul><p>Example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="nc">Repo</span><spanclass="o">.</span><spanclass="n">query!</span><spanclass="p"data-group-id="1203133283-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="1203133283-1">)</span><spanclass="w">
<p>Similar to <ahref="#insert_all/2"><codeclass="inline">insert_all/2</code></a> but with the following differences:</p><ul><li>accepts rows as streams or lists</li><li>sends rows as a chunked request</li><li>doesn't autogenerate ids or does any other preprocessing</li></ul><p>Example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="nc">Repo</span><spanclass="o">.</span><spanclass="n">query!</span><spanclass="p"data-group-id="9807475070-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="9807475070-1">)</span><spanclass="w">
<p> In the case of a DB-IP database:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">database_type</span><spanclass="p"data-group-id="6009703815-1">(</span><spanclass="p"data-group-id="6009703815-1">)</span><spanclass="w">
</span><spanclass="s">"DBIP-City-Lite"</span></code></pre><p> In the case of a MaxMind database:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">database_type</span><spanclass="p"data-group-id="5574476302-1">(</span><spanclass="p"data-group-id="5574476302-1">)</span><spanclass="w">
<p> In the case of a DB-IP database:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">database_type</span><spanclass="p"data-group-id="8333613787-1">(</span><spanclass="p"data-group-id="8333613787-1">)</span><spanclass="w">
</span><spanclass="s">"DBIP-City-Lite"</span></code></pre><p> In the case of a MaxMind database:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">database_type</span><spanclass="p"data-group-id="6651384523-1">(</span><spanclass="p"data-group-id="6651384523-1">)</span><spanclass="w">
<p> Loading from a local file:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">load_db</span><spanclass="p"data-group-id="1134680553-1">(</span><spanclass="ss">path</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"/etc/plausible/dbip-city.mmdb"</span><spanclass="p"data-group-id="1134680553-1">)</span><spanclass="w">
</span><spanclass="ss">:ok</span></code></pre><p> Downloading a MaxMind DB (this license key is no longer active):</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">load_db</span><spanclass="p"data-group-id="8334289636-1">(</span><spanclass="ss">license_key</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"LNpsJCCKPis6XvBP"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">edition</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"GeoLite2-City"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">async</span><spanclass="p">:</span><spanclass="w"></span><spanclass="no">true</span><spanclass="p"data-group-id="8334289636-1">)</span><spanclass="w">
<p> Loading from a local file:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">load_db</span><spanclass="p"data-group-id="7380763076-1">(</span><spanclass="ss">path</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"/etc/plausible/dbip-city.mmdb"</span><spanclass="p"data-group-id="7380763076-1">)</span><spanclass="w">
</span><spanclass="ss">:ok</span></code></pre><p> Downloading a MaxMind DB (this license key is no longer active):</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">load_db</span><spanclass="p"data-group-id="6114966146-1">(</span><spanclass="ss">license_key</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"LNpsJCCKPis6XvBP"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">edition</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"GeoLite2-City"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">async</span><spanclass="p">:</span><spanclass="w"></span><spanclass="no">true</span><spanclass="p"data-group-id="6114966146-1">)</span><spanclass="w">
</span><spanclass="s">"pt-BR"</span><spanclass="w"></span><spanclass="p">=></span><spanclass="w"></span><spanclass="s">"América do Norte"</span><spanclass="p">,</span><spanclass="w">
@ -1116,23 +1116,23 @@ pool to disconnect within the given interval.</p><p>See <a href="https://hexdocs
<sectionclass="docstring">
<p>Similar to <ahref="#insert_all/2"><codeclass="inline">insert_all/2</code></a> but with the following differences:</p><ul><li>accepts rows as streams or lists</li><li>sends rows as a chunked request</li><li>doesn't autogenerate ids or does any other preprocessing</li></ul><p>Example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="nc">Repo</span><spanclass="o">.</span><spanclass="n">query!</span><spanclass="p"data-group-id="2639598688-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="2639598688-1">)</span><spanclass="w">
<p>Similar to <ahref="#insert_all/2"><codeclass="inline">insert_all/2</code></a> but with the following differences:</p><ul><li>accepts rows as streams or lists</li><li>sends rows as a chunked request</li><li>doesn't autogenerate ids or does any other preprocessing</li></ul><p>Example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="nc">Repo</span><spanclass="o">.</span><spanclass="n">query!</span><spanclass="p"data-group-id="1756299268-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="1756299268-1">)</span><spanclass="w">
@ -1116,23 +1116,23 @@ pool to disconnect within the given interval.</p><p>See <a href="https://hexdocs
<sectionclass="docstring">
<p>Similar to <ahref="#insert_all/2"><codeclass="inline">insert_all/2</code></a> but with the following differences:</p><ul><li>accepts rows as streams or lists</li><li>sends rows as a chunked request</li><li>doesn't autogenerate ids or does any other preprocessing</li></ul><p>Example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="nc">Repo</span><spanclass="o">.</span><spanclass="n">query!</span><spanclass="p"data-group-id="2864114139-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="2864114139-1">)</span><spanclass="w">
<p>Similar to <ahref="#insert_all/2"><codeclass="inline">insert_all/2</code></a> but with the following differences:</p><ul><li>accepts rows as streams or lists</li><li>sends rows as a chunked request</li><li>doesn't autogenerate ids or does any other preprocessing</li></ul><p>Example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="nc">Repo</span><spanclass="o">.</span><spanclass="n">query!</span><spanclass="p"data-group-id="6838432846-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="6838432846-1">)</span><spanclass="w">