Bump version, document new financial functions

Author: Blake-Madden

docs/TinyExpr++ReferenceManual.pdf

@@ -286,7 +286,6 @@ <h1 class="title"><span class="chapter-number">3</span>&nbsp; <span class="chapt
 
 
 <p>The following built-in functions are available:</p>
-<div>
 <table class="caption-top table">
 <caption>Math Functions</caption>
 <colgroup>
@@ -482,7 +481,6 @@ <h1 class="title"><span class="chapter-number">3</span>&nbsp; <span class="chapt
 </tr>
 </tbody>
 </table>
-</div>
 <div class="warningsection">
 <p><code>ISNA()</code> differs from some spreadsheet programs for certain expressions, such as divisions by zero. <em>TinyExpr++</em> will return true for this situation, while <em>Excel</em> will return false. This is because <em>Excel</em> distinguishes between <code>#DIV/0!</code> and <code>#N/A</code> errors, while <em>TinyExpr++</em> treats all invalid numbers (e.g., NaN, INF, -INF) as NaN.</p>
 </div>
@@ -647,14 +645,17 @@ <h1 class="title"><span class="chapter-number">3</span>&nbsp; <span class="chapt
 </tr>
 <tr class="even">
 <td style="text-align: left;">NOT(Value)</td>
-<td style="text-align: left;">Returns the logical negation of <em>Value.</em></td>
+<td style="text-align: left;">Returns the logical negation of <em>Value</em>.</td>
 </tr>
 <tr class="odd">
 <td style="text-align: left;">OR(Value1, Value2, …)</td>
 <td style="text-align: left;">Returns true if any condition is true.</td>
 </tr>
 </tbody>
 </table>
+<div class="warningsection">
+<p><code>AND</code> and <code>OR</code> ignore NaN arguments during evaluation, so results may differ from <em>Excel</em> when subexpressions resolve to NaN.</p>
+</div>
 </div>
 <div class="notesection">
 <p>The first argument to any logic function must be valid (i.e., not NaN). If the first argument evaluates to NaN, then NaN will be returned. Any subsequent arguments that evaluate to NaN will be ignored.</p>
@@ -674,6 +675,14 @@ <h1 class="title"><span class="chapter-number">3</span>&nbsp; <span class="chapt
 </thead>
 <tbody>
 <tr class="odd">
+<td style="text-align: left;">CUMIPMT(Rate, Periods, PresentValue, StartPeriod, EndPeriod, Type)</td>
+<td style="text-align: left;">Returns the cumulative interest paid on a loan between <em>StartPeriod</em> and <em>EndPeriod</em>, inclusive.<br>Type* specifies when payments are due: 0 = end of period, 1 = beginning of period.<br>NaN will be returned if <em>Rate</em> &lt;= 0, <em>Periods</em> &lt;= 0, <em>PresentValue</em> &lt;= 0, if <em>StartPeriod</em> or <em>EndPeriod</em> are out of range, or if <em>Type</em> is not 0 or 1.</td>
+</tr>
+<tr class="even">
+<td style="text-align: left;">CUMPRINC(Rate, Periods, PresentValue, StartPeriod, EndPeriod, Type)</td>
+<td style="text-align: left;">Returns the cumulative principal paid on a loan between <em>StartPeriod</em> and <em>EndPeriod</em>, inclusive.<br>Note that <em>Type</em> specifies when payments are due: 0 = end of period, 1 = beginning of period.<br>NaN will be returned if <em>Rate</em> &lt;= 0, <em>Periods</em> &lt;= 0, <em>PresentValue</em> &lt;= 0, if <em>StartPeriod</em> or <em>EndPeriod</em> are out of range, or if <em>Type</em> is not 0 or 1.</td>
+</tr>
+<tr class="odd">
 <td style="text-align: left;">DB(Cost, Salvage, Lifetime, Period, Month)</td>
 <td style="text-align: left;">Returns the depreciation of an asset for a specified period using the fixed-declining balance method.</td>
 </tr>
@@ -682,10 +691,30 @@ <h1 class="title"><span class="chapter-number">3</span>&nbsp; <span class="chapt
 <td style="text-align: left;">Returns the effective annual interest rate, provided the nominal annual interest rate and the number of compounding periods per year.<br>NaN will be returned if <em>Periods</em> is &lt; 1 or if <em>NominalRate</em> &lt;= 0.</td>
 </tr>
 <tr class="odd">
