Zeichenfolgenfunktionen

Funktion

Beschreibung

InStr(num, str1, str2)

Durchsucht die Zeichenfolge str1, beginnend mit der Zeichenposition num, und sucht nach einer Entsprechung für die Zeichenfolge str2. Liefert die Position, an der str2 gefunden wurde bzw. Null, wenn sie nicht gefunden wurde. Um von Anfang an zu suchen, geben Sie für num den Wert Eins (1) an.

Len(str)

Gibt die Anzahl der Zeichen (Character) der angegebenen Zeichenfolge str zurück.

(Leerzeichen innerhalb der Zeichenfolge werden berücksichtigt, Leerzeichen am Ende der Zeichenfolge werden nicht berücksichtigt.)

Rückgabewert: Ganzzahl

Beispiel: Len$(123456789) liefert als Ergebnis: 9

Beispiel: Len$(abc) liefert als Ergebnis: 3

Str$(obj)

Gibt den Objekttyp eines Kartenobjektes wieder.

Beispiel: Str$(obj) = "Polyline" liefert alle Objekte des Typs Polyline (Polylinie)

Val(str)

Gibt den numerischen Wert der Zeichenfolge str zurück.

Rückgabewert: Ganzzahl

Beispiel: Val(12345 Hausen) liefert als Ergebnis: 12345

Beispiel: Val(Hausen 12345) liefert als Ergebnis: 0

Funktion

Beschreibung

LCase$(str)

Gibt die Zeichenfolge str in Kleinschreibung zurück.

Rückgabewert: Zeichen

Beispiel: LCase$(Frankfurt) liefert als Ergebnis: frankfurt

Beispiel: LCase$(FRANKFURT) liefert als Ergebnis: frankfurt

UCase$(str)

Gibt die Zeichenfolge str in Großschreibung zurück.

Rückgabewert: Zeichen

Beispiel: LCase$(Frankfurt) liefert als Ergebnis: FRANKFURT

Beispiel: LCase$(hausen) liefert als Ergebnis: FRANKFURT

Proper$(str)

Gibt die Zeichenfolge str mit "korrekter" Großschreibung zurück (der Anfangsbuchstabe jedes Wortes wird groß geschrieben).

Rückgabewert: Zeichen

Beispiel: Proper$(FRANKFURT AM MAIN) liefert als Ergebnis: Frankfurt Am Main

Beispiel: Proper$(frankfurt am main) liefert als Ergebnis: Frankfurt Am Main

Funktion

Beschreibung

Left$(str, num)

Gibt den linken Teil der Zeichenfolge str bis zur durch eine Ganzzahl num festgelegten Zahl von Zeichen zurück.

Rückgabewert: Zeichen

Beispiel: Left$(123456789, 3) liefert als Ergebnis: 123

Beispiel: Left$(abcdefghi, 3) liefert als Ergebnis: abc

Right$(str, num)

Gibt den rechten Teil der Zeichenfolge str bis zur durch eine Ganzzahl num festgelegten Zahl von Zeichen zurück.

Rückgabewert: Zeichen

Beispiel: Right$(123456789, 3) liefert als Ergebnis: 789

Beispiel: Right$(abcdefghi, 3) liefert als Ergebnis: ghi

Mid$(str, num1, num2)

Gibt den (mittleren) Teil der Zeichenfolge str von einer Zeichenposition num1 bis zu einer Zeichenposition num2, die durch eine Ganzzahl festgelegt wird, zurück.

Rückgabewert: Zeichen

Beispiel: Mid$(123456789, 4, 3) liefert als Ergebnis: 456

Beispiel: Mid$(abcdefghi, 4, 3) liefert als Ergebnis: def

Funktion

Beschreibung

DeformatNumber$(str)

Kehrt die Auswirkung der FormatNumber$-Funktion um und liefert eine Zeichenfolge, die keine Tausendertrennzeichen enthält.

Format$(num, str)

