Integrierte Funktionen

Numerische Funktionen

Randomize-Anweisung Initialisiert den Zufallsgenerator.
Syntax Randomize [NumAusdruck]
NumAusdruck                         Beliebiger numerischer Ausdruck, der den Zufallesgenerator initialisiert. Wird NumAusdruck nicht mit angegeben, wird der Zufallsgenerator mit dem Wert des System-Timers initialisiert.

 

Rnd-Funktion    Ermittelt einen Zufallswert zwischen 0 und 1.
Syntax Rnd[(IntAusdruck)]
IntAusdruck Integer-Ausdruck (ganzzahliger Ausdruck), der bestimmt, auf welche Art und Weise Zufallszahlen generiert werden sollen. Die Rnd-Funktion liefert grundsätzlich nur Werte zwischen 0 und 1. Um Zufallszahlen ohne Nachkommastellen in bestimmten Zahlenbereichen zu generieren, können Sie sich folgender Formel bedienen:

Zufallszahl=Int((Obergrenze-Untergrenze+1)*Rnd(Argument)+Untergrenze)

 

Fix-Funktion Liefert die Vorkommazahl eines numerischen Ausdrucks durch Abschneiden des Nachkommateils zurück.
Syntax Fix (IntAusdruck)
NumAusdruck Integer-Ausdruck, dessen Vorkommateil zurückgeliefert werden soll.

Fix(3.14159)   ergibt 3.                         Fix(0)   ergibt 0.                         Fix(-3.14159)   ergibt -3.

Fix kann nur Integer-Zahlen, d.h. im Bereich von -32.768 bis 32.767 (inclusive) verarbeiten.

 

Int-Funktion Liefert die Vorkommazahl eines numerischen Ausdrucks durch Abrunden zurück.
Syntax Int(NumAusdruck)
NumAusdruck Integer-Ausdruck, dessen Vorkommateil durch Abrunden ermittelt werden soll.

Int(3.14159)   ergibt 3.                         Int(0)   ergibt 0.                         Int(-3.14159)   ergibt -4.

Int kann nur Integer-Zahlen, dass heißt im Bereich von -32.768 bis 32.767 (inklusive) verarbeiten.

 

Abs-Funktion  Ermittelt den Absolutwert (ohne Vorzeichen) eines numerischen Ausdrucks.
Syntax Abs(NumAusdruck)
NumAusdruck Beliebiger numerischer Ausdruck, dessen Absolutwert (vorzeichenloser Wert) ermittelt werden soll. Das bedeutet: Jede positive Zahl und 0 werden original zurückgeliefert, jede negative Zahl wird in eine positive Zahl verwandelt.

 

Sgn-Funktion  Liefert ganzzahligen Wert zwischen -1 und 1, der anzeigt, ob der der Funktion übergebene Ausdruck positiv o. negativ ist.
Syntax Sgn(NumAusdruck)
NumAusdruck Numerischer Ausdruck, dessen Vorzeichen ermittelt werden soll.

Negativ:       Sgn liefert -1 zurück.

0:    Sgn liefert 0 zurück. Positiv:  Sgn liefert 1 zurück.

 

Hex$-Funktion Liefert das Ergebnis der Umrechnung einer Zahl in das Hexadezimalformat.
Syntax Hex$(NumAusdruck)
NumAusdruck Beliebiger numerischer Ausdruck, der in eine Hexadezimalzahl umgewandelt werden soll.

 

Sqr-Funktion Ermittelt die Quadratwurzel des angegebenen numerischen Ausdrucks
Syntax Sqr(NumAusdruck)
NumAusdruck Beliebiger numerischer Ausdruck, dessen Quadratwurzel berechnet werden soll.

Die Quadratwurzel ist die Zahl, die man in der Gleichung a^2=c mit 2 potenzieren muss, um die Zahl c zu erhalten
(6^2 ist beispielsweise 36; die Quadratwurzel aus 36 ist folglich 6).

Mathematische Operatoren

