Funciones

Traducción automática

Esta página se tradujo automáticamente del inglés y todavía no la revisó un hablante nativo; las correcciones son bienvenidas en GitHub. Si algo no coincide, vale el original en inglés.

Tarea: escribir un cálculo una sola vez y usarlo donde la página lo necesite.

yaml

# Recipe: a q:function, called from attributes and from the HTML.
paths:
  components: ./components

Un q:function recibe q:params como una acción: en cada llamada, cada argumento se convierte a su tipo y se verifica contra sus reglas, y default completa el que falta. returnType verifica lo que se devuelve. Una función se puede llamar en cualquier expresión de la página, incluso dentro de otra llamada.

xml

<q:component name="Prices">
  <!-- Arguments are checked against the q:params on every call. -->
  <q:function name="withTax" returnType="number">
    <q:param name="amount" type="number" required="true" min="0" />
    <q:param name="rate" type="number" default="0.1" />
    <q:return value="{round(amount * (1 + rate), 2)}" />
  </q:function>

  <q:function name="label">
    <q:param name="amount" type="number" required="true" />
    <q:return value="{'free' if amount == 0 else '$' + str(amount)}" />
  </q:function>

  <q:set name="book" value="{withTax(20)}" />

  <html>
  <body>
    <p>Book: {label(book)}</p>
    <p>Food: {label(withTax(10, 0.05))}</p>
    <p>Sample: {label(withTax(0))}</p>
  </body>
  </html>
</q:component>

xml

<q:test name="a function called from q:set and from the HTML" page="/">
  <test:visit />
  <test:expect var="book" value="22.0" />
  <test:expect text="Book: $22.0" />
</q:test>

<q:test name="an argument by position replaces the default" page="/">
  <test:visit />
  <test:expect text="Food: $10.5" />
</q:test>

<q:test name="functions compose" page="/">
  <test:visit />
  <test:expect text="Sample: free" />
</q:test>

text

tests/prices.test.q
  PASS  a function called from q:set and from the HTML
  PASS  an argument by position replaces the default
  PASS  functions compose
3 passed, 0 failed

Ver FN-1, FN-3 y FN-4.

Funciones ​

Funciones