Ansicht
Dokumentation

DD_INT_CHECK_VALUE_FOR_TYPE - DD: Prüft, ob ein in Characterform gegebener Wert für einen Typ zulässig i

PERFORM Short Reference   BAL Application Log Documentation  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Mit Hilfe dieses Funktionsbausteins können Sie testen, ob ein vorgegebener Characterwert ein zulässiger Wert für einen vorgegebenen elementaren Typ ist.

Die Beschreibung des Typs erfolgt im IMPORT-Parameter TYPEDEF.

Der zu prüfende Wert ist im IMPORT-Parameter VALUE zu übergeben. Im IMPORT-Parameter QUOTATION_MODE ist festzulegen, ob der übergebene Wert in Hochkommata einzuschließen ist. Entspricht der Inhalt von VALUE nicht der so festgelegten Konvention, so wird der EXPORT-Parameter ILLEGAL_FORMAT gesetzt (und alle anderen EXPORT-Parameter sind undefiniert).

Ist der Inhalt von VALUE zu lang für den definierten Typ, so wird der EXPORT-Parameter TOO_LONG gesetzt (und alle anderen EXPORT-Parameter sind undefiniert).

Ist der Inhalt von VALUE kein legaler Wert für den definierten Typ, so wird der EXPORT-Parameter INCOMPATIBLE gesetzt (und alle anderen EXPORT-Parameter sind undefiniert). Dabei wird ein Wert nur dann als legal angesehen, wenn er die Standarddarstellung eines gültigen Wertes für diesen Typ ist. Als Standarddarstellung ist dabei (mit gewissen unten beschriebenen Ausnahmen) der Inhalt definiert, den ein Feld vom Typ STRING erhält, wenn der typgerechte Wert mit Hilfe des ABAP-Befehls MOVE auf diesen abgebildet wird.

Ist der IMPORT-Parameter NON_STANDARD_OK gesetzt, so werden gewisse Abweichungen von der Standarddarstellung (siehe unten) akzeptiert, ohne daß INCOMPATIBLE gesetzt wird.

Im EXPORT-Parameter EXPANDED_VALUE wird die Standarddarstellung eines akzeptierten Wertes zurückgegeben.

Werden in den IMPORT-Parametern WILDCARD bzw. MASK Ersetzungszeichen für beliebige Zeichenreihen bzw. genau ein Zeichen definiert, so unterstützt der Baustein auch die Erkennung von Mustern bei zeichenartigen Datentypen. Durch Benutzung eines über den IMPORT-Parameter ESCAPE definierten Fluchtsymbols können auch die Ersetzungszeichen angesprochen werden. Wird in VALUE ein Muster übergeben, so wird der EXPORT-Parameter IS_PATTERN gesetzt. Ein Muster wird dann als legal angesehen, wenn es eine Substitution der Ersetzungszeichen gibt, die das Muster zu einem legalen Wert macht. Der Inhalt von EXPANDED_VALUE ist allerdings für Muster generell undefiniert. Enthält VALUE kein Muster, so sind eventuelle Fluchtsymbole in EXPANDED_VALUE entfernt.

Ist der IMPORT-Parameter APPLY_DYNP_RESTRICTIONS gesetzt, so werden bei der Prüfung von VALUE auch die durch TYPEDEF gegebenen Einschränkungen bezüglich Groß-/Kleinschreibung und Vorzeichenbehaftung von VALUE berücksichtigt.

Beispiel

Hinweise

1. Schließende Leerzeichen: Bei allen Typen außer STRING werden bei der Standarddarstellung schließende Leerzeichen weggelassen. Enthält der zu prüfende Wert schließende Leerzeichen (was nur möglich ist, wenn er in Hochkommata eingeschlossen ist), so werden diese bei der Prüfung ignoriert, wenn NON_STANDARD_OK gesetzt ist.
   Ist NON_STANDARD_OK nicht gesetzt, so werden Werte mit schließenden Leerzeichen für alle Typen außer STRING und C als fehlerhaft angesehen. Für den Typ C werden die schließenden Leerzeichen nur bei der Überprüfung der Länge berücksichtigt (in EXPANDED_VALUE sind die schließenden Leerzeichen dann aber entfernt).
2. Führende Nullen: Die Standarddarstellung von Zahlentypen (dies sind die ABAP-Zahlentypen einschließlich b und s) enthält keine führenden Nullen. Die Standarddarstellung von numerischen Werten (Typ N) ist dagegen ggf. durch führende Nullen auf ihre definierte Länge aufgefüllt. Ist NON_STANDARD_OK gesetzt, so werden für diese Typen führende Nullen bei der Prüfung vollkommen ignoriert.
3. Vorzeichen: Vorzeichen (nur möglich bei Zahlentypen) werden generell als erste Zeichen erwartet. Das Vorzeichen '+' gehört nicht zur Standarddarstellung und wird daher nur bei gesetztem NON_STANDARD_OK akzeptiert.
4. Datums- und Zeittyp: Ein Wert wird als legales Datum bzw. als legale Uhrzeit angesehen, wenn er eine Folge von genau acht bzw. genau sechs Ziffern ist. Eine weitere Prüfung findet nicht statt.
5. Ersetzungszeichen: Ein Muster wird nicht als legal angesehen, wenn bei allen legalen Substitutionen ein Ersetzungszeichen für genau ein Zeichen durch ein schließendes Leerzeichen oder eine führende Null (bei Typ N) ersetzt wird.

Weiterführende Informationen

Parameter

APPLY_DYNP_RESTRICTIONS
ESCAPE
EXPANDED_VALUE
ILLEGAL_FORMAT
INCOMPATIBLE
IS_PATTERN
MASK
NON_STANDARD_OK
QUOTATION_MODE
TOO_LONG
TYPEDEF
VALUE
WILDCARD

Ausnahmen

ILLEGAL_TYPE
TYPE_NOT_EXISTS

Funktionsgruppe

SINT

Vendor Master (General Section)   CL_GUI_FRONTEND_SERVICES - Frontend Services  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 6010 Date: 20240523 Time: 121928     sap01-206 ( 130 ms )