"-" Operator  Subtrahiert zwei Werte ergebnis = ausdruck1 - ausdruck2
"*" Operator  Multipliziert zwei Werte  ergebnis = ausdruck1 * ausdruck2
"+" Operator Addiert zwei Werte  ergebnis = ausdruck1 + ausdruck2
"/" Operator Dividiert zwei Werte ergebnis = ausdruck1 / ausdruck2
"^" Operator Potenziert einen Wert  ergebnis = ausdruck ^ exponent

Vergleichsoperatoren

Vergleichsoperatoren basieren auf der Booleschen Algebra, die einen wesentlichen Aspekt des Computers darstellt. Mit der Booleschen Algebra ist es dem Computer erst möglich, bestimmte Bedingungen zu erkennen und entsprechend darauf zu reagieren. Die Boolesche Algebra kennt nur ein Ergebnis, das jedoch nur zwei Werte annehmen kann, den Wert 0 für ein falsches Ergebnis und den Wert -1 für ein wahres Ergebnis.

=, <, >, <=, >=, <> - Operatoren  Werden zum Vergleich zweier Ausdrücke herangezogen
Syntax ergebnis = ausdruck1 { = | < | > | <= | >= } ausdruck2
Ausdruck1, ausdruck2  Beliebige numerische Werte, die miteinander verglichen werden sollen.

Die Bedeutung der Vergleichsoperatoren finden Sie in der folgenden Tabelle erklärt:

  =   gleich    <>   ungleich
 < kleiner als  > größer als
  <=   kleiner gleich   >=    größer gleich

Textfunktionen

Asc-Funktion Gibt den ASCII-Wert (American Standard for Information Interchange) eines Zeichenfolgeausdrucks zurück
Syntax Asc(zeichenfolgeausdruck$)
zeichenfolgeausdruck$  Beliebiger Zeichenfolgeausdruck.
Ausgewertet wird jedoch nur das erste Zeichen, der Rest der Zeichenfolge wird unberücksichtigt gelassen.

Die Asc-Funktion wird häufig verwendet, um Eingaben von der Tastatur abzufragen. Sie bildet quasi die Umkehrfunktion von der Chr$-Funktion. Wird der Asc-Funktion ein Leerstring (Zeichenfolge ohne Inhalt) übergeben, meldet StarBasic einen Fehler. Neben den reinen druckbaren ASCII-Zeichen (Codes 32-255), kann die ASCII-Funktion ebenfalls dazu herhalten, bestimmte Tastencodes, die ebenfalls im ASCII kodiert sind, abzufangen.

Beispiel:Das folgende Beispiel verwendet die Asc-Funktion zur Erkennung der Betätigung der Rückschrittaste.

Do

   in$=INKEY$                                ' Aufnahme der von der Tastatur kommenden Sequenzen in in$.

Loop UNTIL Asc(in$)<>8              ' Wert 8 für die Rückschrittaste.

Print "Die Rückschrittaste wurde betätigt."

Chr$-Funktion  Liefert das Zeichen, das dem angegebenen ASCII-Wert entspricht
Syntax Chr$(ausdruck%)
ausdruck% Numerische Variable, die gültigen ASCII-Wert aufnimmt (0-255).

Die Chr$-Funktion wird oft verwendet, um spezielle Steuersequenzen an den Drucker oder ein anderes Ausgabegerät zu senden, aber auch, um beispielsweise Anführungszeichen in einen Zeichenfolgeausdruck einzufügen, was in der Programmierumgebung direkt nur sehr schwer zu realisieren ist, da das Anführungszeichen selbst den Start einer Zeichenfolge im StarBasic-Quelltext kennzeichnet.

Beispiel: Dieses Beispiel fügt ein Anführungszeichen (ASCII-Wert 34) in eine Zeichenfolge ein.

MsgBox "Der "+ Chr$(34)+"kleine" + Chr$(34)+" Riese."

Bei der Ausgabe erscheint im Dialogfeld: Der "kleine" Riese.

Str$-Funktion  Wandelt einen numerischen Ausdruck in eine Zeichenfolge um
Syntax Str$(ausdruck)
ausdruck Ein beliebiger numerischer Ausdruck

