</ul>

</li>

<li class="toctree-l4"><a class="reference internal" href="library/string.html#format-string-syntax">格式化文字語法</a><ul>

<li class="toctree-l5"><a class="reference internal" href="library/string.html#format-examples">Format examples</a></li>

</ul>

</li>

| <a href="#"><strong></strong></a>

| <a href="#A"><strong>A</strong></a>

| <a href="#"><strong></strong></a>

| <a href="#B"><strong>B</strong></a>

| <a href="#"><strong></strong></a>

| <a href="#B"><strong>B</strong></a>

| <a href="#P"><strong>P</strong></a>

| <a href="#"><strong></strong></a>

| <a href="#P"><strong>P</strong></a>

| <a href="#Q"><strong>Q</strong></a>

| <a href="#"><strong></strong></a>

| <a href="#Q"><strong>Q</strong></a>

</li>

<li><a href="library/wsgiref.html#wsgiref.util.application_uri">application_uri() (於 wsgiref.util 模組中)</a>

</li>

<li><a href="library/2to3.html#to3fixer-apply">apply (2to3 fixer)</a>

</li>

<li><a href="library/multiprocessing.html#multiprocessing.pool.Pool.apply">apply() (multiprocessing.pool.Pool 的方法)</a>

</ul></li>

<li><a href="library/argparse.html#argparse.ArgumentTypeError">ArgumentTypeError</a>

</li>

<li><a href="glossary.html#term-argument"><strong>argument（引數）</strong></a>

<ul>

<li><a href="faq/programming.html#index-1">與 parameter（參數）的差異</a>

</li>

</ul></li>

<li><a href="library/sys.html#sys.argv">argv (於 sys 模組中)</a>

</li>

<li><a href="c-api/init.html#index-29">argv（sys 模組中）</a>

</li>

<li><a href="library/dialog.html#tkinter.simpledialog.askinteger">askinteger() (於 tkinter.simpledialog 模組中)</a>

</li>

<li><a href="library/tkinter.messagebox.html#tkinter.messagebox.askokcancel">askokcancel() (於 tkinter.messagebox 模組中)</a>

</li>

<li><a href="library/dialog.html#tkinter.filedialog.askopenfile">askopenfile() (於 tkinter.filedialog 模組中)</a>

</li>

<li><a href="library/typing.html#typing.assert_never">assert_never() (於 typing 模組中)</a>

</li>

<li><a href="library/unittest.mock.html#unittest.mock.AsyncMock.assert_not_awaited">assert_not_awaited() (unittest.mock.AsyncMock 的方法)</a>

</li>

<li><a href="library/unittest.mock.html#unittest.mock.Mock.assert_not_called">assert_not_called() (unittest.mock.Mock 的方法)</a>

</ul></li>

<li><a href="library/pydoc.html#index-1">PAGER</a>

</li>

<li><a href="library/curses.html#curses.pair_content">pair_content() (於 curses 模組中)</a>

</li>

<li><a href="library/curses.html#curses.pair_number">pair_number() (於 curses 模組中)</a>

</li>

<li><a href="library/inspect.html#inspect.Signature.parameters">parameters (inspect.Signature 的屬性)</a>

</li>

<li><a href="glossary.html#term-parameter"><strong>parameter（參數）</strong></a>

<ul>

<li><a href="faq/programming.html#index-1">與 argument（引數）的差異</a>

</li>

</ul></li>

<li><a href="library/email.headerregistry.html#email.headerregistry.ParameterizedMIMEHeader.params">params (email.headerregistry.ParameterizedMIMEHeader 的屬性)</a>

</li>

<li><a href="library/ast.html#ast.ParamSpec">ParamSpec (ast 中的類別)</a>

</li>

<li><a href="library/cgi.html#cgi.parse_header">parse_header() (於 cgi 模組中)</a>

</li>

<li><a href="library/http.client.html#http.client.parse_headers">parse_headers() (於 http.client 模組中)</a>

</li>

<li><a href="library/argparse.html#argparse.ArgumentParser.parse_intermixed_args">parse_intermixed_args() (argparse.ArgumentParser 的方法)</a>

</li>

<li><a href="library/email.utils.html#email.utils.parsedate">parsedate() (於 email.utils 模組中)</a>

</li>

<li><a href="library/email.utils.html#email.utils.parsedate_to_datetime">parsedate_to_datetime() (於 email.utils 模組中)</a>

</li>

<li><a href="library/email.utils.html#email.utils.parsedate_tz">parsedate_tz() (於 email.utils 模組中)</a>

| <a href="genindex-.html"><strong></strong></a>

| <a href="genindex-A.html"><strong>A</strong></a>

| <a href="genindex-.html"><strong></strong></a>

| <a href="genindex-B.html"><strong>B</strong></a>

| <a href="genindex-.html"><strong></strong></a>

| <a href="genindex-B.html"><strong>B</strong></a>

| <a href="genindex-P.html"><strong>P</strong></a>

| <a href="genindex-.html"><strong></strong></a>

| <a href="genindex-P.html"><strong>P</strong></a>

| <a href="genindex-Q.html"><strong>Q</strong></a>

| <a href="genindex-.html"><strong></strong></a>

| <a href="genindex-Q.html"><strong>Q</strong></a>

presentation types <code class="docutils literal notranslate"><span class="pre">&quot;e&quot;</span></code>, <code class="docutils literal notranslate"><span class="pre">&quot;E&quot;</span></code>, <code class="docutils literal notranslate"><span class="pre">&quot;f&quot;</span></code>, <code class="docutils literal notranslate"><span class="pre">&quot;F&quot;</span></code>, <code class="docutils literal notranslate"><span class="pre">&quot;g&quot;</span></code>, <code class="docutils literal notranslate"><span class="pre">&quot;G&quot;</span></code>