+<td style="text-align: left;">FV(Rate, Periods, Payment, [PresentValue], [Type])</td>
+<td style="text-align: left;">Returns the future value of an investment based on a constant interest rate, a fixed number of periods, and periodic payments.<br>Note that <em>PresentValue</em> and <em>Type</em> are optional and default to 0.<br>Also, <em>Type</em> specifies when payments are due: 0 = end of period, 1 = beginning of period.<br>NaN will be returned if <em>Periods</em> &lt;= 0 or if any required argument is not finite.</td>
+</tr>
+<tr class="even">
+<td style="text-align: left;">IPMT(Rate, Period, Periods, PresentValue, [FutureValue], [Type])</td>
+<td style="text-align: left;">Returns the interest portion of a payment for a specified period of an investment.<br>FutureValue* and <em>Type</em> are optional and default to 0.<br>Type* specifies when payments are due: 0 = end of period, 1 = beginning of period.</td>
+</tr>
+<tr class="odd">
 <td style="text-align: left;">NOMINAL(EffectiveRate, Periods)</td>
 <td style="text-align: left;">Returns the nominal annual interest rate, provided the effective rate and the number of compounding periods per year.<br>NaN will be returned if <em>Periods</em> is &lt; 1 or if <em>EffectiveRate</em> &lt;= 0.</td>
 </tr>
 <tr class="even">
+<td style="text-align: left;">NPER(Rate, Payment, PresentValue, [FutureValue], [Type])</td>
+<td style="text-align: left;">Returns the number of periods for an investment or loan based on a constant interest rate, periodic payments, and present and future values.<br>Note that <em>FutureValue</em> and <em>Type</em> are optional and default to 0.<br>Also, <em>Type</em> specifies when payments are due: 0 = end of period, 1 = beginning of period.<br>NaN will be returned if any required argument is not finite or if the calculation is not defined.</td>
+</tr>
+<tr class="odd">
+<td style="text-align: left;">PMT(Rate, Periods, PresentValue, [FutureValue], [Type])</td>
+<td style="text-align: left;">Returns the periodic payment for an investment or loan based on a constant interest rate, a fixed number of periods, and a present value.<br>Note that <em>FutureValue</em> and <em>Type</em> are optional and default to 0.<br>Also, <em>Type</em> specifies when payments are due: 0 = end of period, 1 = beginning of period.<br>NaN will be returned if <em>Periods</em> &lt;= 0 or if any required argument is not finite.</td>
+</tr>
+<tr class="even">
+<td style="text-align: left;">PPMT(Rate, Period, Periods, PresentValue, [FutureValue], [Type])</td>
+<td style="text-align: left;">Returns the principal portion of a payment for a specified period of an investment.<br>Note that <em>FutureValue</em> and <em>Type</em> are optional and default to 0.<br>Also, <em>Type</em> specifies when payments are due: 0 = end of period, 1 = beginning of period.<br>NaN will be returned if arguments are invalid or out of range.</td>
+</tr>
+<tr class="odd">
 <td style="text-align: left;">PV(Rate, Periods, Payment, [FutureValue], [Type])</td>
 <td style="text-align: left;">Returns the present value of an investment based on a constant interest rate, a fixed number of periods, and periodic payments.<br>Note that <em>FutureValue</em> and <em>Type</em> are optional and default to 0.<br>Also, <em>Type</em> specifies when payments are due: 0 = end of period, 1 = beginning of period.<br>NaN will be returned if <em>Periods</em> &lt;= 0 or if any required argument is not finite.</td>
 </tr>

docs/functions.html

@@ -7,7 +7,7 @@
 <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
 
 <meta name="author" content="Blake Madden">
-<meta name="dcterms.date" content="2026-01-09">
+<meta name="dcterms.date" content="2026-01-16">
 
 <title>TinyExpr++</title>
 <style>
@@ -290,7 +290,7 @@ <h1 class="title">TinyExpr++</h1>
     <div>
     <div class="quarto-title-meta-heading">Published</div>
     <div class="quarto-title-meta-contents">
-      <p class="date">January 9, 2026</p>
+      <p class="date">January 16, 2026</p>
     </div>
   </div>
 

docs/index.html

@@ -298,15 +298,15 @@ <h1 class="title"><span class="chapter-number">11</span>&nbsp; <span class="chap
 <p><code>te_parser::evaluate()</code> uses a simple recursive descent parser to compile your expression into a syntax tree. For example, the expression <code>"sin x + 1/4"</code> parses as:</p>
 <div class="cell">
 <div class="cell-output-display">
