Funktioner

Dynamiske udtryk bliver mere effektive, når du bruger funktioner. Disse indbyggede værktøjer hjælper dig med at udføre beregninger, transformere tekst og formatere data, så du kan skabe mere dynamisk og personligt tilpasset indhold.

Hvad er funktioner?

Funktioner i dynamiske udtryk er særlige kommandoer, der tager inputværdier (kaldet argumenter) og returnerer et resultat. De kan bruges til matematiske operationer, tekstmanipulation og logikbaserede beslutninger.

Funktioner skrives inden for krøllede parenteser {{ ... }} og kan kombineres med datavariabler, literaler og operatorer.

Eksempel: {{ ROUND(AVERAGE(sessionUser.stats.likes, 10)) }} – dette eksempel beregner gennemsnittet af brugerens samlede antal likes og tallet 10 og afrunder resultatet til nærmeste heltal.

Funktioner til tekstmanipulation

• UPPERCASE(text): Konverterer teksten til store bogstaver.
  • Eksempel: {{ UPPERCASE("hello world") }} → "HELLO WORLD" (tekst)
• LOWERCASE(text): Konverterer teksten til små bogstaver.
  • Eksempel: {{ LOWERCASE("HELLO") }} → "hello" (tekst)
• CAPITALIZE(text): Skriver strengens første bogstav med stort.
  • Eksempel: {{ CAPITALIZE("ideanote") }} → "Ideanote" (tekst)
• TRIM(text): Fjerner mellemrum i begyndelsen og slutningen af strengen.
  • Eksempel: {{ TRIM(" idea collection ") }} → "idesamling" (tekst)
• REPLACE(text, search, replace): Erstatter en del af en streng med en anden streng.
  • Eksempel: {{ REPLACE("Innovation Hub", "Hub", "Center") }} → "Innovation Center" (tekst)
• TRUNCATE(text, length): Forkorter en streng til en bestemt længde.
  • Eksempel: {{ TRUNCATE("Welcome to the innovation program!", 10) }} → "Welcome to..." (tekst)
• CONCAT(...strings): Kombinerer flere tekststrenge til én.
  • Eksempel: {{ CONCAT("Hello, ", "world") }} → "hello, world" (tekst)
• REPEAT(text, count): Gentager en streng et bestemt antal gange.
  • Eksempel: {{ REPEAT("Hi! ", 3) }} → "Hi! Hi! Hi!" (tekst)
• APPEND(text, suffix): Tilføjer et suffiks i slutningen af en streng.
  • Eksempel: {{ APPEND("hello", ", world") }} → "hello, world" (tekst)
• PREPEND(text, prefix): Tilføjer et præfiks i begyndelsen af en streng.
  • Eksempel: {{ PREPEND("world", "hello, ") }} → "hello, world" (tekst)
• STARTS_WITH(text, search): Angiver, om en streng begynder med en anden streng.
  • Eksempel: {{ STARTS_WITH("hello", "he") }} → true (boolesk)
• ENDS_WITH(text, search): Angiver, om en streng slutter med en anden streng.
  • Eksempel: {{ ENDS_WITH("hello", "lo") }} → true (boolesk)
• INCLUDES(text, search): Kontrollerer, om en streng indeholder en anden streng.
  • Eksempel: {{ INCLUDES("hello", "ell") }} → true (boolesk)
• LENGTH(text): Returnerer tekstens længde.
  • Eksempel: {{ LENGTH("Ideas") }} → 5 (tal)

Matematiske funktioner

• ABS(number): Returnerer den absolutte (ikke-negative) værdi af et tal.
  • Eksempel: {{ ABS(-15) }} → 15 (tal)
• ADD(...numbers): Returnerer summen af en liste med tal.
  • Eksempel: {{ ADD(1, 2, 3) }} → 6 (tal)
• SUBTRACT(number, subtrahend): Returnerer resultatet af at trække to tal fra hinanden.
  • Eksempel: {{ SUBTRACT(10, 2) }} → 8 (tal)
• MULTIPLY(number, multiplier): Returnerer resultatet af at gange to tal med hinanden.
  • Eksempel: {{ MULTIPLY(2, 3) }} → 6 (tal)
• DIVIDE(number, divisor): Dividerer et tal med et andet.
  • Eksempel: {{ DIVIDE(10, 2) }} → 5 (tal)
• MOD(number, divisor): Returnerer resten ved division af to tal.
  • Eksempel: {{ MOD(10, 3) }} → 1 (tal)
• ROUND(number): Afrunder et tal til nærmeste heltal.
  • Eksempel: {{ ROUND(4.7) }} → 5 (tal)
• CEIL(number): Returnerer det mindste heltal, der er større end eller lig med et tal.
  • Eksempel: {{ CEIL(1.5) }} → 2 (tal)
• FLOOR(number): Returnerer det største heltal, der er mindre end eller lig med et tal.
  • Eksempel: {{ FLOOR(1.5) }} → 1 (tal)
• MAX(...numbers): Returnerer det største tal fra listen.
  • Eksempel: {{ MAX(10, 20, 5) }} → 20 (tal)
• MIN(...numbers): Returnerer det mindste tal fra listen.
  • Eksempel: {{ MIN(10, 20, 5) }} → 5 (tal)
• POW(number, exponent): Returnerer resultatet af at opløfte et tal i et andet tals potens.
  • Eksempel: {{ POW(2, 3) }} → 8 (tal)
• AVERAGE(...numbers): Returnerer gennemsnittet af en liste med tal.
  • Eksempel: {{ AVERAGE(1, 2, 3) }} → 2 (tal)

Formaterings- og hjælpefunktioner

• FORMAT(value): Formaterer en værdi (såsom et tal eller en dato) ud fra brugerens præferencer.
  • Eksempel: {{ FORMAT(10000) }} → "10,000" (tekst)
• PREFIX(text, prefix): Tilføjer et præfiks i begyndelsen af en streng.
  • Eksempel: {{ PREFIX("world", "hello, ") }} → "hello, world" (tekst)
• SUFFIX(text, suffix): Tilføjer et suffiks i slutningen af en streng.
  • Eksempel: {{ SUFFIX("hello", ", world") }} → "hello, world" (tekst)

Tip til fejlhåndtering

1. Kontrollér for null-værdier: Sørg for, at de variabler, du bruger, findes.
2. Undgå at dividere med nul: Brug MAX til at sikre, at divisorer aldrig er nul, for eksempel ved at skrive {{ DIVIDE(10, MAX(value, 1)) }}.
3. Sørg for, at parenteserne stemmer: Sørg for, at alle funktioner og betingelser har matchende parenteser.
4. Gennemgå fejlmeddelelser: Hvis du holder markøren over en værdi med teksten "Ikke beregnet" i dit workspace, kan det give et fingerpeg om den underliggende årsag.

Ved at mestre disse funktioner kan du forvandle dit workspace til et fuldt dynamisk, personaliseret og effektivt miljø, der tilpasser sig brugerinput og data.