Mit der Str$-Funktion ist es möglich, Rechenergebnisse oder den Inhalt numerischer Variablen in Zeichenfolgen umzuwandeln.
Negativen numerischen Ausdrücken wird dabei ein Minuszeichen vorangestellt. Beachten Sie aber bitte, dass die Str$-Funktion bei einem positiven numerischen Ausdruck ein Leerzeichen (anstelle des Plus-Zeichens) vor die zurückgegebene Zeichenfolge setzt.

 

Space$-Funktion   Ergibt eine Zeichenfolge, bestehend aus Leerzeichen
Syntax Space$(n%)
n% Numerischer Ausdruck, der die Anzahl der Leerzeichen in der Zeichenfolge festlegt.

 

 

String$-Funktion  Ergibt eine Zeichenfolge der angegebenen Länge, bestehend aus dem angegebenen Zeichen
Syntax   String$(laenge%, {ausdruck% | zeichenfolgeausdruck$})
ausdruck% Numerischer Ausdruck, bezeichnet den ASCII-Code des Zeichens, aus dem die Zeichenfolge bestehen soll.
zeichenfolgeausdruck$ Zeichen oder Zeichenfolge, aus dem die Zeichenfolge bestehen soll.

 

LTrim$-Funktion Schneidet alle führenden Leerzeichen eines Zeichenfolgeausdrucks ab
Syntax LTrim$(zeichenfolgeausdruck$)
zeichenfolgeausdruck$ Ein beliebiger Zeichenfolgeausdruck

Verwenden Sie diese Funktion, um Leerzeichen vor einem Zeichenfolgeausdruck zu entfernen. 

 

LCase$-Funktion   Wandelt alle Zeichen einer Zeichenfolge in Kleinbuchstaben um
Syntax LCase(zeichenfolgeausdruck)
zeichenfolgeausdruck$ Beliebiger Zeichenfolgeausdruck, der bearbeitet werden soll.

Die LCase-Funktion wandelt alle Zeichen einer Zeichenfolge in Kleinbuchstaben um. Angetastet werden dabei natürlich nur die groß­geschriebenen Buchstaben des Alphabets, die sich in der Zeichenfolge befinden. Alle sonstigen Zeichen bleiben unverändert.

 

Left$-Funktion kürzt einen Zeichenfolgeausdruck von links auf eine angegebene Anzahl von Zeichen.
Syntax Left$(zeichenfolgeausdruck$, n%)
zeichenfolgeausdruck$ Beliebiger Zeichenfolgeausdruck, der bearbeitet werden soll.
n%   Integer-Ausdruck, der die Anzahl der Zeichen bestimmt, auf die der Zeichenfolgeausdruck verkürzt werden soll. 
Wird n%=0, wird eine leere Zeichenfolge (Nullstring) zurückgegeben.
 
Mid$-Funktion Ergibt einen Teilbereich eines Zeichenfolgeausdrucks
Mid$-Anweisung Ersetzt einen Teilbereich eines Zeichenfolgeausdrucks
Syntax Mid$(zeichenfolgeausdruck$, anfang% [,laenge%])
oder Mid$(zeichenfolgeausdruck$, anfang% [, laenge%]) = zeichenfolgevariable$
zeichenfolgeausdruck$ Beliebiger Zeichenfolgeausdruck.
anfang% Numerischer Ausdruck, der die Position des ersten Zeichens innerhalb der Zeichenfolge aufnimmt.
laenge% Numerischer Ausdruck, der die Anzahl der Zeichen, die ermittelt oder ersetzt werden sollen bezeichnet.
zeichenfolgevariable$ Die Zeichenfolge, die den Zeichenfolgeausdruck ersetzen soll (bei Mid$-Anweisung).

