upperCase()

Die Funktion 'strLib.upperCase()' gibt eine Kopie eines Zeichentypwerts zurück und setzt alle Kleinbuchstaben in dieser Kopie in Großbuchstaben um. Numerische Werte sind nicht betroffen.

Wenn der Eingabewert nicht den Typ STRING hat, werden bei einer Datenkonvertierung nachfolgende Leerzeichen aus dem Eingabewert entfernt. Um nachfolgende Leerzeichen beizubehalten, müssen Sie stattdessen die Funktion 'strLib.upperCaseChar()' verwenden.

Um eine Zeichenfolge in Kleinbuchstaben zu konvertieren, verwenden Sie die Funktion 'strLib.lowerCase()' oder 'strLib.lowerCaseChar()'.

Syntax

  strLib.upperCase(
    Text STRING? in)
  returns (Ergebnis STRING?)
Text
Bei der Eingabe kann es sich um eine beliebige Variable oder einen beliebigen Ausdruck handeln, die/der mit dem Typ STRING zuordnungskompatibel ist (siehe 'Zuordnungskompatibilität in EGL').
Ergebnis
Eine Variable vom Typ STRING Wenn Text null ist, gibt die Funktion einen Nullwert zurück.

Beispiel

Betrachten Sie den folgenden Code:
function main()

   // jedes Literal hat 8 Zeichen 
		myChar CHAR(5)       = "abc     "; 
		myUnicode UNICODE(5) = "abc     ";
		myString String      = "abc     ";
		
   sysLib.writeStdout(StrLib.upperCase(myChar) + 
      "is, for upperCase type Char");
   sysLib.writeStdout(StrLib.upperCaseChar(myChar) + 
      "is, for upperCaseChar type Char");
   sysLib.writeStdout(StrLib.upperCase(myUnicode) + 
      "is, for upperCase type Unicode");
   sysLib.writeStdout(StrLib.upperCaseChar(myUnicode) + 
      "is, for upperCaseChar type Unicode");		
		sysLib.writeStdout(StrLib.upperCase(myString) + 
      "is, for upperCase type String");
   sysLib.writeStdout(StrLib.upperCaseChar(myString) + 
      "is, for upperCaseChar type String");

end
Die Ausgabe sieht wie folgt aus:
ABCis, for upperCase type Char
ABC  is, for upperCaseChar type Char
ABCis, for upperCase type Unicode
ABC  is, for upperCaseChar type Unicode
ABC     is, for upperCase type String
ABC     is, for upperCaseChar type String

Das Entfernen nachfolgender Leerzeichen erfolgt während einer Datenkonvertierung von einem Nicht-STRING-Datentyp in eine Zeichenfolge (STRING). Diese Konvertierung erfolgt vor der Ausführung der Funktion 'strLib.upperCase()'.

Kompatibilität

Tabelle 1. Hinweise zur Kompatibilität für 'upperCase'
Plattform Problem
COBOL-Generierung Die Funktion 'strLib.upperCase()' hat keine Auswirkungen auf Doppelbytezeichen.

Feedback