TEXT_SYMBOL_PARSE

Verwendung

Analysiert, ob eine in einer Textzeile in SAPscript-Format vorliegende Zeichenkette ein SAPscript-Symbol ist.

Die zu untersuchende Textzeile wird in LINE übergeben. Der Parameter START_OFFSET gibt die Position an, an der das für SAPscript-Symbole notwendige beginnende Fluchtsymbol & steht.

Die Zeichenkette wird analysiert. Falls es sich um ein Symbol handelt, werden alle Informationen zu diesem Symbol in den Parametern SYMBOL_... zurückgegeben.

Handelt es sich nicht um ein SAPscript-Symbol, wird die Exception NO_SYMBOL gesetzt.

Funktionsaufruf:

CALL FUNCTION  'TEXT_SYMBOL_PARSE'
        EXPORTING
                LINE                    = ?...
                START_OFFSET            = ?...
        IMPORTING
                CONTINUE_OFFSET         =
                SYMBOL_CONDENSED        =
                SYMBOL_DECIMALS         =
                SYMBOL_DICTLEN          =
                SYMBOL_EXPONENT         =
                SYMBOL_FILLCHAR         =
                SYMBOL_LDATE            =
                SYMBOL_LENGTH           =
                SYMBOL_NAME             =
                SYMBOL_NOCONVERT        =
                SYMBOL_NOINIT           =
                SYMBOL_NOSIGN           =
                SYMBOL_NOZERO           =
                SYMBOL_OFFSET           =
                SYMBOL_RIGHT            =
                SYMBOL_SIGNLEFT         =
                SYMBOL_SIGNRIGHT        =
                SYMBOL_TEXT1            =
                SYMBOL_TEXT1_LENGTH     =
                SYMBOL_TEXT2            =
                SYMBOL_TEXT2_LENGTH     =
                SYMBOL_SEPARATOR_THOUSAND =
                SYMBOL_INCREMENT        =
                SYMBOL_DECREMENT        =
        EXCEPTIONS
                NO_SYMBOL               =

Export-Parameter:

LINE

Übergibt die Textzeile im SAPscript-Format (Struktur TLINE), deren Inhalt im Hinblick auf ein SAPscript-Symbol analysiert werden soll.

Struktur: TLINE

START_OFFSET

Hier definieren Sie den Offset in Bezug auf TLINE, an dem die zu untersuchende Zeichenkette beginnt. Der Offset muß auf das beginnende Fluchtzeichen & des möglichen Symbols zeigen.

Import-Parameter:

