Funktionen

Stringfunktionen

STRLEN()

STRLEN (string) liefert die Zeichenanzahl von string.

STR()

Konvertiert einen numerischen Wert oder Ausdruck in einen String, Es gibt 2 Varianten des STR() Befehls:

1. man gibt die Gesamtanzahl an Zeichen und dieFlags Anzahl an Zeichen nach dem Dezimalpunkt an
2. ein Format-String steuert die Konvertierung, mit mehr Einstellungsmöglichkeiten und einer möglichen automatischen Einheitenumrechnung

STR (numeric_expression, length, fractions)

oder

STR (format_string, numeric_expr)

numeric_expr: numerischer Ausdruck.

length: Gesamtanzahl Zeichen

fractions: Anzahl Zeichen nach dem Dezimalpunkt

format_string: Format-String mit folgender Syntax:

%[flags][length][.decimal_place] conv_spec

flags: können kombiniert werden

• (none): rechtsbündig (Standard)
• -: linkssbündig
• +: "+" Zeichen vor positiven Werten
• (Leerzeichen>: Leerzeichen statt "+" vor positiven Werten
• #: "0" vor dem Dezimalpunkt nicht anzeigen (kein Wirkung bei Bruchzahlen)
• 0: auch 0 inch zeigen, nur bei inch Einheiten mit Bruchzahlen
• ~: Nullen am Ende des Dezimalteils nicht anzeigen (kein Wirkung bei Bruchzahlen)
• ^: unterdrückt den automatischen Tausch von Dezimalpunkt "." und Tausendertrennzeichen "," entsprechend den Lokalisierungseinstellungen

length: Mindestlänge des generierten Strings

decimal_place: Anzahl von Dezimalstellen

conv_spec:Konvertierungsart, numeric_expr wird von der aktuellen Allplaneinheit, in die angegebene Einheit umgerechnet.

Längen

• e: Exponentialformat (Meter)
• m: Meter
• mm: Millimeter
• cm: Zentimeter
• ffi: feet und inches als Bruchzahl
• fdi: feet und inches als Dezimalzahl
• df: feet als Dezimalzahl
• fi: inches als Bruchzahl
• di: inches als Dezimalzahl

Flächen

• sqm: Quadratmeter
• sqcm: Quadratzentimeter
• sqmm: Quadratmillimeter
• sqf: square feet
• sqi: square inches

Winkel

• dd: Dezimal Grad
• dms: Grad, Minuten, Sekunden
• gr: Neugrad
• rad: Bogenmaß
• surv: surveyors unit (Vermessereinheit?)

Volumen

• cum: Kubikmeter
• l: Liter
• cucm: Kubikzentimeter
• cumm: Kubikmillimeter
• cuf: cubic feet
• cui: cubic inches
• cuy: cubic yards
• gal: gallons

STRSUB()

STRSUB(string, start, num) liefert num Zeichen aus string ab Position start als String zurück.

STRSTR()

STRSTR(input_string, search_string) liefert die Position des ersten Auftretens von search_string in input_string, oder 0 wenn search_string nicht gefunden wird. Die Suche unterscheidet zwischen Groß- und Kleinschreibung.

SPLIT()

SPLIT(string, format, var1[, var2, ...]) teilt den Eingabestring in einzelne Teile und weist diese verschiedenen Variablen zu. Die Aufteilung des Strings wird durch einen Formatstring gesteuert. %s steht für ein Wort begrenzt durch Leerzeichen oder Tabs, %n steht für einen numerischen Wert (Dezimalpunkt='.'), alle nicht durch Platzhalter abgedeckten Teile des Eingabestrings, müssen mit dem Formatstring übereinstimmen, sonst bricht die Verarbeitung ab. Die Funktion liefert als Rückgabewert die Anzahl der erfolgreich ermittelten Werte.

n = SPLIT("Entfernung: 5.4 km", "Entfernung: %n %s", value, unit)

value = 5.4

unit = "km"

n = 2

STW()

Liefert die ungefähre Breite eines Strings, abhängig vom aktuell gesetzten Textstil. Zumindest lt. Dokumentation, in Wirklichkeit wird einfach die Stringlänge mit der Texthöhe multipliziert, so als ob alle Zeichen gleich breit wären, und diese Zeichenbreite der Zeichenhöhe entsprechen würde, dass ist selbst für nicht proportionale Fonts nur selten richtig, und für proportionale Fonts ist das einfach komplett falsch.

STW (string)

Arithmetische Funktionen

• ABS (x) liefert den Absolutbetrag von x.
• CEIL (x) liefert den nächst größeren Ganzzahlwert von x.
• INT (x) liefert den Ganzzahlwert von x.
• FRAC (x) liefert den Dezimalteil von x.
• ROUND_INT (x) liefert die gerundete Ganzahl von x.
• SGN (x) liefert -1 für x<0, +1 für x>0 sonst 0.
• SQR (x) liefert die Quadratwurzel von x.
• EXP (x) liefert e^x.
• LOG (x) liefert Logarithmus von x (Basis 10).
• LN (x) liefert natürlichen Logarithmus von x (Basis e).

Winkelfunktionen

Alle Winkelparameter und Resultate in Grad (Kreis = 360°).

• SIN (x) liefert den Sinus von x.
• COS (x) liefert den Cosinus von x.
• TAN (x) liefert den Tangens von x.
• ASIN (x) liefert den ArcusSinus von x.
• ACOS (x) liefert den ArcusCosinus von x.
• ATAN (x) liefert den ArcusTangens von x.
• PI liefert die Kreiszahl PI=3.1415....

Statistische Funktionen

• MIN (x1, x2, x3, ...) liefert den kleinsten Wert der Argumente.
• MAX (x1, x2, x3, ...) liefert den größten Wert der Argumente.
• RND (x) liefert einen Zufallswert zwischen 0 und x.

Bitfunktionen

• BITSET (x, b[, expr]) setzt das Bit b von x auf 0 wenn expr = 0 ist, sonst auf 1.
• BITTEST (x, b) liefert 1 wenn das Bit b von x gesetzt ist, sonst 0.