lowerCase()

Die Systemfunktion 'strLib.lowerCase()' gibt eine Kopie eines Zeichentypwerts zurück und setzt alle Großbuchstaben in dieser Kopie in Kleinbuchstaben 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.lowerCaseChar()' verwenden. Beispiele hierzu finden Sie weiter unten.

Um Werte in Kleinbuchstaben in Großbuchstaben zu konvertieren, verwenden Sie die Funktion 'strLib.upperCase()' oder 'strLib.upperCaseChar()'.

Syntax

  strLib.lowerCase(
    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
Ein Zeichenfolgewert (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.lowerCase(myChar) + 
      "is, for lowerCase type Char");
   sysLib.writeStdout(StrLib.lowerCaseChar(myChar) + 
      "is, for lowerCaseChar type Char");
   sysLib.writeStdout(StrLib.lowerCase(myUnicode) + 
      "is, for lowerCase type Unicode");
   sysLib.writeStdout(StrLib.lowerCaseChar(myUnicode) + 
      "is, for lowerCaseChar type Unicode");		
		sysLib.writeStdout(StrLib.lowerCase(myString) + 
      "is, for lowerCase type String");
   sysLib.writeStdout(StrLib.lowerCaseChar(myString) + 
      "is, for lowerCaseChar type String");

end
Die Ausgabe sieht wie folgt aus:
abcis, for lowerCase type Char
abc  is, for lowerCaseChar type Char
abcis, for lowerCase type Unicode
abc  is, for lowerCaseChar type Unicode
abc     is, for lowerCase type String
abc     is, for lowerCaseChar 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.lowerCase()'.

Kompatibilität

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

Feedback