Liefert eine Zeichenfolge, die für eine formatierte Zahl steht. Beispiel: Format$(12345.678, ”$,#.##”) liefert “$12.345,68”.

FormatNumber$(num)

Liefert eine Zeichenfolge, die für eine formatierte Zahl num steht. Diese Funktion ist einfacher zu verwenden als Format$, bietet Ihnen jedoch weniger Kontrolle über die Formatierung (z. B. erhalten Sie immer Tausendertrennzeichen).

Str$(exp)

Gibt eine Zeichenfolge zurück, die einen Ausdruck exp angibt (z. B. die Ausgabe einer Zahl). Wenn es sich bei exp um einen Objektausdruck handelt, wird eine Zeichenfolge zurückgegeben, die den Objekttyp angibt: Bogen, Ellipse, Rahmen, Linie, Punkt, Polylinie, Rechteck, Bereich, abgerundetes Rechteck oder Text.

Set Format

Wirkt sich darauf aus, wie MapBasic Zeichenfolgen verarbeitet, die für Datumsangaben oder Zahlen stehen. Eine vollständige Beschreibung finden Sie im MapBasic-Referenzhandbuch.

Funktion

Beschreibung

Asc(str)

Gibt den Zeichencode für das erste Zeichen eines Zeichenfolgenausdrucks str zurück.

Chr$(num)

Liefert zu einem Zeichencode num das entsprechende Zeichen (z. B. zeigt Chr$(65) das Zeichen „A“ an).

Funktion

Beschreibung

Like(str1 , str2, str3)

Gibt TRUE oder FALSE zurück, um anzugeben, ob eine Zeichenfolge die Kriterien des Musterabgleichs erfüllt. Eine Zeichenfolge str1 ist ein zu prüfender Ausdruck. Eine Zeichenfolge str2 enthält normale Zeichen oder spezielle Platzhalterzeichen. Eine Zeichenfolge str3 definiert ein Escape-Zeichen (z. B. „\“), wenn Sie das Vorhandensein eines der Platzhalterzeichen („%“ und „_“) im Zeichenfolgenausdruck überprüfen müssen. Verwenden Sie eine leere Zeichenfolge (""), wenn kein Escape-Zeichen erforderlich ist.

StringCompare(str1 , str2)

Führt zwischen str1 und str2 einen Vergleich durch, bei dem die Groß-/Kleinschreibung beachtet wird. Gibt -1 zurück, wenn str1 vor str2 steht; 1, wenn str1 auf str2 folgt; 0, wenn die Zeichenfolgen gleich sind.

StringCompareIntl(str1 , str2)

Führt zwischen str1 und str2 einen Vergleich durch, bei dem die Sprache beachtet wird. Gibt -1 zurück, wenn str1 vor str2 steht; 1, wenn str1 auf str2 folgt; 0, wenn die Zeichenfolgen gleich sind.

Funktion

Beschreibung

Space$(num)

Gibt eine Zeichenfolge zurück, die nur aus Leerstellen besteht und eine bestimmte Anzahl num an Zeichen enthält.

String$(num , str)

Gibt eine Zeichenfolge zurück, die erstellt wird, indem ein festgelegtes Zeichen str mit einer bestimmten Anzahl num von Wiederholungen eingefügt wird.

Funktion

Beschreibung

PointToMGRS(obj)

Konvertiert ein Punktobjekt obj , das einen Punkt angibt, in eine Zeichenfolge, die eine MGRS-Koordinate (Military Grid Reference System) darstellt. Der Eingabepunkt wird automatisch vom aktuellen MapBasic-Koordinatensystem in ein Längengrad/Breitengrad-Datum (WGS84) konvertiert, bevor die Konvertierung in eine MGRS-Zeichenfolge durchgeführt wird.

MGRSToPoint(str)

Konvertiert eine Zeichenfolge str, die eine MGRS-Koordinate (Military Grid Reference System) angibt, in ein Punktobjekt im aktuellen MapBasic-Koordinatensystem.

EPSGToCoordSysString$(str)

Konvertiert eine Zeichenfolge str, die ein räumliches Referenzsystem (Spatial Reference System, SRS) enthält, in eine CoordSys-Bedingung, die Sie zusammen mit einer beliebigen MapBasic-Funktion oder -Anweisung verwenden können. SRS-Zeichenfolgen werden auch als EPSG-Zeichenfolgen (European Petroleum Survey Group) bezeichnet (z. B. „epsg:2600“).

PointToUSNG$(obj , num)

Konvertiert ein Objekt obj, das einen Punkt angibt, in eine Zeichenfolge, die eine USNG-Koordinate (United States National Grid) darstellt. Der Wert num ist eine Datum-ID von 62 (DATUMID_NAD27), 74 (DATUMID_NAD83) oder 104 (DATUMID_WGS84).

USNGToPoint(str)

Konvertiert eine Zeichenfolge str, die eine USNG-Koordinate (United States National Grid) angibt, in ein Punktobjekt im aktuellen MapBasic-Koordinatensystem.