Yscript Funktionen 2023-03-22

Intern



super()                 // Aufruf der geerbten Funktion (Parameter angeben!)

new( $classname ) // Erstellt eine neue Instanz der Klasse $classname
set( $var ) // Liefert true, wenn die Variable existiert

global( $var ) // Variable global verfügbar machen
static( $var ) // Macht eine oder mehrere Variablen statisch (Werte bleiben
// auch bei verlassen und neu betreten des Levels erhalten).

deb( $text ) // Debug-Textausgabe
din( [$text] ) // Debug-Texteingabe

dump( $var ) // Details über $var ausgeben
dumpenv() // Alle Variablen der aktuellen Funktion ausgeben

iif( $val, $yes, $no ) // Liefert $yes wenn $val, sonst $no




Typecasting



int( $data )            // In Integer umwandeln
str( $data ) // In String umwandeln

bool( $data ) // In Boolean umwandeln
byte( $data ) // In Byte umwandeln
float( $data ) // In Float umwandeln

uvar( $data ) // In Unbestimmt umwandeln (nicht empfohlen)




Mathematisch



sin( $num )             // Sinus
cos( $num ) // Kosinus
tan( $num ) // Tangens

asin( $num ) // Arkussinus
acos( $num ) // Arkuskosinus
atan( $num ) // Arkustangens

pow( $base, $exp ) // Entspricht $base^$exp
sqr( $base, [$rad] ) // Wurzelziehen (Standard = 2)
log( $num, [$base] ) // Logarithmus (Standard = e)
exp( $num ) // Potenziert e mit $num
fac( $num ) // Fakultät von $num

abs( $num ) // Absolutwert
sig( $num ) // Signum

dechex( $num ) // Hex-Wert ausgeben (Grossbuchstaben)
hexdec( $num ) // Dezimalwert ausgeben (alternativ mit 0x notieren)




Runden



round( $num, [$digits] )        // Mathematische Rundung
cround( $num, [$digits] ) // Kaufmännisches Runden (0.5 aufrunden)

fix( $num, [$digits] ) // Richtung Null runden
floor( $num, [$digits] ) // Abwärts runden
ceil( $num, [$digits] ) // Aufwärts runden




Zufallszahlen



srand( [$num] )                 // Initialisiert den Zufallsgenerator
// Ohne Angabe wird die Systemzeit in ms verwendet

rnd() // Zufallszahl von 0 bis 1 (exklusive)
rnd( $max ) // Zahl von 0 bis $max (exklusive)
rnd( $min, $max ) // Zahl von $min bis $max (exklusive)
rnd( $min, $max, $pow ) // Zufall mit exponentieller Verteilung
// (negatives $pow invertiert die Kurve)

rand( ... ) // Wie rnd(), aber mit Ganzzahlen und $max inklusive
// z.B. $dice = rand( 1, 6 );

lastrnd() // Liefert die zuletzt generierte Zufallszahl
lastrand() // Liefert die zuletzt generierte Zufalls-Ganzzahl




Strings



asc( $char )                    // ASCII-Code des Chars ausgeben
chr( $char ) // ASCII-Code in Char umwandeln

ucase( $text ) // Alles Grossbuchstaben
lcase( $text ) // Alles Kleinbuchstaben
trim( $text, [$char] ) // Randbuchstaben entfernen (Standard = " ")
repeat( $text, $count ) // String mehrfach wiederholen

strlen( $text ) // Anzahl Zeichen im Text
substr( $text, $pos, $length ) // Teilstring auslesen
replace( $from, $to, $text ) // Strings ersetzen
trans( $text, $args... ) // Argumente [1], [2], [3],... durch Werte ersetzen

strpos( $text, $find ) // Erste Position des Strings (oder -1)
stripos( $text, $find ) // Erste Position des Strings (oder -1, insensitiv)
strrpos( $text, $find ) // Letzte Position des Strings (oder -1)
strripos( $text, $find ) // Letzte Position des Strings (oder -1, insensitiv)




Arrays



count( $list )                   // Anzahl Elemente im Array

push( $list, $value, [$pos] ) // Speichert $value bei $pos oder am Ende von $list
pop( $list, [$pos] ) // Entfernt das angegebene / letzte Element aus $list
pop( $list, $name ) // Entfernt das angegebene Element aus $list (hierbei
// wird die Reihenfolge der Elemente verändert)

indexName( $list, $value ) // Liefert den Index-Namen des Feldes
Kategorien: Entwicklerhilfe