Entfällt bei der Mid$-Funktion die Angabe zu laenge%, werden alle Zeichen ab der angegebenen Position bis zum letzten Zeichen der Zeichenfolge ermittelt. Wird laenge% bei der Mid$-Anweisung nicht angegeben, wird der gesamte zu ersetzende Text in die Zeichenfolge eingefügt. Ist laenge% bei der Mid$-Anweisung kleiner als die Länge des zu ersetzenden Textes, wird dieser auch nur in dem angegebenen Ausmaß ersetzt.

 

Right$-Funktion Kürzt einen Zeichenfolgeausdruck von rechts auf eine angegebene Anzahl von Zeichen.
Syntax Right$(zeichenfolgeausdruck$, n%)
zeichenfolgeausdruck$  beliebiger Zeichenfolgeausdruck
n% Beliebiger Integer-Ausdruck, der die Anzahl der Zeichen bestimmt, auf die der Zeichenfolgeausdruck verkürzt werden soll.

 

RTrim$-Funktion Entfernt alle Leerzeichen am Ende eines Zeichenfolgeausdrucks
Syntax RTrim$(zeichenfolgeausdruck$)
zeichenfolgeausdruck$  beliebiger Zeichenfolgeausdruck

Verwenden Sie diese Funktion, um Leerzeichen hinter einem Zeichenfolgeausdruck zu entfernen. 

 

UCase$-Funktion Wandelt alle Zeichen einer Zeichenfolge in Großbuchstaben um
Syntax UCase$(zeichenfolgeausdruck)
zeichenfolgeausdruck$ Beliebiger Zeichenfolgenausdruck, der bearbeitet werden soll.

Die UCase-Funktion wandelt alle Zeichen einer Zeichenfolge in Großbuchstaben um. Angetastet werden dabei natürlich nur die kleingeschriebenen Buchstaben des Alphabets, die sich in der Zeichenfolge befinden. Alle sonstigen Zeichen bleiben unverändert.

 

InStr-Funktion   Liefert die Position einer in einem Zeichenfolgeausdruck vorhandenen Zeichenfolge
Syntax InStr([anfang%,] zeichenfolgeausdruck1$, zeichenfolgeausdruck2$[, vergleich])
anfang% Beliebiger numerischer Ausdruck, der festlegt, ab welcher Position innerhalb eines Zeichenfolgeausdrucks die Suche nach einer bestimmten Zeichenfolge einsetzen soll. Wird diese Angabe ausgelassen, beginnt die Suche beim ersten Zeichen.
zeichenfolgeausdruck1$  Zu durchsuchender Zeichenfolgeausdruck.
zeichenfolgeausdruck2$  Zu suchender Zeichenfolgeausdruck.
vergleich Optionaler, numerischer Ausdruck, der die Art des Zeichenfolgenvergleichs bestimmt. Dem Parameter kann der Wert 0 oder 1 zugewiesen werden. Die Voreinstellung 0 führt zu einem binären Vergleich, der Wert 1 zu einem textuellen Vergleich ohne Berücksichtigung der Groß-/Kleinschreibung.

 

Len-Funktion   Liefert die Anzahl der Zeichen in einer Zeichenfolge oder, wenn Variablen angegeben werden, die nicht vom Typ String (Zeichenfolge) sind, die Anzahl der Bytes, die benötigt werden, um den Inhalt der Variablen zu speichern
Syntax Len(zeichenfolgeausdruck$) oder Len(AnyVarType)
zeichenfolgeausdruck$ Ein beliebiger Zeichenfolgeausdruck
AnyVarType Eine Nicht String-Variable beliebigen Typs. Wird diese anstelle einer Zeichenfolge angegeben, gibt die Len-Funktion als Rückgabewert den Speicherplatzbedarf der Variablen in Byte an.

 

Val-Funktion  Liefert einen numerischen Wert aus den ersten Zeichen einer Zeichenfolge, die sich als Ziffer interpretieren lassen.
Syntax Val(zeichenfolgeausdruck$)
zeichenfolgeausdruck$ Ein beliebiger Zeichenfolgeausdruck

Bsp.:                                "23 Baüme" liefert 23.                                "8 C 3" liefert 8.                                "A3" oder "Baum" liefern 0.