Get indexed string

Home

4D v20.6

Get indexed string


Get indexed string ( ResID ; StrID {; ResDatei} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
ResID	Lange Ganzzahl	Kennummer der Ressource oder 'id' Attribut des 'group' Elements (XLIFF)
StrID	Lange Ganzzahl	Stringnummer oder 'id' Attribut des 'trans-unit' Elements (XLIFF)
ResDatei	DokRef	Referenznummer der Ressourcendatei Ohne Angabe: alle XLIFF Dateien oder offene Ressourcendateien.
Funktionsergebnis	String	Wert des indizierten String

Beschreibung

Der Befehl Get indexed string gibt folgendes zurück:

Einen String aus der Stringlisten-Ressource (“STR#”) mit der Kennummer ResID.
ODER
Einen String aus einer offenen XLIFF Datei mit dem 'id' Attribut des 'group' Elements, übergeben in ResID (siehe unten).

Sie übergeben die Stringnummer in StrID. Die Strings in der Stringlisten-Ressource sind numeriert von 1 bis N. Wollen Sie alle Strings (und ihre Nummern) aus der String-Listen Ressource erhalten, verwenden Sie den Befehl STRING LIST TO ARRAY.
Wird die Ressource oder der String innerhalb einer Ressource nicht gefunden, wird ein leerer String zurückgegeben, die OK Variable wird auf 0 (Null) gesetzt.

Übergeben Sie in ResDatei eine gültige Referenznummer für die Ressourcendatei, wird die Ressource nur in dieser Datei gesucht. Übergeben Sie ResDatei nicht, wird das erste Vorkommen der Ressource in der Ressourcendatei-Kette zurückgegeben.

Hinweis: Jeder String einer Stringlisten-Ressource kann bis zu 255 Zeichen enthalten.

Kompatibilität mit XLIFF Architektur

Die Funktion Get indexed string ist ab 4D Version 11 mit der XLIFF Architektur kompatibel: Die Funktion sucht zuerst in allen offenen XLIFF Dateien nach Werten, die ResID und StrID entsprechen (wenn der Parameter ResDatei nicht übergeben ist). ResID bestimmt dann das id-Attribut des group-Elements und StrID das id-Attribut des trans-unit-Elements.

Wird der Wert nicht gefunden, setzt die Funktion die Suche in den offenen Ressource-Dateien fort. Weitere Informationen dazu finden Sie im PICTURE TO BLOB des Handbuchs 4D Designmodus.

Systemvariablen und Mengen

Wird die Ressource gefunden, wird OK auf 1 gesetzt, sonst auf Null (0).

Siehe auch

Get string resource
Get text resource
STRING LIST TO ARRAY