convertNumberToUnsignedUnicodeNum()

Diese Funktion bietet EGL-Unterstützung für COBOL-Variablen im Format ohne Vorzeichen als Komplementärfunktion zu 'sysLib.convertNumberToUnicodeNum()'.

Die Systemfunktion 'sysLib.convertNumberToUnsignedUnicodeNum()' konvertiert den absoluten Wert der Ziffern eines numerischen Quellenwerts in UNICODE-Zeichen ohne UNICODE-Vorzeichen. Führende Nullen werden für den ganzzahligen Teil eingeschlossen, nachfolgende Nullen werden für den Bruchteil eingeschlossen, Dezimalzeichen werden überhaupt nicht eingeschlossen.

Die Länge der UNICODE-Variablen muss für die Länge des numerischen Werts angemessen sein. Eine Tabelle mit einer Liste der erforderlichen Längen von UNICODE-Variablen finden Sie unter Erforderliche Längen für UNICODE-Zahlenkonvertierungen.

Syntax

  sysLib.convertNumberToUnsignedUnicodeNum(
    Quelle SMALLINT | INT | BIGINT | DECIMAL | BIN | NUM in,
    Ziel UNICODE out] )
Quelle
Eine beliebige numerische Variable mit Ausnahme von Gleitkommavariablen.
Ziel
Eine UNICODE-Variable.

Beispiele

  n1 SMALLINT = 1234;
  u1 UNICODE(4);
  // Funktion empfängt Gültigkeitsfehler 
  // 'u1' muss eine Länge von 5 haben
  convertNumberToUnsignedUnicodeNum(n1, u1);
  
  n2 SMALLINT = 1234;
  u2 UNICODE(5);
  // Funktion setzt 'u2' auf "01234"
  convertNumberToUnsignedUnicodeNum(n2, u2);

  n3 INT = 123456789;
  u3 UNICODE(10);
  // Funktion setzt 'u3' auf
  // "0123456789"
  convertNumberToUnsignedUnicodeNum(n3, u3);

  n4 BIGINT = -1234567890;
  u4 UNICODE(19);
  // Funktion setzt 'u4' auf
  // "0000000001234567890"
  convertNumberToUnsignedUnicodeNum(n4, u4);

  n5 BIN(18, 9) = -123456.1234;
  u5 UNICODE(19);
  // Funktion setzt 'u5' auf
  // "0000123456123400000"
  convertNumberToUnsignedUnicodeNum(n5, u5);

  n6 DECIMAL(31, 4) = 123456789012345678901234567.8901;
  u6 UNICODE(31);
  // Funktion setzt 'u6' auf
  // "1234567890123456789012345678901"
  convertNumberToUnsignedUnicodeNum(n6, u6);

  // Nächste Zeile empfängt Gültigkeitsfehler für COBOL
  // Variablen vom Typ NUM sind bei COBOL auf eine Länge von 31 beschränkt
  n7 NUM(32, 4) = 1234567890123456789012345678.9012;
  u7 UNICODE(32);
  // Bei Java setzt die Funktion 'u7' auf
  // "12345678901234567890123456789012"
  convertNumberToUnsignedUnicodeNum(n7, u7);

Hinweise zur Kompatibilität

Tabelle 1. Hinweise zur Kompatibilität
Plattform Problem
JavaScript-Generierung Die Funktion 'sysLib.convertNumberToUnsignedUnicodeNum()' wird nicht unterstützt.

Feedback