-<div class="grViz html-widget html-fill-item" id="htmlwidget-1e6a6c17d3ab866b9d2a" style="width:100%;height:480px;"></div>
-<script type="application/json" data-for="htmlwidget-1e6a6c17d3ab866b9d2a">{"x":{"diagram":"digraph {\n  graph [layout = dot, rankdir = TB]\n  \n  node [shape = oval]        \n  node1 [label = \"+\"]\n  node2 [label = \"sin\"]\n  node3 [label =  \"÷\", style=filled, fillcolor = \"#add8e6\"]\n  node4 [label = \"x\"]\n  node5 [label = \"1\", style=filled, fillcolor = \"#add8e6\"]\n  node6 [label = \"4\", style=filled, fillcolor = \"#add8e6\"]\n  \n  # edge definitions with the node IDs\n  node1 -> node2 -> node4\n  node1 -> node3\n  node3 -> node5\n  node3 -> node6\n  }","config":{"engine":"dot","options":null}},"evals":[],"jsHooks":[]}</script>
+<div class="grViz html-widget html-fill-item" id="htmlwidget-5d2d794c9980d0a90980" style="width:100%;height:480px;"></div>
+<script type="application/json" data-for="htmlwidget-5d2d794c9980d0a90980">{"x":{"diagram":"digraph {\n  graph [layout = dot, rankdir = TB]\n  \n  node [shape = oval]        \n  node1 [label = \"+\"]\n  node2 [label = \"sin\"]\n  node3 [label =  \"÷\", style=filled, fillcolor = \"#add8e6\"]\n  node4 [label = \"x\"]\n  node5 [label = \"1\", style=filled, fillcolor = \"#add8e6\"]\n  node6 [label = \"4\", style=filled, fillcolor = \"#add8e6\"]\n  \n  # edge definitions with the node IDs\n  node1 -> node2 -> node4\n  node1 -> node3\n  node3 -> node5\n  node3 -> node6\n  }","config":{"engine":"dot","options":null}},"evals":[],"jsHooks":[]}</script>
 </div>
 </div>
 <p><code>te_parser::evaluate()</code> also automatically prunes constant branches. In this example, the compiled expression returned by <code>compile()</code> would become:</p>
 <div class="cell">
 <div class="cell-output-display">
-<div class="grViz html-widget html-fill-item" id="htmlwidget-35809605711a92c72d63" style="width:100%;height:480px;"></div>
-<script type="application/json" data-for="htmlwidget-35809605711a92c72d63">{"x":{"diagram":"digraph {\n  graph [layout = dot, rankdir = TB]\n  \n  node [shape = oval]        \n  node1 [label = \"+\"]\n  node2 [label = \"sin\"]\n  node3 [label =  \"0.25\", style=filled, fillcolor = \"#add8e6\"]\n  node4 [label = \"x\"]\n\n  # edge definitions with the node IDs\n  node1 -> node2 -> node4\n  node1 -> node3\n  }","config":{"engine":"dot","options":null}},"evals":[],"jsHooks":[]}</script>
+<div class="grViz html-widget html-fill-item" id="htmlwidget-e030c04f6658a9d543e3" style="width:100%;height:480px;"></div>
+<script type="application/json" data-for="htmlwidget-e030c04f6658a9d543e3">{"x":{"diagram":"digraph {\n  graph [layout = dot, rankdir = TB]\n  \n  node [shape = oval]        \n  node1 [label = \"+\"]\n  node2 [label = \"sin\"]\n  node3 [label =  \"0.25\", style=filled, fillcolor = \"#add8e6\"]\n  node4 [label = \"x\"]\n\n  # edge definitions with the node IDs\n  node1 -> node2 -> node4\n  node1 -> node3\n  }","config":{"engine":"dot","options":null}},"evals":[],"jsHooks":[]}</script>
 </div>
 </div>
 <section id="grammar" class="level2 unnumbered">

docs/technical-overview.html

@@ -79,12 +79,12 @@
 #include <type_traits>
 
 constexpr int TINYEXPR_CPP_MAJOR_VERSION = 1;
-constexpr int TINYEXPR_CPP_MINOR_VERSION = 0;
-constexpr int TINYEXPR_CPP_PATCH_VERSION = 1;
-constexpr int TINYEXPR_CPP_TWEAK_VERSION = 1;
+constexpr int TINYEXPR_CPP_MINOR_VERSION = 1;
+constexpr int TINYEXPR_CPP_PATCH_VERSION = 0;
+constexpr int TINYEXPR_CPP_TWEAK_VERSION = 0;
 #define TINYEXPR_CPP_COPYRIGHT                                                                     \
     "TinyExpr: Copyright (c) 2015-2020 Lewis Van Winkle\n"                                         \
-    "TinyExpr++: Copyright (c) 2020-2025 Blake Madden"
+    "TinyExpr++: Copyright (c) 2020-2026 Blake Madden"
 
 class te_parser;