and <code class="docutils literal notranslate"><span class="pre">&quot;%&quot;</span></code> are supported. For these presentation types, formatting for a

<a class="reference internal" href="#fractions.Fraction" title="fractions.Fraction"><code class="xref py py-class docutils literal notranslate"><span class="pre">Fraction</span></code></a> object <code class="docutils literal notranslate"><span class="pre">x</span></code> follows the rules outlined for

<p>Here are some examples:</p>

<div class="highlight-python3 notranslate"><div class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span class="kn">from</span> <span class="nn">fractions</span> <span class="kn">import</span> <span class="n">Fraction</span>

<span class="gp">&gt;&gt;&gt; </span><span class="nb">format</span><span class="p">(</span><span class="n">Fraction</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="mi">7</span><span class="p">),</span> <span class="s1">&#39;.40g&#39;</span><span class="p">)</span>

<dl class="py function" id="index-4">

<dt class="sig sig-object py" id="format">

<span class="sig-name descname"><span class="pre">format</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">value</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">format_spec</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">''</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#format" title="Link to this definition">¶</a></dt>

<p>預設的 <em>format_spec</em> 是一個空字串，它通常和呼叫 <a class="reference internal" href="stdtypes.html#str" title="str"><code class="xref py py-func docutils literal notranslate"><span class="pre">str(value)</span></code></a> 的效果相同。</p>

<p>呼叫 <code class="docutils literal notranslate"><span class="pre">format(value,</span> <span class="pre">format_spec)</span></code> 會轉換成 <code class="docutils literal notranslate"><span class="pre">type(value).__format__(value,</span> <span class="pre">format_spec)</span></code>，當搜尋 value 的 <code class="xref py py-meth docutils literal notranslate"><span class="pre">__format__()</span></code> method 時，會忽略實例中的字典。如果搜尋到 <a class="reference internal" href="#object" title="object"><code class="xref py py-mod docutils literal notranslate"><span class="pre">object</span></code></a> 這個 method 但 <em>format_spec</em> 不為空，或是 <em>format_spec</em> 或回傳值不是字串，則會觸發 <a class="reference internal" href="exceptions.html#TypeError" title="TypeError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">TypeError</span></code></a>。</p>

<div class="versionchanged">

<li><p><code class="docutils literal notranslate"><span class="pre">int(string,</span> <span class="pre">base)</span></code> with base 2, 4, 8, 16, or 32.</p></li>

<li><p><a class="reference internal" href="#int.from_bytes" title="int.from_bytes"><code class="xref py py-func docutils literal notranslate"><span class="pre">int.from_bytes()</span></code></a> and <a class="reference internal" href="#int.to_bytes" title="int.to_bytes"><code class="xref py py-func docutils literal notranslate"><span class="pre">int.to_bytes()</span></code></a>.</p></li>

<li><p><a class="reference internal" href="functions.html#hex" title="hex"><code class="xref py py-func docutils literal notranslate"><span class="pre">hex()</span></code></a>, <a class="reference internal" href="functions.html#oct" title="oct"><code class="xref py py-func docutils literal notranslate"><span class="pre">oct()</span></code></a>, <a class="reference internal" href="functions.html#bin" title="bin"><code class="xref py py-func docutils literal notranslate"><span class="pre">bin()</span></code></a>.</p></li>

<li><p><a class="reference internal" href="#str" title="str"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a> to <a class="reference internal" href="functions.html#float" title="float"><code class="xref py py-class docutils literal notranslate"><span class="pre">float</span></code></a>.</p></li>

<li><p><a class="reference internal" href="#str" title="str"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a> to <a class="reference internal" href="decimal.html#decimal.Decimal" title="decimal.Decimal"><code class="xref py py-class docutils literal notranslate"><span class="pre">decimal.Decimal</span></code></a>.</p></li>

</ul>

<li><a class="reference internal" href="#format-string-syntax">格式化文字語法</a><ul>

<li><a class="reference internal" href="#format-examples">Format examples</a></li>

The <em>field_name</em> is optionally followed by a <em>conversion</em> field, which is

preceded by an exclamation point <code class="docutils literal notranslate"><span class="pre">'!'</span></code>, and a <em>format_spec</em>, which is preceded

by a colon <code class="docutils literal notranslate"><span class="pre">':'</span></code>. These specify a non-default format for the replacement value.</p>

<p>The <em>field_name</em> itself begins with an <em>arg_name</em> that is either a number or a

keyword. If it's a number, it refers to a positional argument, and if it's a keyword,

it refers to a named keyword argument. An <em>arg_name</em> is treated as a number if

This allows the formatting of a value to be dynamically specified.</p>

<p>範例請見 <a class="reference internal" href="#formatexamples"><span class="std std-ref">Format examples</span></a>。</p>

<section id="format-specification-mini-language">

<p>Most built-in types implement the following options for format specifications,

although some of the formatting options are only supported by the numeric types.</p>

<p>A general convention is that an empty format specification produces

<li><a class="reference internal" href="#format-string-syntax">格式化文字語法</a><ul>

<li><a class="reference internal" href="#format-examples">Format examples</a></li>

<li class="toctree-l2"><a class="reference internal" href="string.html#format-string-syntax">格式化文字語法</a><ul>

<li class="toctree-l3"><a class="reference internal" href="string.html#format-examples">Format examples</a></li>