blob: 44ddf06c451a1e745be15677eb10d286df9f4019 [file] [log] [blame]
<!doctype html>
<!-- Generated by FreeMarker/Docgen from DocBook -->
<html lang="en" class="page-type-section">
<head prefix="og: http://ogp.me/ns#">
<meta charset="utf-8">
<title>#{...}: Numerical interpolation - FreeMarker Manual</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="format-detection" content="telephone=no">
<meta property="og:site_name" content="FreeMarker Manual">
<meta property="og:title" content="#{...}: Numerical interpolation">
<meta property="og:locale" content="en_US">
<meta property="og:url" content="http://example.com/ref_depr_numerical_interpolation.html">
<link rel="canonical" href="http://example.com/ref_depr_numerical_interpolation.html">
<link rel="icon" href="favicon.png" type="image/png">
<link rel="stylesheet" type="text/css" href="docgen-resources/docgen.min.css?1594338517553">
</head>
<body itemscope itemtype="https://schema.org/Code">
<meta itemprop="url" content="http://example.com/">
<meta itemprop="name" content="FreeMarker Manual">
<!--[if lte IE 9]>
<div style="background-color: #C00; color: #fff; padding: 12px 24px;">Please use a modern browser to view this website.</div>
<![endif]--><div class="header-top-bg"><div class="site-width header-top"><a class="logo" href="http://example.com" role="banner"> <img itemprop="image" src="logo.png" alt="My Logo">
</a></div></div><div class="header-bottom-bg"><div class="site-width search-row"><a href="index.html" class="navigation-header">FreeMarker Manual</a><div class="navigation-header"></div></div><div class="site-width breadcrumb-row"><ul class="breadcrumb" itemscope itemtype="http://schema.org/BreadcrumbList"><li class="step-0" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="index.html"><span itemprop="name">FreeMarker Manual</span></a></li><li class="step-1" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="ref.html"><span itemprop="name">Reference</span></a></li><li class="step-2" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="ref_deprecated.html"><span itemprop="name">Deprecated FTL constructs</span></a></li><li class="step-3" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="ref_depr_numerical_interpolation.html"><span itemprop="name">#{...}: Numerical interpolation</span></a></li></ul><div class="bookmarks" title="Bookmarks"><span class="sr-only">Bookmarks:</span><ul class="bookmark-list"><li><a href="alphaidx.html">Index</a></li><li><a href="gloss.html">Glossary</a></li><li><a href="ref.html">Reference</a></li><li><a href="app_faq.html">FAQ</a></li><li><a href="preface.html#test_target">Bőregér</a></li></ul></div></div></div> <div class="main-content site-width">
<div class="content-wrapper no-toc">
<div id="table-of-contents-wrapper" class="col-left">
</div>
<div class="col-right"><div class="page-content"><div class="page-title"><div class="pagers top"><a class="paging-arrow previous" href="ref_depr_oldsyntax.html"><span>Previous</span></a><a class="paging-arrow next" href="app.html"><span>Next</span></a></div><div class="title-wrapper">
<h1 class="content-header header-section1" id="ref_depr_numerical_interpolation" itemprop="headline">#{...}: Numerical interpolation</h1>
</div></div><div class="page-menu">
<div class="page-menu-title">Page Contents</div>
<ul><li><a class="page-menu-link" href="#autoid_131" data-menu-target="autoid_131">Synopsis</a></li><li><a class="page-menu-link" href="#autoid_132" data-menu-target="autoid_132">Description</a></li></ul> </div><p>Deprecated: Use the <a href="ref_directive_setting.html#ref.setting.number_format"><code>number_format</code>
setting</a> and <a href="ref_builtins_number.html#ref_builtin_string_for_number">the
<code>string</code> built-in</a> instead. For formatting for
computer audience (i.e., no localized formatting) use the <a href="ref_builtins_number.html#ref_builtin_c"><code>c</code> built-in</a> (like
<code class="inline-code"><em class="code-color">number</em>?c</code>).</p>
<h2 class="content-header header-section2" id="autoid_131">Synopsis</h2>
<pre class="metaTemplate"><code class="inline-code">#{<em class="code-color">expression</em>}</code>
or
<code class="inline-code">#{<em class="code-color">expression</em>; <em class="code-color">format</em>}</code></pre>
<p>Where:</p>
<ul>
<li>
<code class="inline-code"><em class="code-color">expression</em></code>:
expression that can be evaluated as a number.
</li>
<li>
<code class="inline-code"><em class="code-color">format</em></code>:
optional format specifier.
</li>
</ul>
<h2 class="content-header header-section2" id="autoid_132">Description</h2>
<p>The numerical interpolation is used to output a number value.
If the expression doesn&#39;t evaluate to a number, the evaluation ends
with an error.</p>
<p>The optional format specifier specifies the minimum and the
maximum number of displayed fractional digits using syntax
<code class="inline-code">m<em class="code-color">min</em>M<em class="code-color">max</em></code>.
For example, <code class="inline-code">m2M5</code> means &quot;at least two, at most
five fractional digits&quot;. The minimum or the maximum specifier part
can be omitted. If only the minimum is specified, the maximum is
equal to the minimum. If only maximum is specified, the minimum is
0.</p>
<p>The decimal separator character of the output is
internationalized (according the current locale setting), which
means that it is not necessarily a dot.</p>
<p>Unlike <code class="inline-code">${...}</code>, <code class="inline-code">#{...}</code>
ignores the <a href="ref_directive_setting.html#ref.setting.number_format"><code>number_format</code>
setting</a>. This is actually a backward compatibility quirk, but
it can be useful when you print numbers in situations like
<code class="inline-code">&lt;a href=&quot;quertyDatabase?id=#{id}&quot;&gt;</code>, where
you surely don&#39;t want grouping separators or something fancy like
that. However, starting from FreeMarker 2.3.3 rather use the <a href="ref_builtins_number.html#ref_builtin_c"><code>?c</code> built-in</a> for
this purpose, like <code class="inline-code">&lt;a
href=&quot;quertyDatabase?id=${id?c}&quot;&gt;</code>.</p>
<p>Examples. Assume that <code class="inline-code">x</code> is
<code class="inline-code">2.582</code> and <code class="inline-code">y</code> is
<code class="inline-code">4</code>:</p>
<div class="code-wrapper"><pre class="code-block code-template"> &lt;#-- If the language is US English the output is: --&gt;
#{x} &lt;#-- 2.582 --&gt;
#{y} &lt;#-- 4 --&gt;
#{x; M2} &lt;#-- 2.58 --&gt;
#{y; M2} &lt;#-- 4 --&gt;
#{x; m1} &lt;#-- 2.6 --&gt;
#{y; m1} &lt;#-- 4.0 --&gt;
#{x; m1M2} &lt;#-- 2.58 --&gt;
#{y; m1M2} &lt;#-- 4.0 --&gt;</pre></div>
<div class="bottom-pagers-wrapper"><div class="pagers bottom"><a class="paging-arrow previous" href="ref_depr_oldsyntax.html"><span>Previous</span></a><a class="paging-arrow next" href="app.html"><span>Next</span></a></div></div></div></div> </div>
</div>
<div class="site-footer"><div class="site-width"><div class="footer-bottom"> <p class="last-generated">
Last generated:
<time itemprop="dateModified" datetime="2020-07-09T23:48:37Z" title="Thursday, July 9, 2020 11:48:37 PM GMT">2020-07-09 23:48:37 GMT</time> </p>
<p class="copyright">
© <span itemprop="copyrightYear">1999</span>–2020
<a itemtype="http://schema.org/Organization" itemprop="copyrightHolder" href="https://apache.org/">The Apache Software Foundation</a> </p>
</div></div></div></body>
</html>