• Home
• Funktionen/Funktionsbausteine - Referenz
• Funktionsbausteine für PLCnext Technology-Steuerungen
• Lokalisierung
• GET_LANG_STRING

GET_LANG_STRING

Typ	Funktionsbaustein
Beschreibung	Der Funktionsbaustein sucht nach einer lokalisierten (übersetzten) Zeichenfolge vom Typ STRING, basierend auf einer Zeichenfolgen-ID und einem Sprach-Code. Die Übersetzung wird aus der angegebenen 'Ressourcen'-Tabelle gelesen und, falls gefunden, in die am LOCALIZED_STRING-Ausgang angelegte STRING-Variable geschrieben. Weitere Infos Informationen zum Lokalisierungsvorgang, den Voraussetzungen und detaillierte Schritt-für-Schritt-Anleitungen finden Sie im Thema "Projektsprache übersetzen (lokalisieren)". Mit einer steigenden Flanke am REQ-Eingang wird der angelegte String gesucht. Der Ausgang BUSY wird auf TRUE gesetzt, während die Suche läuft. Wenn der Funktionsbaustein ausgeführt und der lokalisierte String gefunden wurde, wechselt der Ausgang DONE auf TRUE und der lokalisierte String wird am Ausgang LOCALIZED_STRING ausgegeben. Der Ausgang ERROR zeigt an, ob bei der Ausführung des Funktionsbausteins ein Fehler aufgetreten ist. Der Ausgang STATUS zeigt Details zur Ausführung des FBs und ggf. den Grund für einen aufgetretenen Fehler.
Hinweise	Funktionsbausteine dieses Typs müssen instanziiert werden. Der FB-Instanzname muss in der 'Variablen'-Tabelle der POE deklariert werden, in welcher der FB verwendet werden soll. Der Instanzname muss innerhalb der POE eindeutig sein.
Parameter	Eingänge REQ Datentyp: BOOL Beschreibung: Der Funktionsbaustein wird mit einer steigenden Flanke (TRUE) ausgeführt. Die Ausführung wird fortgesetzt, wenn vor Beendigung des Vorgangs REQ auf FALSE zurückgesetzt wird. Hinweis Das Rücksetzen von REQ auf FALSE löscht die Ausgänge BUSY, DONE und ERROR. Setzen Sie REQ erst zurück (als Vorbereitung auf ein neuerliche Ausführung), nachdem die aktuelle Ausführung vollständig abgeschlossen ist. Der Abschluss der aktuellen Abarbeitung wird an einem der beiden Ausgängen DONE oder ERROR angezeigt. LANG_CODE Datentyp: STRING Beschreibung: Sprachcode wie in der Kategorie 'International | Standardspracheinstellungen' im Dialog 'Extras > Optionen' eingestellt. In der Regel (aber nicht zwingend) entspricht der Code den im Standard RFC5646 definierten Tags. STRING_NAME Datentyp: STRING Beschreibung: Eindeutige Kennung des lokalisierten Strings. Die Kennung setzt sich zusammen aus dem POE-Namen, dem Gruppenname und Wert in der Spalte 'Name' in der 'Ressourcen'-Tabelle, jeweils durch einen Punkt getrennt: POUName.Tabellengruppe.Name Beachten Sie, dass der 'Ressourcen'-Editor einer POE nur Variablen enthält, für die das Kontrollkästchen 'Übersetzen' in der zugehörigen Variablentabelle aktiviert ist. Ausgänge DONE Datentyp: BOOL Beschreibung: Der Ausgang wird auf TRUE gesetzt, sobald der Funktionsbaustein vollständig und erfolgreich ausgeführt wurde. BUSY Datentyp: BOOL Beschreibung: Der Ausgang wird auf TRUE gesetzt, während der Funktionsbaustein ausgeführt wird. ERROR Datentyp: BOOL Beschreibung: FALSE: Funktionsbaustein wurde ohne Fehler ausgeführt. Der STATUS-Ausgang enthält einen der Werte 0x0000, 0x0001 oder 0x0002 und am Ausgang LOCALIZED_STRING wird ein gültiger String ausgegeben. TRUE: Die Ausführung des Funktionsbausteins ist fehlgeschlagen. Der STATUS-Ausgang enthält einen der Werte 0x000B oder 0x000C und am Ausgang LOCALIZED_STRING wird kein Wert ausgegeben. STATUS Datentyp: WORD Beschreibung: Statuscode des Funktionsbausteins. Werten Sie diesen Ausgang aus, insbesondere wenn ERROR = TRUE ist. Die Beschreibung der STATUS-Werte finden Sie unten. LOCALIZED_STRING Datentyp: STRING Beschreibung: Lokalisierter String, der, falls gefunden, aus der jeweiligen 'Ressourcen'-Tabelle ausgelesen wird.
Statuscodes:	STATUS-Werte Statuscode (hex) Bedeutung 0x0000 Kein Fehler. Der lokalisierte String wurde gefunden und wird am Ausgang LOCALIZED_STRING ausgegeben. 0x0001 Anstelle der angeforderten Zielsprache (liegt am Eingang LANG_CODE an) wird der lokalisierte String in der Standardsprache ausgegeben. 0x0002 Der gefundene lokalisierte String wurde auf 1024 Zeichen gekürzt (der übersetzte String war länger). 0x000B Der String konnte weder in der Standardsprache noch in der gewünschten Zielsprache (LANG_CODE) gefunden werden. Am Ausgang LOCALIZED_STRING wird kein Wert ausgegeben. 0x000C Kein STRING_NAME im PLCnext Engineer-Projekt definiert. 0x0011 Zugrunde liegender Dienst vorübergehend nicht verfügbar.