Anwendungsgebiet: Stringfunktionen
Die Funktion RENAME( ) liefert einen neuen Namen. Der neue Name wird auf der Basis des Eingabenamens gebildet mithilfe von Wildcards.
Format
RENAME( ) |
INPUT-NAME = string_ausdruck ,WILDCARD-PATTERN = string_ausdruck ,CONSTRUCTION-WILDCARD = string_ausdruck ,NO-MATCH = *WARNING / *IGNORE / *ERROR ,WILDCARD-MODE = *BS2000 / *POSIX |
Ergebnistyp
STRING
Eingabeparameter
INPUT-NAME = string_ausdruck
Bezeichnet den String, der ersetzt werden soll.
WILDCARD-PATTERN = string_ausdruck
Bezeichnet das gesuchte Muster.
CONSTRUCTION-WILDCARD = string_ausdruck
Bezeichnet die Regeln für die Bildung des neuen Namens. (Siehe dazu Handbuch „LMS“ [11].)
NO-MATCH =
Bezeichnet, was gemacht wird, wenn das gesuchte Muster nicht gefunden wird.
NO-MATCH = *WARNING
Es wird eine Warnung ausgegeben.
NO-MATCH = *IGNORE
Keine Aktion.
NO-MATCH = *ERROR
Es wird eine Fehlermeldung ausgegeben.
WILDCARD-MODE = *BS2000 / *POSIX
Gibt an, ob Wildcards bei der Ersetzung in der BS2000-Wildcard-Syntax oder in der POSIX-Wildcard-Syntax interpretiert werden.
Ergebnis
Neuer Name als String
Fehlermeldung
SDP0467 KEINEN NAMEN GEFUNDEN: VERARBEITUNG WIRD FORTGESETZT SDP0468 KEINEN NAMEN GEFUNDEN SDP0482 EIN EINGABE-STRING IST ZU LANG (1..255) SDP0483 FALSCHER CONSTRUCTION-WILDCARD-WERT SDP0484 ZU GROSSER AUSGABE-STRING (1..255)
Beispiel
/A = RENAME('A.B','A.*','NEWA.*')
/SHOW-VARIABLE A
A = NEWA.B
/A = RENAME('B.A','A.*','NEWA.*')
SDP0467 KEIN NAME GEFUNDEN; VERARBEITUNG WIRD FORTGESETZT
/SHOW-VARIABLE A
A = B.A
/A = RENAME('B.A','A.*','NEWA.*',NO-MATCH=*IGNORE)
/SHOW-VARIABLE A
A = B.A
/A = RENAME('B.A','A.*','NEWA.*',NO-MATCH=*ERROR)
SDP0468 KEINEN NAMEN GEFUNDEN
SDP0431 FEHLER 'SDP0468' IN BUILTIN-FUNKTION 'RENAME'
SDP0239 FEHLER WAEHREND DER AUSWERTUNG DER RECHTEN SEITE DER ZUWEISUNG
/A = RENAME('A.B.C','A///C','NEWA///NEWC')
/SHOW-VARIABLE A
A = NEWA.B.NEWC
/A = RENAME('A.B','*.*','**')
/SHOW-VARIABLE A
A = AB
/A = RENAME('A.B','*.*','<1><1>')
/SHOW-VARIABLE A
A = AA
/A = RENAME('A.B','/./','XYZ<2>')
/SHOW-VARIABLE A
A = XYZB