@ -1143,23 +1143,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="1546264348-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="1546264348-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="3078155831-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="3078155831-1">)</span><spanclass="w">
@ -727,12 +727,12 @@ this user owns + StatsAPI if the user has a configured Stats API key.</p><p>Give
<p>Queries the ClickHouse database for the monthly pageview usage. If the given user's
subscription is <codeclass="inline">active</code>, <codeclass="inline">past_due</code>, or a <codeclass="inline">deleted</code> (but not yet expired), a map
with the following structure is returned:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="p"data-group-id="8014828795-1">%{</span><spanclass="w">
</span><spanclass="p"data-group-id="8014828795-1">}</span></code></pre><p>In all other cases of the subscription status (or a <codeclass="inline">free_10k</code> subscription which
does not have a <codeclass="inline">last_bill_date</code> defined) - the following structure is returned:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="p"data-group-id="9897877260-1">%{</span><spanclass="ss">last_30_days</span><spanclass="p">:</span><spanclass="w"></span><spanclass="n">usage_cycle</span><spanclass="p"data-group-id="9897877260-2">(</span><spanclass="p"data-group-id="9897877260-2">)</span><spanclass="p"data-group-id="9897877260-1">}</span></code></pre><p>Given only a user as input, the usage is queried from across all the sites that the
with the following structure is returned:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="p"data-group-id="0261511306-1">%{</span><spanclass="w">
</span><spanclass="p"data-group-id="0261511306-1">}</span></code></pre><p>In all other cases of the subscription status (or a <codeclass="inline">free_10k</code> subscription which
does not have a <codeclass="inline">last_bill_date</code> defined) - the following structure is returned:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="p"data-group-id="0573350161-1">%{</span><spanclass="ss">last_30_days</span><spanclass="p">:</span><spanclass="w"></span><spanclass="n">usage_cycle</span><spanclass="p"data-group-id="0573350161-2">(</span><spanclass="p"data-group-id="0573350161-2">)</span><spanclass="p"data-group-id="0573350161-1">}</span></code></pre><p>Given only a user as input, the usage is queried from across all the sites that the
user owns. Alternatively, given an optional argument of <codeclass="inline">site_ids</code>, the usage from
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.37.5/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="9437222299-1">(</span><spanclass="w"></span><spanclass="p"data-group-id="9437222299-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="9437222299-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="9437222299-3">)</span><spanclass="w"></span><spanclass="p"data-group-id="9437222299-2">)</span><spanclass="w"></span><spanclass="o">|</span><spanclass="w"></span><spanclass="s">"*"</span><spanclass="w"></span><spanclass="p"data-group-id="9437222299-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="2105228647-1">(</span><spanclass="w"></span><spanclass="p"data-group-id="2105228647-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="2105228647-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="2105228647-3">)</span><spanclass="w"></span><spanclass="p"data-group-id="2105228647-2">)</span><spanclass="w"></span><spanclass="o">|</span><spanclass="w"></span><spanclass="s">"*"</span><spanclass="w"></span><spanclass="p"data-group-id="2105228647-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>
@ -261,54 +261,54 @@ a configured <a href="https://hexdocs.pm/ex_cldr/2.37.5/Cldr.html"><code class="
</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="5736480289-21">}</span><spanclass="p"data-group-id="5736480289-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="5736480289-24">}</span><spanclass="p"data-group-id="5736480289-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="1456660915-21">}</span><spanclass="p"data-group-id="1456660915-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="1456660915-24">}</span><spanclass="p"data-group-id="1456660915-23">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="parse/1">
@ -369,95 +369,95 @@ wuth an error tuple for each invalid tag added at the end of the list.</p><h2 id
</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="4833213771-22">}</span><spanclass="p"data-group-id="4833213771-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="2920576003-22">}</span><spanclass="p"data-group-id="2920576003-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="4833213771-43">}</span><spanclass="p"data-group-id="4833213771-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="2920576003-43">}</span><spanclass="p"data-group-id="2920576003-42">}</span><spanclass="w">
</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="0746142025-38">}</span><spanclass="p"data-group-id="0746142025-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="1780915237-38">}</span><spanclass="p"data-group-id="1780915237-37">}</span><spanclass="w">
</span><spanclass="p"data-group-id="4780921478-4">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="4780921478-5">{</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="4780921478-5">}</span><spanclass="p"data-group-id="4780921478-4">}</span></code></pre>
</span><spanclass="p"data-group-id="4695193262-4">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="4695193262-5">{</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="4695193262-5">}</span><spanclass="p"data-group-id="4695193262-4">}</span></code></pre>
</span><spanclass="p"data-group-id="8713900873-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="8713900873-6">}</span><spanclass="w">
</span><spanclass="p"data-group-id="8713900873-8">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="8713900873-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="8713900873-9">}</span><spanclass="p"data-group-id="8713900873-8">}</span></code></pre>
</span><spanclass="p"data-group-id="7128393551-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="7128393551-6">}</span><spanclass="w">
</span><spanclass="p"data-group-id="7128393551-8">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="7128393551-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="7128393551-9">}</span><spanclass="p"data-group-id="7128393551-8">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="pluralize/3">
@ -1355,20 +1355,20 @@ default is <a href="Plausible.Cldr.html#get_locale/0"><code class="inline">Plaus
</span><spanclass="p"data-group-id="9408111068-8">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"dollars des États-Unis"</span><spanclass="p"data-group-id="9408111068-8">}</span><spanclass="w">
</span><spanclass="p"data-group-id="5273950073-8">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"dollars des États-Unis"</span><spanclass="p"data-group-id="5273950073-8">}</span><spanclass="w">
</span><spanclass="p"data-group-id="9408111068-10">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"dollar des États-Unis"</span><spanclass="p"data-group-id="9408111068-10">}</span></code></pre>
</span><spanclass="p"data-group-id="5273950073-10">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"dollar des États-Unis"</span><spanclass="p"data-group-id="5273950073-10">}</span></code></pre>
</span><spanclass="p"data-group-id="6280501965-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="6280501965-4">}</span><spanclass="p"data-group-id="6280501965-3">}</span><spanclass="w">
</span><spanclass="p"data-group-id="2528287115-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="2528287115-4">}</span><spanclass="p"data-group-id="2528287115-3">}</span><spanclass="w">
</span><spanclass="p"data-group-id="6280501965-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="6280501965-7">}</span><spanclass="p"data-group-id="6280501965-6">}</span></code></pre>
</span><spanclass="p"data-group-id="2528287115-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="2528287115-7">}</span><spanclass="p"data-group-id="2528287115-6">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="new/1">
@ -683,12 +683,12 @@ be a territory.</p><h2 id="territory_from_host/1-arguments" class="section-headi
</span><spanclass="p"data-group-id="9143999111-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="9143999111-5">}</span><spanclass="p"data-group-id="9143999111-4">}</span></code></pre>
</span><spanclass="p"data-group-id="6054786412-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="6054786412-5">}</span><spanclass="p"data-group-id="6054786412-4">}</span></code></pre>
</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="7630058819-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="8424360787-10">}</span><spanclass="w">
</span><spanclass="p"data-group-id="9366771313-3">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="9366771313-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="9366771313-4">}</span><spanclass="p"data-group-id="9366771313-3">}</span></code></pre>
</span><spanclass="p"data-group-id="4428907213-3">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="4428907213-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="4428907213-4">}</span><spanclass="p"data-group-id="4428907213-3">}</span></code></pre>
</span><spanclass="p"data-group-id="1769110302-5">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="1769110302-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="1769110302-6">}</span><spanclass="p"data-group-id="1769110302-5">}</span></code></pre>
</span><spanclass="p"data-group-id="4954075117-5">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="4954075117-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="4954075117-6">}</span><spanclass="p"data-group-id="4954075117-5">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="number_systems_for!/1">
@ -613,20 +613,20 @@ actual system name.</p><h2 id="system_name_from/2-examples" class="section-headi
</span><spanclass="p"data-group-id="0091900289-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="0091900289-9">}</span><spanclass="w">
</span><spanclass="p"data-group-id="0091900289-8">}</span></code></pre><p>Note that return value is not guaranteed to be a valid
</span><spanclass="p"data-group-id="6852886849-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="6852886849-9">}</span><spanclass="w">
</span><spanclass="p"data-group-id="6852886849-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>
@ -673,16 +673,16 @@ is recommended.</p></li></ul><h2 id="to_system/2-examples" class="section-headin
@ -162,12 +162,12 @@ digits between number systems. For example from :arabic to :latn. Since genera
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="4097221484-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="4141625548-1">do</span><spanclass="w">
</span><spanclass="k"data-group-id="4097221484-1">end</span></code></pre><p>Where each tuple in the list configures one transliteration map. In this example, two maps are
</span><spanclass="k"data-group-id="4141625548-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.32.3/Cldr.Number.System.html#numeric_systems/0"><codeclass="inline">Cldr.Number.System.numeric_systems/0</code></a>.</p><p>If a transliteration is requested between two number pairs that have not been configured for
precompilation, a warning is logged.</p>
</section>
@ -281,22 +281,22 @@ and <a href="Plausible.Cldr.Number.System.html#number_systems_for/1"><code class
</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="8340529506-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="8340529506-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="2155840834-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="2155840834-6">)</span><spanclass="w">
</span><spanclass="s">"Some number is: ๑๒๓๕๕๖"</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="5632413265-9">}</span><spanclass="p"data-group-id="5632413265-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="0263916747-9">}</span><spanclass="p"data-group-id="0263916747-8">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="resolve_currencies/2">
@ -525,17 +525,17 @@ financial instruments.</p></li></ul><h2 id="resolve_currencies/2-examples" class
</a>
<spanclass="text">Examples</span>
</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="7339695563-1">(</span><spanclass="s">"100 US dollars"</span><spanclass="p"data-group-id="7339695563-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="6439258662-1">(</span><spanclass="s">"100 US dollars"</span><spanclass="p"data-group-id="6439258662-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="7339695563-6">(</span><spanclass="s">"100 dollars des États-Unis"</span><spanclass="p"data-group-id="7339695563-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="6439258662-6">(</span><spanclass="s">"100 dollars des États-Unis"</span><spanclass="p"data-group-id="6439258662-6">)</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="6405967548-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="6405967548-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="8700522354-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="8700522354-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="6405967548-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="6405967548-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="6405967548-9">}</span><spanclass="p"data-group-id="6405967548-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="8700522354-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="8700522354-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="8700522354-9">}</span><spanclass="p"data-group-id="8700522354-8">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="resolve_per/2">
@ -688,13 +688,13 @@ The default is <code class="inline">options[:backend].get_locale()</code></li></
</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="3306722474-2">[</span><spanclass="ss">:percent</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">" of linguists"</span><spanclass="p"data-group-id="3306722474-2">]</span><spanclass="w">
</span><spanclass="p"data-group-id="3899910821-2">[</span><spanclass="ss">:percent</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">" of linguists"</span><spanclass="p"data-group-id="3899910821-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="3306722474-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="3306722474-3">]</span></code></pre>
</span><spanclass="p"data-group-id="3899910821-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="3899910821-3">]</span></code></pre>
</section>
</section>
<sectionclass="detail"id="resolve_pers/2">
@ -751,9 +751,9 @@ The default is <code class="inline">options[:backend].get_locale()</code></li></
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="0259001054-5">(</span><spanclass="s">"The prize is 23"</span><spanclass="p"data-group-id="0259001054-5">)</span><spanclass="w">
</span><spanclass="p"data-group-id="0259001054-6">[</span><spanclass="s">"The prize is "</span><spanclass="p">,</span><spanclass="w"></span><spanclass="mi">23</span><spanclass="p"data-group-id="0259001054-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="3893078505-5">(</span><spanclass="s">"The prize is 23"</span><spanclass="p"data-group-id="3893078505-5">)</span><spanclass="w">
</span><spanclass="p"data-group-id="3893078505-6">[</span><spanclass="s">"The prize is "</span><spanclass="p">,</span><spanclass="w"></span><spanclass="mi">23</span><spanclass="p"data-group-id="3893078505-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="0259001054-7">(</span><spanclass="s">"The lottery number is 23 for the next draw"</span><spanclass="p"data-group-id="0259001054-7">)</span><spanclass="w">
</span><spanclass="p"data-group-id="0259001054-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="0259001054-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="3893078505-7">(</span><spanclass="s">"The lottery number is 23 for the next draw"</span><spanclass="p"data-group-id="3893078505-7">)</span><spanclass="w">
</span><spanclass="p"data-group-id="3893078505-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="3893078505-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="0259001054-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="0259001054-9">)</span><spanclass="w">
</span><spanclass="p"data-group-id="0259001054-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="0259001054-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="3893078505-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="3893078505-9">)</span><spanclass="w">
</span><spanclass="p"data-group-id="3893078505-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="3893078505-10">]</span></code></pre>
<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="2767339094-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="2767339094-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="7591297701-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="7591297701-2">fn</span><spanclass="w">
</span><spanclass="p"data-group-id="2767339094-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="2767339094-3">}</span></code></pre><p>It is also possible and recommended to use the <ahref="https://hexdocs.pm/phoenix_html/3.3.3/Phoenix.HTML.Tag.html#content_tag/3"><codeclass="inline">Phoenix.HTML.Tag.content_tag/3</code></a>
</span><spanclass="p"data-group-id="7591297701-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="7591297701-3">}</span></code></pre><p>It is also possible and recommended to use the <ahref="https://hexdocs.pm/phoenix_html/3.3.3/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="2953387573-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="2953387573-2">fn</span><spanclass="w">
</span><spanclass="p"data-group-id="2953387573-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="2953387573-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="0894975472-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="0894975472-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.
@ -1168,80 +1168,80 @@ inserted in the final formatted number.</p><h2 id="to_string/2-returns" class="s
</span><spanclass="p"data-group-id="8183930500-12">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"1,244 US dollars"</span><spanclass="p"data-group-id="8183930500-12">}</span><spanclass="w">
</span><spanclass="p"data-group-id="7556609051-12">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"1,244 US dollars"</span><spanclass="p"data-group-id="7556609051-12">}</span><spanclass="w">
</span><spanclass="p"data-group-id="8183930500-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="8183930500-15">}</span><spanclass="w">
</span><spanclass="p"data-group-id="7556609051-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="7556609051-15">}</span><spanclass="w">
</span><spanclass="p"data-group-id="8183930500-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="8183930500-16">}</span><spanclass="w">
</span><spanclass="p"data-group-id="7556609051-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="7556609051-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="7633838601-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="7633838601-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="7633838601-3">}</span><spanclass="p"data-group-id="7633838601-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="8115807722-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="8115807722-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="8115807722-3">}</span><spanclass="p"data-group-id="8115807722-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 :percent"</span><spanclass="p"data-group-id="6031453749-3">}</span><spanclass="p"data-group-id="6031453749-2">}</span></code></pre>
</span><spanclass="s">"The locale :he with number system :hebr does not define a format :percent"</span><spanclass="p"data-group-id="1316701626-3">}</span><spanclass="p"data-group-id="1316701626-2">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="to_string!/2">
@ -1346,17 +1346,17 @@ returned by <a href="https://hexdocs.pm/ex_cldr/2.37.5/Cldr.html#known_number_sy
</span><spanclass="p"data-group-id="1473173429-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="1473173429-4">}</span><spanclass="p"data-group-id="1473173429-3">}</span><spanclass="w">
</span><spanclass="p"data-group-id="0893935000-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="0893935000-4">}</span><spanclass="p"data-group-id="0893935000-3">}</span><spanclass="w">
</span><spanclass="p"data-group-id="1473173429-5">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="1473173429-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="1473173429-6">}</span><spanclass="p"data-group-id="1473173429-5">}</span></code></pre>
</span><spanclass="p"data-group-id="0893935000-5">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="0893935000-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="0893935000-6">}</span><spanclass="p"data-group-id="0893935000-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.32.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="8336096081-1">(</span><spanclass="ss">:und</span><spanclass="p"data-group-id="8336096081-1">)</span><spanclass="w">
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="4390301883-1">(</span><spanclass="ss">:und</span><spanclass="p"data-group-id="4390301883-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="8336096081-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="2435388400-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:und</span><spanclass="p"data-group-id="2435388400-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="0258894081-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="0258894081-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="4390301883-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="6172813156-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:und</span><spanclass="p"data-group-id="6172813156-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="6677457096-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="6677457096-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.32.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="3319623178-1">(</span><spanclass="ss">:en</span><spanclass="p"data-group-id="3319623178-1">)</span><spanclass="w">
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="8919170243-1">(</span><spanclass="ss">:en</span><spanclass="p"data-group-id="8919170243-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="3319623178-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="5584392147-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:en</span><spanclass="p"data-group-id="5584392147-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="4678844671-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="4678844671-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="8919170243-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="7806600576-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:en</span><spanclass="p"data-group-id="7806600576-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="4773468866-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="4773468866-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.32.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="9055455844-1">(</span><spanclass="s">"en"</span><spanclass="p"data-group-id="9055455844-1">)</span><spanclass="w">
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="9135921640-1">(</span><spanclass="s">"en"</span><spanclass="p"data-group-id="9135921640-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="9055455844-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="7110563391-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"en"</span><spanclass="p"data-group-id="7110563391-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="9849329151-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="9849329151-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="9135921640-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="5057991945-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"en"</span><spanclass="p"data-group-id="5057991945-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="3817355546-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="3817355546-1">)</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr</span><spanclass="o">.</span><spanclass="n">ellipsis</span><spanclass="p"data-group-id="0370166599-2">(</span><spanclass="p"data-group-id="0370166599-3">[</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="0370166599-3">]</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:ja</span><spanclass="p"data-group-id="0370166599-2">)</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr</span><spanclass="o">.</span><spanclass="n">ellipsis</span><spanclass="p"data-group-id="7539572753-2">(</span><spanclass="p"data-group-id="7539572753-3">[</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="7539572753-3">]</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:ja</span><spanclass="p"data-group-id="7539572753-2">)</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="p"data-group-id="0370166599-5">(</span><spanclass="p"data-group-id="0370166599-6">[</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="0370166599-6">]</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="p"data-group-id="0370166599-5">)</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr</span><spanclass="o">.</span><spanclass="n">ellipsis</span><spanclass="p"data-group-id="7539572753-5">(</span><spanclass="p"data-group-id="7539572753-6">[</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="7539572753-6">]</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="p"data-group-id="7539572753-5">)</span><spanclass="w">
</span><spanclass="s">"And furthermore … there is much to be done"</span></code></pre>
</section>
</section>
@ -715,23 +715,23 @@ take an optional locale parameter for which a locale is not supplied.</p><h2 id=
</span><spanclass="s">"Locale #Cldr.LanguageTag<de [validated]> does not map to a known gettext locale name"</span><spanclass="p"data-group-id="6448840223-5">}</span><spanclass="p"data-group-id="6448840223-4">}</span></code></pre>
</span><spanclass="s">"Locale #Cldr.LanguageTag<de [validated]> does not map to a known gettext locale name"</span><spanclass="p"data-group-id="0563911598-5">}</span><spanclass="p"data-group-id="0563911598-4">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="put_locale/1">
@ -1345,29 +1345,29 @@ of a language tag.</p><h2 id="put_locale/1-examples" 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="3974762423-12">}</span><spanclass="p"data-group-id="3974762423-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="7676921923-12">}</span><spanclass="p"data-group-id="7676921923-11">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="quote/2">
@ -1416,10 +1416,10 @@ The default is <a href="https://hexdocs.pm/ex_cldr/2.37.5/Cldr.html#get_locale/0
</span><spanclass="p"data-group-id="6523217913-18">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="6523217913-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="6523217913-19">}</span><spanclass="p"data-group-id="6523217913-18">}</span></code></pre>
</span><spanclass="p"data-group-id="4336937258-18">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="4336937258-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="4336937258-19">}</span><spanclass="p"data-group-id="4336937258-18">}</span></code></pre>
</span><spanclass="p"data-group-id="5927891406-7">{</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="5927891406-7">}</span><spanclass="w">
</span><spanclass="p"data-group-id="7428205246-7">{</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="7428205246-7">}</span><spanclass="w">
</span><spanclass="p"data-group-id="5927891406-10">{</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="5927891406-10">}</span><spanclass="w">
</span><spanclass="p"data-group-id="7428205246-10">{</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="7428205246-10">}</span><spanclass="w">
@ -845,23 +845,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="9503913934-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="9503913934-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="8181185076-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="8181185076-1">)</span><spanclass="w">
@ -1152,23 +1152,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="8465897141-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="8465897141-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="9259577739-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="9259577739-1">)</span><spanclass="w">
@ -581,14 +581,14 @@ tables into the format of <code class="inline">imported_*</code> tables for a w
</div>
<p>Creates a streamable Zip archive from the provided (named) Ecto queries.</p><p>Example usage:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="p"data-group-id="2004081756-1">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="n">pool</span><spanclass="p"data-group-id="2004081756-1">}</span><spanclass="w"></span><spanclass="o">=</span><spanclass="w"></span><spanclass="nc">Ch</span><spanclass="o">.</span><spanclass="n">start_link</span><spanclass="p"data-group-id="2004081756-2">(</span><spanclass="ss">pool_size</span><spanclass="p">:</span><spanclass="w"></span><spanclass="mi">1</span><spanclass="p"data-group-id="2004081756-2">)</span><spanclass="w">
<p>Creates a streamable Zip archive from the provided (named) Ecto queries.</p><p>Example usage:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="p"data-group-id="1298542674-1">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="n">pool</span><spanclass="p"data-group-id="1298542674-1">}</span><spanclass="w"></span><spanclass="o">=</span><spanclass="w"></span><spanclass="nc">Ch</span><spanclass="o">.</span><spanclass="n">start_link</span><spanclass="p"data-group-id="1298542674-2">(</span><spanclass="ss">pool_size</span><spanclass="p">:</span><spanclass="w"></span><spanclass="mi">1</span><spanclass="p"data-group-id="1298542674-2">)</span><spanclass="w">
@ -260,8 +260,8 @@ and MaxMind license key.</p></div>
</a>
<spanclass="text">Examples</span>
</h2>
<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="4620606606-1">(</span><spanclass="p"data-group-id="4620606606-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="6862239443-1">(</span><spanclass="p"data-group-id="6862239443-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="3964739316-1">(</span><spanclass="p"data-group-id="3964739316-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="9432165903-1">(</span><spanclass="p"data-group-id="9432165903-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="6711015694-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="6711015694-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="5045526976-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="5045526976-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="8911998117-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="8911998117-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="1626018429-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="1626018429-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">
@ -1143,23 +1143,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="9513736448-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="9513736448-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="6914070741-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="6914070741-1">)</span><spanclass="w">
<p>Extracts min/max date range from a list of uploads.</p><p>Examples:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">date_range</span><spanclass="p"data-group-id="5126221403-1">(</span><spanclass="p"data-group-id="5126221403-2">[</span><spanclass="w">
<p>Extracts min/max date range from a list of uploads.</p><p>Examples:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">date_range</span><spanclass="p"data-group-id="4431203933-1">(</span><spanclass="p"data-group-id="4431203933-2">[</span><spanclass="w">
<p>Extracts table name and min/max dates from the filename.</p><p>Examples:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">parse_filename!</span><spanclass="p"data-group-id="4416414461-1">(</span><spanclass="s">"my_data.csv"</span><spanclass="p"data-group-id="4416414461-1">)</span><spanclass="w">
<p>Extracts table name and min/max dates from the filename.</p><p>Examples:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">parse_filename!</span><spanclass="p"data-group-id="8740749958-1">(</span><spanclass="s">"my_data.csv"</span><spanclass="p"data-group-id="8740749958-1">)</span><spanclass="w">