{"route":"/en-US-v0.14.1/reference/math/frac/","title":"Fraction","description":"Documentation for the `frac` function.","part":null,"outline":[{"id":"summary","name":"Summary","children":[]},{"id":"example","name":"Example","children":[]},{"id":"syntax","name":"Syntax","children":[]},{"id":"parameters","name":"Parameters","children":[{"id":"parameters-num","name":"num","children":[]},{"id":"parameters-denom","name":"denom","children":[]},{"id":"parameters-style","name":"style","children":[]}]}],"body":{"kind":"func","content":{"path":["math"],"name":"frac","title":"Fraction","keywords":[],"oneliner":"A mathematical fraction.","element":true,"contextual":false,"deprecationMessage":null,"deprecationUntil":null,"details":[{"kind":"html","content":"<p>A mathematical fraction.</p>\n<h2 id=\"example\">Example</h2>\n<div class=\"previewed-code\"><pre><code><span class=\"typ-math-delim\">$</span> 1<span class=\"typ-math-op\">/</span>2 &lt; <span class=\"typ-punct\">(</span>x+1<span class=\"typ-punct\">)</span><span class=\"typ-math-op\">/</span>2 <span class=\"typ-math-delim\">$</span>\n<span class=\"typ-math-delim\">$</span> <span class=\"typ-punct\">(</span>(x+1)<span class=\"typ-punct\">)</span> <span class=\"typ-math-op\">/</span> 2 = <span class=\"typ-func\">frac</span><span class=\"typ-punct\">(</span>a<span class=\"typ-punct\">,</span> b<span class=\"typ-punct\">)</span> <span class=\"typ-math-delim\">$</span>\n</code></pre><div class=\"preview\"><img src=\"/en-US-v0.14.1/assets/f5116cafe55239b89e94f6f836bafecd.png\" alt=\"Preview\"></div></div>\n<h2 id=\"syntax\">Syntax</h2>\n<p>This function also has dedicated syntax: Use a slash to turn neighbouring\nexpressions into a fraction. Multiple atoms can be grouped into a single\nexpression using round grouping parentheses. Such parentheses are removed\nfrom the output, but you can nest multiple to force them.</p>"}],"self":false,"params":[{"name":"num","details":[{"kind":"html","content":"<p>The fraction's numerator.</p>"}],"types":["content"],"strings":[],"default":null,"positional":true,"named":false,"required":true,"variadic":false,"settable":false},{"name":"denom","details":[{"kind":"html","content":"<p>The fraction's denominator.</p>"}],"types":["content"],"strings":[],"default":null,"positional":true,"named":false,"required":true,"variadic":false,"settable":false},{"name":"style","details":[{"kind":"html","content":"<p>How the fraction should be laid out.</p>"},{"kind":"example","content":{"body":"<div class=\"previewed-code\"><pre><code><span class=\"typ-math-delim\">$</span> <span class=\"typ-func\">frac</span><span class=\"typ-punct\">(</span>x<span class=\"typ-punct\">,</span> y<span class=\"typ-punct\">,</span> style<span class=\"typ-punct\">:</span> <span class=\"typ-str\">&quot;vertical&quot;</span><span class=\"typ-punct\">)</span> <span class=\"typ-math-delim\">$</span>\n<span class=\"typ-math-delim\">$</span> <span class=\"typ-func\">frac</span><span class=\"typ-punct\">(</span>x<span class=\"typ-punct\">,</span> y<span class=\"typ-punct\">,</span> style<span class=\"typ-punct\">:</span> <span class=\"typ-str\">&quot;skewed&quot;</span><span class=\"typ-punct\">)</span> <span class=\"typ-math-delim\">$</span>\n<span class=\"typ-math-delim\">$</span> <span class=\"typ-func\">frac</span><span class=\"typ-punct\">(</span>x<span class=\"typ-punct\">,</span> y<span class=\"typ-punct\">,</span> style<span class=\"typ-punct\">:</span> <span class=\"typ-str\">&quot;horizontal&quot;</span><span class=\"typ-punct\">)</span> <span class=\"typ-math-delim\">$</span>\n</code></pre><div class=\"preview\"><img src=\"/en-US-v0.14.1/assets/adbbde92be4a9ecb70cea4b022138cb0.png\" alt=\"Preview\"></div></div>","title":"Styles"}},{"kind":"example","content":{"body":"<div class=\"previewed-code\"><pre><code><span class=\"typ-key\">#</span><span class=\"typ-key\">set</span> math<span class=\"typ-punct\">.</span><span class=\"typ-func\">frac</span><span class=\"typ-punct\">(</span>style<span class=\"typ-punct\">:</span> <span class=\"typ-str\">&quot;skewed&quot;</span><span class=\"typ-punct\">)</span>\n<span class=\"typ-math-delim\">$</span> a <span class=\"typ-math-op\">/</span> b <span class=\"typ-math-delim\">$</span>\n</code></pre><div class=\"preview\"><img src=\"/en-US-v0.14.1/assets/b7782dadccd0f86cb1c908ded011607.png\" alt=\"Preview\"></div></div>","title":"Setting the default"}},{"kind":"example","content":{"body":"<div class=\"previewed-code\"><pre><code><span class=\"typ-comment\">// Grouping parentheses are removed.</span>\n<span class=\"typ-key\">#</span><span class=\"typ-key\">set</span> math<span class=\"typ-punct\">.</span><span class=\"typ-func\">frac</span><span class=\"typ-punct\">(</span>style<span class=\"typ-punct\">:</span> <span class=\"typ-str\">&quot;vertical&quot;</span><span class=\"typ-punct\">)</span>\n<span class=\"typ-math-delim\">$</span> <span class=\"typ-punct\">(</span>a + b<span class=\"typ-punct\">)</span> <span class=\"typ-math-op\">/</span> b <span class=\"typ-math-delim\">$</span>\n\n<span class=\"typ-comment\">// Grouping parentheses are removed.</span>\n<span class=\"typ-key\">#</span><span class=\"typ-key\">set</span> math<span class=\"typ-punct\">.</span><span class=\"typ-func\">frac</span><span class=\"typ-punct\">(</span>style<span class=\"typ-punct\">:</span> <span class=\"typ-str\">&quot;skewed&quot;</span><span class=\"typ-punct\">)</span>\n<span class=\"typ-math-delim\">$</span> <span class=\"typ-punct\">(</span>a + b<span class=\"typ-punct\">)</span> <span class=\"typ-math-op\">/</span> b <span class=\"typ-math-delim\">$</span>\n\n<span class=\"typ-comment\">// Grouping parentheses are retained.</span>\n<span class=\"typ-key\">#</span><span class=\"typ-key\">set</span> math<span class=\"typ-punct\">.</span><span class=\"typ-func\">frac</span><span class=\"typ-punct\">(</span>style<span class=\"typ-punct\">:</span> <span class=\"typ-str\">&quot;horizontal&quot;</span><span class=\"typ-punct\">)</span>\n<span class=\"typ-math-delim\">$</span> <span class=\"typ-punct\">(</span>a + b<span class=\"typ-punct\">)</span> <span class=\"typ-math-op\">/</span> b <span class=\"typ-math-delim\">$</span>\n</code></pre><div class=\"preview\"><img src=\"/en-US-v0.14.1/assets/6c380fbf39a19a0853239e3e728a9c3f.png\" alt=\"Preview\"></div></div>","title":"Handling of grouping parentheses"}},{"kind":"example","content":{"body":"<div class=\"previewed-code\"><pre><code><span class=\"typ-comment\">// This changes the style for inline equations only.</span>\n<span class=\"typ-key\">#</span><span class=\"typ-key\">show</span> math<span class=\"typ-punct\">.</span>equation<span class=\"typ-punct\">.</span><span class=\"typ-func\">where</span><span class=\"typ-punct\">(</span>block<span class=\"typ-punct\">:</span> <span class=\"typ-key\">false</span><span class=\"typ-punct\">)</span><span class=\"typ-punct\">:</span> <span class=\"typ-key\">set</span> math<span class=\"typ-punct\">.</span><span class=\"typ-func\">frac</span><span class=\"typ-punct\">(</span>style<span class=\"typ-punct\">:</span> <span class=\"typ-str\">&quot;horizontal&quot;</span><span class=\"typ-punct\">)</span>\n\nThis <span class=\"typ-math-delim\">$</span><span class=\"typ-punct\">(</span>x<span class=\"typ-escape\">-</span>y<span class=\"typ-punct\">)</span><span class=\"typ-math-op\">/</span>z = 3<span class=\"typ-math-delim\">$</span> is inline math, and this is block math:\n<span class=\"typ-math-delim\">$</span> <span class=\"typ-punct\">(</span>x<span class=\"typ-escape\">-</span>y<span class=\"typ-punct\">)</span><span class=\"typ-math-op\">/</span>z = 3 <span class=\"typ-math-delim\">$</span>\n</code></pre><div class=\"preview\"><img src=\"/en-US-v0.14.1/assets/914e283a2106990297213ff752860c0f.png\" alt=\"Preview\"></div></div>","title":"Different styles in inline vs block equations"}}],"types":["str"],"strings":[{"string":"vertical","details":"<p>Stacked numerator and denominator with a bar.</p>"},{"string":"skewed","details":"<p>Numerator and denominator separated by a slash.</p>"},{"string":"horizontal","details":"<p>Numerator and denominator placed inline and parentheses are not\nabsorbed.</p>"}],"default":"<code><span class=\"typ-str\">&quot;vertical&quot;</span></code>","positional":false,"named":true,"required":false,"variadic":false,"settable":true}],"returns":["content"],"scope":[]}}}