CONTINUE_OFFSET	Der CONTINUE_OFFSET zeigt auf das erste Zeichen nach dem SAPscript-Symbol, falls es um ein syntaktisch korrektes Symbol handelt. Ist der Wert >= 134, so steht das schließende Fluchtzeichen & des Symbols am Ende der Zeile.
SYMBOL_CONDENSED	Der Parameter gibt an, ob bei dem untersuchten Symbol die Aufbereitungsoption C gesetzt ist (Leerzeichen komprimieren). Mögliche Werte: 'X' Option angegeben ' ' Option nicht angegeben
SYMBOL_DECIMALS	Der Parameter gibt die als Option angegebene Dezimalstellenangabe zurück. Ist der Parameter leer, wurde bei dem untersuchten Symbol diese Option nicht spezifiziert.
SYMBOL_DICTLEN	Der Parameter gibt an, ob bei dem untersuchten Symbol die Aufbereitungsoption * angegeben ist (Ausgabelänge entsprechend Dictionary-Definition). Mögliche Werte: 'X' Option angegeben ' ' Option nicht angegeben
SYMBOL_EXPONENT	Der Parameter gibt die als Option angegebene Exponentenangabe zurück. Ist der Parameter leer, wurde bei dem untersuchten Symbol diese Option nicht spezifiziert. War nur die Option E ohne weitere Ziffern angegeben, so wird in diesem Parameter der Wert 0 zurückgegeben.
SYMBOL_FILLCHAR	Der Parameter gibt an, ob bei dem untersuchten Symbol die Aufbereitungsoption F (Füllzeichen für führende Leerzeichen) angegeben ist. Mögliche Werte: ' ' Kein Füllzeichen oder Füllzeichen SPACE sonst angegebenes Füllzeichen
SYMBOL_LDATE	Der Parameter gibt an, ob bei dem untersuchten Symbol die Aufbereitungsoption L (lokale Datumsaufbereitung) angegeben ist. Mögliche Werte: 'X' Option angegeben ' ' Option nicht angegeben
SYMBOL_LENGTH	Der Parameter gibt die als Option angegebene Längenangabe zurück. Ist der Parameter leer, wurde bei dem untersuchten Symbol keine Länge angegeben.
SYMBOL_NAME	Der Parameter enthält den Namen des Symbols ohne die Fluchtzeichen &. Der Name wird unabhängig von der Schreibweise in der Textzeile immer in Großbuchstaben zurückgegeben.
SYMBOL_NOCONVERT	Der Parameter gibt an, ob bei dem untersuchten Symbol die Aufbereitungsoption K gesetzt ist. (Konvertierungsroutine aus Dictionary ignorieren). Mögliche Werte: 'X' Option angegeben ' ' Option nicht angegeben
SYMBOL_NOINIT	Der Parameter gibt an, ob bei dem untersuchten Symbol die Aufbereitungsoption I gesetzt ist (Initialwert nicht ausgeben). Mögliche Werte: 'X' Option angegeben ' ' Option nicht angegeben
SYMBOL_NOSIGN	Der Parameter gibt an, ob bei dem untersuchten Symbol die Aufbereitungsoption S gesetzt ist (Vorzeichen nicht ausgeben). Mögliche Werte: 'X' Option angegeben ' ' Option nicht angegeben
SYMBOL_NOZERO	Der Parameter gibt an, ob bei dem untersuchten Symbol die Aufbereitungsoption Z gesetzt ist (Führende Nullen weglassen). Mögliche Werte: 'X' Option angegeben ' ' Option nicht angegeben
SYMBOL_OFFSET	Der Parameter gibt die als Option angegebene Offsetangabe zurück. Ist der Parameter leer, wurde bei dem untersuchten Symbol kein Offset angegeben
SYMBOL_RIGHT	Der Parameter gibt an, ob bei dem untersuchten Symbol die Aufbereitungsoption R gesetzt ist (Rechtsbündige Ausgabe). Mögliche Werte: 'X' Option angegeben ' ' Option nicht angegeben
SYMBOL_SIGNLEFT	Der Parameter gibt an, ob bei dem untersuchten Symbol die Aufbereitungsoption < gesetzt ist (Vorzeichen links). Mögliche Werte: 'X' Option angegeben ' ' Option nicht angegeben
SYMBOL_SIGNRIGHT	Der Parameter gibt an, ob bei dem untersuchten Symbol die Aufbereitungsoption > gesetzt ist (Vorzeichen rechts). Mögliche Werte: 'X' Option angegeben ' ' Option nicht angegeben
SYMBOL_TEXT1	Der Parameter gibt an, welcher Vortext bei dem untersuchten Symbol angegeben ist. Der Inhalt des Parameters ist in Zusammanhang mit dem Parameter SYMBOL_TEXT1_LENGTH zu interpretieren.
SYMBOL_TEXT1_LENGTH	Der Parameter gibt die Länge des Vortextes an. Der Inhalt des Vortextes ist im Parameter SYMBOL_TEXT1 festgehalten. Ist der Wert 0, so ist kein Vortext angegeben.
SYMBOL_TEXT2	Der Parameter gibt an, welcher Nachtext bei dem untersuchten Symbol angegeben ist. Der Inhalt des Parameters ist in Zusammenhang mit dem Parameter SYMBOL_TEXT2_LENGTH zu interpretieren.
SYMBOL_TEXT2_ LENGTH	Der Parameter gibt die Länge des Nachtextes an. Der Inhalt des Nachtextes ist im Parameter SYMBOL_TEXT2 festgehalten. Ist der Wert 0, so ist kein Nachtext angegeben.
SYMBOL_SEPARATOR_ THOUSAND	Der Parameter zeigt an, ob die Aufbereitungsoption T angegeben wurde. Dies bedeutet, daß das Trennzeichen an den Tausenderstellen nicht ausgegeben wird. Mögliche Werte: 'X' Option angegeben ' ' Option nicht angegeben
SYMBOL_INCREMENT	Der Parameter zeigt an, ob die Aufbereitungsoption '' angegeben wurde. Dies bedeutet, daß vor der Ausgabe der Wert des entsprechenden Zählers SAPSCRIPT-COUNTER_x ( x = 0.. 9) um 1 hochgezählt wird. Mögliche Werte: 'X' Option angegeben ' ' Option nicht angegeben
SYMBOL_DECREMENT	Der Parameter zeigt an, ob die Aufbereitungsoption '-' angegeben wurde. Dies bedeutet, daß vor der Ausgabe der Wert des entsprechenden Zählers SAPSCRIPT-COUNTER_x ( x = 0.. 9) um 1 vermindert wird. Mögliche Werte: 'X' Option angegeben ' ' Option nicht angegeben

Exceptions:

NO_SYMBOL

Bei der an der angegebenen Startposition beginnenden Zeichenkette handelt es sich nicht um ein Symbol im Sinne der SAPscript-Syntax.

Mögliche Fehler:

Das Symbol wurde am Ende nicht durch das Zeichen '&' abgeschlossen
Der Name des Symbols enthält Leerzeichen.
Das Symbol steht nicht vollständig in einer SAPscript-Editor-Zeile
Zusätzliche Aufbereitungsoptionen sind nicht in runde Klammern eingeschlossen
Kennbuchstaben der Aufbereitungsoptionen sind nicht in Großbuchstaben geschrieben
Es wurde eine unzulässige Aufbereitungsoption verwendet
Die Offsetangabe steht nicht direkt hinter dem Symbolnamen
Vor- und/oder Folgetext sind nicht in Hochkomma eingeschlossen
etc.