Stand: 31. Juli 2019

Inhaltsverzeichnis

über dieses Dokument
was es hierin gibt
wo man die neuste Version bekommt
wie man den Verfasser kontaktiert
welche gesetzlichen Einschränkungen es gibt
Lizenzlosigkeit
Verfasserschutz
Vorbehalt für zusätzliche Einschränkungen für zukünftige Versionen

allgemeine Informationen zur Bibliothek
Zweck

programmiertechnische Informationen zur Bibliothek
Abhängigkeiten
Auswirkungen auf Flaggen
Auswirkungen auf Register
Basisadresse
Fehler-Identifikationskennung
Übergabe von den Eingabe-Parameterwerten
Übergabe von den Rückgabe-Parameterwerten

die Details
Datensätze
Ereignismeldungen
Funktionen
von ISO 8859-1
nach UCS-2LE
from_ISO_8859_1_to_UCS_2LE
allgemein
Hinweis-Wert
Parameter
Übersicht
Eingabe
Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Quelle_-_Nutzdaten_-_Länge_in_Byte
Quelle_-_Nutzdaten_-_Länge_in_Zeichen
Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Rückgabe
Fehler_-_Identifikationskennung
Quelle_-_Nutzdaten_-_Länge_in_Byte
Quelle_und_Ziel_-_Nutzdaten_-_Länge_in_Zeichen
Ziel_-_Nutzdaten_-_Länge_in_Byte
nach UTF-8
from_ISO_8859_1_to_UTF_8
allgemein
Hinweis-Wert
Parameter
Übersicht
Eingabe
Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Quelle_-_Nutzdaten_-_Länge_in_Byte
Quelle_-_Nutzdaten_-_Länge_in_Zeichen
Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Rückgabe
Fehler_-_Identifikationskennung
Quelle_-_Nutzdaten_-_Länge_in_Byte
Quelle_und_Ziel_-_Nutzdaten_-_Länge_in_Zeichen
Ziel_-_Nutzdaten_-_Länge_in_Byte
von UCS-2LE
nach ISO 8859-1
from_UCS_2LE_to_ISO_8859_1
allgemein
Hinweis-Wert
Parameter
Übersicht
Eingabe
Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Quelle_-_Nutzdaten_-_Länge_in_Byte
Quelle_-_Nutzdaten_-_Länge_in_Zeichen
Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Rückgabe
Fehler_-_Identifikationskennung
Quelle_-_Nutzdaten_-_Länge_in_Byte
Quelle_und_Ziel_-_Nutzdaten_-_Länge_in_Zeichen
Ziel_-_Nutzdaten_-_Länge_in_Byte
nach UTF-8
from_UCS_2LE_to_UTF_8
allgemein
Hinweis-Wert
Parameter
Übersicht
Eingabe
Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Quelle_-_Nutzdaten_-_Länge_in_Byte
Quelle_-_Nutzdaten_-_Länge_in_Zeichen
Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Rückgabe
Fehler_-_Identifikationskennung
Quelle_-_Nutzdaten_-_Länge_in_Byte
Quelle_und_Ziel_-_Nutzdaten_-_Länge_in_Zeichen
Ziel_-_Nutzdaten_-_Länge_in_Byte
von UTF-8
nach ISO 8859-1
from_UTF_8_to_ISO_8859_1
allgemein
Hinweis-Wert
Parameter
Übersicht
Eingabe
Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Quelle_-_Nutzdaten_-_Länge_in_Byte
Quelle_-_Nutzdaten_-_Länge_in_Zeichen
Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Rückgabe
Fehler_-_Identifikationskennung
Quelle_-_Nutzdaten_-_Länge_in_Byte
Quelle_und_Ziel_-_Nutzdaten_-_Länge_in_Zeichen
Ziel_-_Nutzdaten_-_Länge_in_Byte
nach UCS-2LE
from_UTF_8_to_UCS_2LE
allgemein
Hinweis-Wert
Parameter
Übersicht
Eingabe
Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Quelle_-_Nutzdaten_-_Länge_in_Byte
Quelle_-_Nutzdaten_-_Länge_in_Zeichen
Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Rückgabe
Fehler_-_Identifikationskennung
Quelle_-_Nutzdaten_-_Länge_in_Byte
Quelle_und_Ziel_-_Nutzdaten_-_Länge_in_Zeichen
Ziel_-_Nutzdaten_-_Länge_in_Byte

Stichwortverzeichnis
Funktionen
Namen
anhand von den Kategorien gruppiert
ungruppiert

weiteres Material zu diesem Thema
Bibliotheken
Dokumente
über Dateiformate
Programme
Sonstiges
Aufnahme von weiteren Materialien

über dieses Dokument

was es hierin gibt

Dieses Dokument

wo man die neuste Version bekommt

Derzeit nutze ich OnTheServer.de/Downloads/ um neue Versionen zugänglich zu machen. Sie müsste irgendwo dort in den Unterverzeichnissen sein; das kann sich hin und wieder ein bischen ändern.

Dort gibt es vielleicht auch dieses Dokument in anderen Sprachen.

Die Versions-Angabe von diesem Dokument steht oben rechts ("Stand: ...").

wie man den Verfasser kontaktiert

Der Verfasser von diesem Dokument kann mit der Hilfe von einer elektronischen Nachricht kontaktiert werden. Das hierfür eingerichtete Postfach ist mit der Hilfe von der folgenden Adresse erreichbar:
Kontakt@On(entferne mich)TheServer.de

welche gesetzlichen Einschränkungen es gibt

Lizenzlosigkeit

Dieses Dokument
  • ist an keine Lizenz gebunden.
  • unterliegt nicht den Einschränkungen durch das Urhebergesetz.
  • soll allgemeinfrei (public domain) behandelt werden. Also so, als wenn es sich um ein Eigentum von der Allgemeinheit handelt.

Im Übrigen soll alles, was man auf OnTheServer.de und den Subdomains öffentlich zugänglich findet, entsprechend behandelt werden.

Es gibt auf OnTheServer.de allerdings eine Ausnahme:
Ich lege gelegentlich im Verzeichnis "OnTheServer.de/temp/" urheberrechtlich geschütztes Material ab.

Es ist nicht gestattet, auf irreführendeweise vorzutäuschen, dass das (ursprüngliche) Dokument an eine Lizenz gebunden wäre.

Verfasserschutz

Es ist nicht gestattet, auf irreführendeweise vorzutäuschen, dass man der (ursprüngliche) Verfasser vom Dokument wäre. Der (ursprüngliche) Verfasser muss jedoch nicht namentlich genannt werden.

Vorbehalt für zusätzliche Einschränkungen für zukünftige Versionen

Ich (der ursprüngliche Verfasser) behalte die Möglichkeit, Einschränkungen für
  • die Veränderung oder/und
  • die Verbreitung
aufzuerlegen. Von den Einschränkungen wären lediglich neue Versionen betroffen. Was bisher veröffentlicht wurde, erhält keine weiteren Einschränkungen.

Von diesem Recht werde ich hoffentlich nie gebrauch machen müssen.

allgemeine Informationen zur Bibliothek

Zweck

Mit der Hilfe von den Funktionen von dieser Bibliothek kann anhand von einer bestehenden Zeichenkette, welche mit einer bestimmten Zeichenkodierung kodiert ist, eine neue Zeichenkette erzeugt werden, welche mit einer anderen Zeichenkodierung kodiert ist.

programmiertechnische Informationen zur Bibliothek

Abhängigkeiten

Diese Bibliothek benötigt selbst keine Funktionen aus anderen Bibliotheken, damit ihre eigenen Funktionen funktionieren. Wenn dann

Auswirkungen auf Flaggen

Die Werte von allen Statusflaggen können durch einen Funktionsdurchlauf geändert werden:
Der Wert von der Steuerungsflagge wird durch einen Funktionsdurchlauf nicht geändert.

Auswirkungen auf Register

Beim Benutzen von den Funktionen sollte beachtet werden, dass die Werte von manchen Registern durch einen Funktionsdurchlauf geändert werden können. Es gibt aber auch Register, deren Werte beim Zurückkehren von der Funktion noch/wieder die Selben sind, wie sie waren, als die Funktion aufgerufen wurde.

Die Werte von den folgenden Registern werden durch einen Funktionsdurchlauf

Basisadresse

Basisadresse: Betriebssystem:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
0 00000000 00000000 00000000 00000000 2er-System
(Binär-System)
0 10er-System
(Dezimal-System)
0 00 00 00 00 16er-System
(Hexadezimal-System)
Linux
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
10000 00000000 00000000 00000000 00000000 00000000 00000000 00010000 2er-System
(Binär-System)
268.435.456 10er-System
(Dezimal-System)
10 00 00 00 00 00 00 10 16er-System
(Hexadezimal-System)
Windows

Fehler-Identifikationskennung

Die Funktionen benutzen den Rückgabewert, welcher mit der Hilfe vom Register "extended accumulator" ("eax") übergeben wird, um bekannt zu machen, ob der Funktionsdurchlauf erfolgreich war. Bei jeder Funktion gilt folgendes:

Übergabe von den Eingabe-Parameterwerten

Die Werte von den Eingabe-Parametern werden einer Funktion übergeben, indem
Der Aufrufer, also zum Beispiel die Anwendung, muss
Anschließend nutzt der Aufrufer den Befehl "call".

Mit der Hilfe von diesem Befehl wird
  1. zunächst die Rücksprungadresse auf den Stapel gelegt.
  2. Anschließend wird die Kontrolle über den CPU der aufgerufenen Funktion übergeben.

Die aufgerufene Funktion liest vom Stapel. Dadurch werden diese vom Stapel gelöscht. Nachdem der Funktionsdurchlauf abgeschlossen ist, benutzt die Funktion die Rücksprungadresse, um zurück zu springen.

Durch den Rücksprung wird die Kontrolle über den CPU dem Aufrufer zurückgegeben.

Dieser Ablauf

Übergabe von den Rückgabe-Parameterwerten

Bei den Rückgabe-Parametern gibt es 2 Gruppen:
Jede Funktion speichert die Fehler-Identifikationskennung für die Übergabe im Allzweckregister
Für diese Fehler-Identifikationskennung kann auch der Wert "0" zurückgegeben werden, um auszudrücken, dass kein Fehler aufgetreten ist.

Manche Funktionen haben allerdings weitere Rückgabe-Parameter. Das sind weitere Daten, welche die Funktion dem Aufrufer übergibt.

Wenn dann

die Details

Datensätze

- Bei der Kommunikation mit dieser Bibliothek sind keine Datensätze von Bedeutung. -

Ereignismeldungen

- Bei der Kommunikation mit dieser Bibliothek sind keine Ereignismeldungen von Bedeutung. -

Funktionen

von ISO 8859-1

nach UCS-2LE

from_ISO_8859_1_to_UCS_2LE
allgemein
Name: from_ISO_8859_1_to_UCS_2LE
Beschreibung: Diese Funktion erzeugt
  • anhand von einer Zeichenkette, welche gemäß der Zeichenkodierung "International Organization for Standardization 8859-1" ("ISO 8859-1") kodiert ist,
  • eine neue Zeichenkette, welche gemäß der Zeichenkodierung "Unicode Character Set - 2 byte per character; little endian encoded" ("UCS-2LE") kodiert ist.
Ereignismeldungen,
welche emittiert werden können: 		- Diese Funktion emittiert keine Ereignismeldung. -

Hinweis-Wert
Beschreibung: Ein Hinweis-Wert dient beim Dateiformat "portable executable" ("pe") um einen schnelleren Import zu ermöglichen.
Größe: 2 Byte
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen
Wert:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
0 00000000 00000000 2er-System
(Binär-System)
0 10er-System
(Dezimal-System)
0 00 00 16er-System
(Hexadezimal-System)

Parameter
Übersicht
(
Fehler_-_Identifikationskennung,
Quelle_-_Nutzdaten_-_Länge_in_Byte,
Quelle_und_Ziel_-_Nutzdaten_-_Länge_in_Zeichen,
Ziel_-_Nutzdaten_-_Länge_in_Byte
) = from_ISO_8859_1_to_UCS_2LE(
Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil,
Quelle_-_Nutzdaten_-_Länge_in_Byte,
Quelle_-_Nutzdaten_-_Länge_in_Zeichen,
Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil
)

Eingabe
Anzahl: 4

Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
101011 00010100 00011110 11101000 11101000 00011110 00010100 00101011 2er-System
(Binär-System)
722.738.920 10er-System
(Dezimal-System)
2B 14 1E E8 E8 1E 14 2B 16er-System
(Hexadezimal-System)
Beschreibung: Mit der Hilfe von diesem Wert wird die Adresse von der Speicherstelle angegeben, an welcher die Zeichenkette beginnt. Es handelt sich bei
  • dieser Adresse um eine virtuelle Adresse vom Segment vom Programm.
  • dieser Zeichenkette um jene Zeichenkette, welche gelesen werden soll.

Die Zeichenkette muss nicht mit der Hilfe von 1 weiteren Zeichen abgeschlossen werden, von welchem alle Bits auf "0|b" gesetzt sind, da die Länge von der Zeichenkette angegeben wird.
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_-_Nutzdaten_-_Länge_in_Byte
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
10100 00010100 00000000 00000000 00000000 2er-System
(Binär-System)
20 10er-System
(Dezimal-System)
14 14 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: Mit der Hilfe von diesem Wert wird die Länge von der Zeichenkette in Byte angegeben. Es handelt sich bei
  • dieser Zeichenkette um jene Zeichenkette, welche gelesen werden soll.

Wenn
  • das Lesen und Konvertieren nicht gestoppt werden soll, nur weil eine bestimmte Anzahl an Bytes erreicht wurde,
dann
  • kann für diesen Wert der höchstmögliche Wert angegeben werden und
  • stattdessen der Eingabe-Parameter "Quelle_-_Nutzdaten_-_Länge_in_Zeichen" für die Begrenzung verwendet werden.
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_-_Nutzdaten_-_Länge_in_Zeichen
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
11111111 11111111 11111111 11111111 11111111 11111111 11111111 11111111 2er-System
(Binär-System)
4.294.967.295 10er-System
(Dezimal-System)
FF FF FF FF FF FF FF FF 16er-System
(Hexadezimal-System)
Beschreibung: Mit der Hilfe von diesem Wert wird die Länge von der Zeichenkette in Zeichen angegeben. Es handelt sich bei
  • dieser Zeichenkette um jene Zeichenkette, welche gelesen werden soll.

Wenn
  • das Lesen und Konvertieren nicht gestoppt werden soll, nur weil eine bestimmte Anzahl an Zeichen erreicht wurde,
dann
  • kann für diesen Wert der höchstmögliche Wert angegeben werden und
  • stattdessen der Eingabe-Parameter "Quelle_-_Nutzdaten_-_Länge_in_Byte" für die Begrenzung verwendet werden.
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
101011 00010100 00011110 11111100 11111100 00011110 00010100 00101011 2er-System
(Binär-System)
722.738.940 10er-System
(Dezimal-System)
2B 14 1E FC FC 1E 14 2B 16er-System
(Hexadezimal-System)
Beschreibung: Mit der Hilfe von diesem Wert wird die Adresse von der Speicherstelle angegeben, an welcher die Zeichenkette beginnen soll. Es handelt sich bei
  • dieser Adresse um eine virtuelle Adresse vom Segment vom Programm.
  • dieser Zeichenkette um jene Zeichenkette, welche geschrieben werden soll.

Diese Ziel-Zeichenkette ist
  • in Byte gerechnet exakt 2 mal so lang
  • in Zeichen gerechnet exakt gleich lang
wie seine entsprechende Quell-Zeichenkette.

Wenn
  • für die Eingabe-Parameter
    • "Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil" und
    • "Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil"
    der selbe Wert verwendet wird,
dann
  • würde während dem Erzeugen von der Ziel-Zeichenkette ein Teil von den Quell-Zeichenkette überschrieben werden, welcher noch nicht ausgelesen wäre.

    Deshalb
    • gilt in diesem Fall der Funktionsdurchlauf als gescheitert und
    • wird eine entsprechende Fehler-Identifikationskennung zurückgegeben.
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Rückgabe
Anzahl: 4

Fehler_-_Identifikationskennung
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
0 00000000 00000000 00000000 00000000 2er-System
(Binär-System)
0 10er-System
(Dezimal-System)
0 00 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: Wenn
  • ein Fehler aufgetreten ist,
dann
  • wird die Fehler-Identifikationskennung zurückgegeben.

    Die Fehler-Identifikationskennung hat nie den Wert
    Wert gemäß Zahlensystem:
    der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
    0 00000000 00000000 00000000 00000000 2er-System
    (Binär-System)
    0 10er-System
    (Dezimal-System)
    0 00 00 00 00 16er-System
    (Hexadezimal-System)

    In diesem Fall wurden keine Daten an der Ziel-Speicherstelle gespeichert.
Ansonsten
  • wird der Wert
    Wert gemäß Zahlensystem:
    der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
    0 00000000 00000000 00000000 00000000 2er-System
    (Binär-System)
    0 10er-System
    (Dezimal-System)
    0 00 00 00 00 16er-System
    (Hexadezimal-System)
    zurückgegeben.
Fehler-Identifikationskennungen,
welche zurückgegeben werden können:
Beschreibung:
Bibliothek:
(in welcher der Fehler aufgetreten ist) 		conversion/character_encodings
Funktion:
(in welcher der Fehler aufgetreten ist) 		gemeinsamer Code
Abschnitt:
(in welchem der Fehler aufgetreten ist) 		Parameterwerte überprüfen.Quelle_-_*Adresse_-_*==Ziel_-_Adresse_-_*
Fehler-Beschreibung: Es wurde der selbe Wert für die beiden Parameter
  • "Quelle_-_*Adresse_-_virtueller_Teil" und
  • "Ziel_-_*Adresse_-_virtueller_Teil"
übergeben.

Dies ist nicht zulässig.

Wenn
  • die Ziel-Zeichenkette länger werden würde, als die Quell-Zeichenkette lang ist,
dann
  • würde die Konvertierung nicht ordnungsgemäß ablaufen.
Wert:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
100000 01100000 01000001 00000001 00000001 01000001 01100000 00100000 2er-System
(Binär-System)
543.179.009 10er-System
(Dezimal-System)
20 60 41 01 01 41 60 20 16er-System
(Hexadezimal-System)
Beschreibung:
Bibliothek:
(in welcher der Fehler aufgetreten ist) 		conversion/character_encodings
Funktion:
(in welcher der Fehler aufgetreten ist) 		gemeinsamer Code
Abschnitt:
(in welchem der Fehler aufgetreten ist) 		Parameterwerte überprüfen.Quelle_-_Nutzdaten_-_Länge_in_Byte==Quelle_-_Nutzdaten_-_Länge_in_Zeichen==FF FF FF FF|h
Fehler-Beschreibung: Es wurde der selbe Wert für die beiden Eingabe-Parameter
  • "Quelle_-_Nutzdaten_-_Länge_in_Byte" und
  • "Quelle_-_Nutzdaten_-_Länge_in_Zeichen"
übergeben. In beiden Fällen wurde der höchstmögliche Wert "FF FF FF FF|h" übergeben.

Dies ist nicht zulässig.

Wenn
  • für einen von den beiden Parametern der höchstzulässige Wert übergeben wird,
dann
  • bedeutet dies, dass
    • die Begrenzung durch diesen Parameter ignoriert werden soll und
    • die Begrenzung durch den anderen Parameter verwendet werden soll.

Wenn
  • für beide Parameter der höchstzulässige Wert übergeben werden würde,
dann
  • würde dies bedeuten, dass beide Begrenzungen ignoriert werden sollen.

    Es wäre also nicht festgelegt, wann die Funktion die Konvertierung beenden soll.
Wert:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
100000 01100000 01000010 00000001 00000001 01000010 01100000 00100000 2er-System
(Binär-System)
543.179.265 10er-System
(Dezimal-System)
20 60 42 01 01 42 60 20 16er-System
(Hexadezimal-System)
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		extended accumulator (eax)
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_-_Nutzdaten_-_Länge_in_Byte
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
10100 00010100 00000000 00000000 00000000 2er-System
(Binär-System)
20 10er-System
(Dezimal-System)
14 14 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: Mit der Hilfe von diesem Wert wird die Länge von der Zeichenkette in Byte angegenen. Es handelt sich bei
  • dieser Zeichenkette um jene Zeichenkette, welche mit der Hilfe vom Funktionsdurchlauf gelesen wurde.

Wenn
  • ein Fehler aufgetreten ist,
dann
  • wird der Wert
    Wert gemäß Zahlensystem:
    der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
    0 00000000 00000000 00000000 00000000 2er-System
    (Binär-System)
    0 10er-System
    (Dezimal-System)
    0 00 00 00 00 16er-System
    (Hexadezimal-System)
    zurückgegeben.
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_und_Ziel_-_Nutzdaten_-_Länge_in_Zeichen
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
10100 00010100 00000000 00000000 00000000 2er-System
(Binär-System)
20 10er-System
(Dezimal-System)
14 14 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: Mit der Hilfe von diesem Wert wird die Länge von der Zeichenkette in Zeichen angegenen. Es handelt sich bei
  • dieser Zeichenkette
    • sowohl um jene Zeichenkette, welche gelesen wurde,
    • als auch um jene Zeichenkette, welche geschrieben wurde.

Wenn
  • ein Fehler aufgetreten ist,
dann
  • wird der Wert
    Wert gemäß Zahlensystem:
    der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
    0 00000000 00000000 00000000 00000000 2er-System
    (Binär-System)
    0 10er-System
    (Dezimal-System)
    0 00 00 00 00 16er-System
    (Hexadezimal-System)
    zurückgegeben.
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Ziel_-_Nutzdaten_-_Länge_in_Byte
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
101000 00101000 00000000 00000000 00000000 2er-System
(Binär-System)
40 10er-System
(Dezimal-System)
28 28 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: Mit der Hilfe von diesem Wert wird die Länge von der Zeichenkette in Byte angegenen. Es handelt sich bei
  • dieser Zeichenkette um jene Zeichenkette, welche mit der Hilfe vom Funktionsdurchlauf erzeugt wurde.

Wenn
  • ein Fehler aufgetreten ist,
dann
  • wird der Wert
    Wert gemäß Zahlensystem:
    der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
    0 00000000 00000000 00000000 00000000 2er-System
    (Binär-System)
    0 10er-System
    (Dezimal-System)
    0 00 00 00 00 16er-System
    (Hexadezimal-System)
    zurückgegeben.
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

nach UTF-8

from_ISO_8859_1_to_UTF_8
allgemein
Name: from_ISO_8859_1_to_UTF_8
Beschreibung: Diese Funktion erzeugt
  • anhand von einer Zeichenkette, welche gemäß der Zeichenkodierung "International Organization for Standardization 8859-1" ("ISO 8859-1") kodiert ist,
  • eine neue Zeichenkette, welche gemäß der Zeichenkodierung "Unicode Transformation Format - 8 bit per part" ("UTF-8") kodiert ist.
Ereignismeldungen,
welche emittiert werden können: 		- Diese Funktion emittiert keine Ereignismeldung. -

Hinweis-Wert
Beschreibung: Ein Hinweis-Wert dient beim Dateiformat "portable executable" ("pe") um einen schnelleren Import zu ermöglichen.
Größe: 2 Byte
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen
Wert:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
1 00000001 00000000 2er-System
(Binär-System)
1 10er-System
(Dezimal-System)
1 01 00 16er-System
(Hexadezimal-System)

Parameter
Übersicht
(
Fehler_-_Identifikationskennung,
Quelle_-_Nutzdaten_-_Länge_in_Byte,
Quelle_und_Ziel_-_Nutzdaten_-_Länge_in_Zeichen,
Ziel_-_Nutzdaten_-_Länge_in_Byte
) = from_ISO_8859_1_to_UTF_8(
Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil,
Quelle_-_Nutzdaten_-_Länge_in_Byte,
Quelle_-_Nutzdaten_-_Länge_in_Zeichen,
Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil
)

Eingabe
Anzahl: 4

Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
101011 00010100 00011110 11101000 11101000 00011110 00010100 00101011 2er-System
(Binär-System)
722.738.920 10er-System
(Dezimal-System)
2B 14 1E E8 E8 1E 14 2B 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_-_Nutzdaten_-_Länge_in_Byte
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
10100 00010100 00000000 00000000 00000000 2er-System
(Binär-System)
20 10er-System
(Dezimal-System)
14 14 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_-_Nutzdaten_-_Länge_in_Zeichen
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
11111111 11111111 11111111 11111111 11111111 11111111 11111111 11111111 2er-System
(Binär-System)
4.294.967.295 10er-System
(Dezimal-System)
FF FF FF FF FF FF FF FF 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
101011 00010100 00011110 11111100 11111100 00011110 00010100 00101011 2er-System
(Binär-System)
722.738.940 10er-System
(Dezimal-System)
2B 14 1E FC FC 1E 14 2B 16er-System
(Hexadezimal-System)
Beschreibung: Mit der Hilfe von diesem Wert wird die Adresse von der Speicherstelle angegeben, an welcher die Zeichenkette beginnen soll. Es handelt sich bei
  • dieser Adresse um eine virtuelle Adresse vom Segment vom Programm.
  • dieser Zeichenkette um jene Zeichenkette, welche geschrieben werden soll.

Diese Ziel-Zeichenkette ist
  • in Byte gerechnet
    • mindestens gleich lang und
    • maximal 2 mal so lang
  • in Zeichen gerechnet exakt gleich lang
wie seine entsprechende Quell-Zeichenkette.

Wenn
  • für die Eingabe-Parameter
    • "Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil" und
    • "Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil"
    der selbe Wert verwendet wird,
dann
  • könnte während dem Erzeugen von der Ziel-Zeichenkette ein Teil von den Quell-Zeichenkette überschrieben werden, welcher noch nicht ausgelesen wäre.

    Deshalb
    • gilt in diesem Fall der Funktionsdurchlauf als gescheitert und
    • wird eine entsprechende Fehler-Identifikationskennung zurückgegeben.
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Rückgabe
Anzahl: 4

Fehler_-_Identifikationskennung
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
0 00000000 00000000 00000000 00000000 2er-System
(Binär-System)
0 10er-System
(Dezimal-System)
0 00 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Fehler-Identifikationskennungen,
welche zurückgegeben werden können:
Beschreibung:
Bibliothek:
(in welcher der Fehler aufgetreten ist) 		conversion/character_encodings
Funktion:
(in welcher der Fehler aufgetreten ist) 		gemeinsamer Code
Abschnitt:
(in welchem der Fehler aufgetreten ist) 		Parameterwerte überprüfen.Quelle_-_*Adresse_-_*==Ziel_-_Adresse_-_*
Fehler-Beschreibung: Es wurde der selbe Wert für die beiden Parameter
  • "Quelle_-_*Adresse_-_virtueller_Teil" und
  • "Ziel_-_*Adresse_-_virtueller_Teil"
übergeben.

Dies ist nicht zulässig.

Wenn
  • die Ziel-Zeichenkette länger werden würde, als die Quell-Zeichenkette lang ist,
dann
  • würde die Konvertierung nicht ordnungsgemäß ablaufen.
Wert:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
100000 01100000 01000001 00000001 00000001 01000001 01100000 00100000 2er-System
(Binär-System)
543.179.009 10er-System
(Dezimal-System)
20 60 41 01 01 41 60 20 16er-System
(Hexadezimal-System)
Beschreibung:
Bibliothek:
(in welcher der Fehler aufgetreten ist) 		conversion/character_encodings
Funktion:
(in welcher der Fehler aufgetreten ist) 		gemeinsamer Code
Abschnitt:
(in welchem der Fehler aufgetreten ist) 		Parameterwerte überprüfen.Quelle_-_Nutzdaten_-_Länge_in_Byte==Quelle_-_Nutzdaten_-_Länge_in_Zeichen==FF FF FF FF|h
Fehler-Beschreibung: Es wurde der selbe Wert für die beiden Eingabe-Parameter
  • "Quelle_-_Nutzdaten_-_Länge_in_Byte" und
  • "Quelle_-_Nutzdaten_-_Länge_in_Zeichen"
übergeben. In beiden Fällen wurde der höchstmögliche Wert "FF FF FF FF|h" übergeben.

Dies ist nicht zulässig.

Wenn
  • für einen von den beiden Parametern der höchstzulässige Wert übergeben wird,
dann
  • bedeutet dies, dass
    • die Begrenzung durch diesen Parameter ignoriert werden soll und
    • die Begrenzung durch den anderen Parameter verwendet werden soll.

Wenn
  • für beide Parameter der höchstzulässige Wert übergeben werden würde,
dann
  • würde dies bedeuten, dass beide Begrenzungen ignoriert werden sollen.

    Es wäre also nicht festgelegt, wann die Funktion die Konvertierung beenden soll.
Wert:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
100000 01100000 01000010 00000001 00000001 01000010 01100000 00100000 2er-System
(Binär-System)
543.179.265 10er-System
(Dezimal-System)
20 60 42 01 01 42 60 20 16er-System
(Hexadezimal-System)
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		extended accumulator (eax)
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_-_Nutzdaten_-_Länge_in_Byte
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
10100 00010100 00000000 00000000 00000000 2er-System
(Binär-System)
20 10er-System
(Dezimal-System)
14 14 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_und_Ziel_-_Nutzdaten_-_Länge_in_Zeichen
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
10100 00010100 00000000 00000000 00000000 2er-System
(Binär-System)
20 10er-System
(Dezimal-System)
14 14 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Ziel_-_Nutzdaten_-_Länge_in_Byte
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
10111 00010111 00000000 00000000 00000000 2er-System
(Binär-System)
23 10er-System
(Dezimal-System)
17 17 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

von UCS-2LE

nach ISO 8859-1

from_UCS_2LE_to_ISO_8859_1
allgemein
Name: from_UCS_2LE_to_ISO_8859_1
Beschreibung: Diese Funktion erzeugt
  • anhand von einer Zeichenkette, welche gemäß der Zeichenkodierung "Unicode Character Set - 2 byte per character; little endian encoded" ("UCS-2LE") kodiert ist,
  • eine neue Zeichenkette, welche gemäß der Zeichenkodierung "International Organization for Standardization 8859-1" ("ISO 8859-1") kodiert ist.

Wenn
  • ein bestimmtes Zeichen nicht umgewandelt werden kann,
dann
  • wird dieses Zeichen
    • bei den Längen-Angaben mitgezählt und
    • nicht in die erzeugte Zeichenkette eingefügt, sondern stattdessen wird das Ersatzzeichen "?" (ein Fragezeichen) eingefügt.
Ereignismeldungen,
welche emittiert werden können: 		- Diese Funktion emittiert keine Ereignismeldung. -

Hinweis-Wert
Beschreibung: Ein Hinweis-Wert dient beim Dateiformat "portable executable" ("pe") um einen schnelleren Import zu ermöglichen.
Größe: 2 Byte
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen
Wert:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
10 00000010 00000000 2er-System
(Binär-System)
2 10er-System
(Dezimal-System)
2 02 00 16er-System
(Hexadezimal-System)

Parameter
Übersicht
(
Fehler_-_Identifikationskennung,
Quelle_-_Nutzdaten_-_Länge_in_Byte,
Quelle_und_Ziel_-_Nutzdaten_-_Länge_in_Zeichen,
Ziel_-_Nutzdaten_-_Länge_in_Byte
) = from_UCS_2LE_to_ISO_8859_1(
Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil,
Quelle_-_Nutzdaten_-_Länge_in_Byte,
Quelle_-_Nutzdaten_-_Länge_in_Zeichen,
Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil
)

Eingabe
Anzahl: 4

Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
101011 00010100 00011110 11101000 11101000 00011110 00010100 00101011 2er-System
(Binär-System)
722.738.920 10er-System
(Dezimal-System)
2B 14 1E E8 E8 1E 14 2B 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_-_Nutzdaten_-_Länge_in_Byte
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
101000 00101000 00000000 00000000 00000000 2er-System
(Binär-System)
40 10er-System
(Dezimal-System)
28 28 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_-_Nutzdaten_-_Länge_in_Zeichen
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
11111111 11111111 11111111 11111111 11111111 11111111 11111111 11111111 2er-System
(Binär-System)
4.294.967.295 10er-System
(Dezimal-System)
FF FF FF FF FF FF FF FF 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
101011 00010100 00011111 00010000 00010000 00011111 00010100 00101011 2er-System
(Binär-System)
722.738.960 10er-System
(Dezimal-System)
2B 14 1F 10 10 1F 14 2B 16er-System
(Hexadezimal-System)
Beschreibung: Mit der Hilfe von diesem Wert wird die Adresse von der Speicherstelle angegeben, an welcher die Zeichenkette beginnen soll. Es handelt sich bei
  • dieser Adresse um eine virtuelle Adresse vom Segment vom Programm.
  • dieser Zeichenkette um jene Zeichenkette, welche geschrieben werden soll.

Diese Ziel-Zeichenkette ist
  • in Byte gerechnet exakt 1/2 mal so lang
  • in Zeichen gerechnet exakt gleich lang
wie seine entsprechende Quell-Zeichenkette.

Wenn
  • für die Eingabe-Parameter
    • "Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil" und
    • "Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil"
    der selbe Wert verwendet wird,
dann
  • wird während dem Erzeugen von der Ziel-Zeichenkette kein Teil von den Quell-Zeichenkette überschrieben, welcher noch nicht ausgelesen wurde.
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Rückgabe
Anzahl: 4

Fehler_-_Identifikationskennung
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
0 00000000 00000000 00000000 00000000 2er-System
(Binär-System)
0 10er-System
(Dezimal-System)
0 00 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Fehler-Identifikationskennungen,
welche zurückgegeben werden können:
Beschreibung:
Bibliothek:
(in welcher der Fehler aufgetreten ist) 		conversion/character_encodings
Funktion:
(in welcher der Fehler aufgetreten ist) 		gemeinsamer Code
Abschnitt:
(in welchem der Fehler aufgetreten ist) 		Parameterwerte überprüfen.Quelle_-_Nutzdaten_-_Länge_in_Byte==Quelle_-_Nutzdaten_-_Länge_in_Zeichen==FF FF FF FF|h
Fehler-Beschreibung: Es wurde der selbe Wert für die beiden Eingabe-Parameter
  • "Quelle_-_Nutzdaten_-_Länge_in_Byte" und
  • "Quelle_-_Nutzdaten_-_Länge_in_Zeichen"
übergeben. In beiden Fällen wurde der höchstmögliche Wert "FF FF FF FF|h" übergeben.

Dies ist nicht zulässig.

Wenn
  • für einen von den beiden Parametern der höchstzulässige Wert übergeben wird,
dann
  • bedeutet dies, dass
    • die Begrenzung durch diesen Parameter ignoriert werden soll und
    • die Begrenzung durch den anderen Parameter verwendet werden soll.

Wenn
  • für beide Parameter der höchstzulässige Wert übergeben werden würde,
dann
  • würde dies bedeuten, dass beide Begrenzungen ignoriert werden sollen.

    Es wäre also nicht festgelegt, wann die Funktion die Konvertierung beenden soll.
Wert:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
100000 01100000 01000010 00000001 00000001 01000010 01100000 00100000 2er-System
(Binär-System)
543.179.265 10er-System
(Dezimal-System)
20 60 42 01 01 42 60 20 16er-System
(Hexadezimal-System)
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		extended accumulator (eax)
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_-_Nutzdaten_-_Länge_in_Byte
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
101000 00101000 00000000 00000000 00000000 2er-System
(Binär-System)
40 10er-System
(Dezimal-System)
28 28 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_und_Ziel_-_Nutzdaten_-_Länge_in_Zeichen
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
10100 00010100 00000000 00000000 00000000 2er-System
(Binär-System)
20 10er-System
(Dezimal-System)
14 14 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Ziel_-_Nutzdaten_-_Länge_in_Byte
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
10100 00010100 00000000 00000000 00000000 2er-System
(Binär-System)
20 10er-System
(Dezimal-System)
14 14 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

nach UTF-8

from_UCS_2LE_to_UTF_8
allgemein
Name: from_UCS_2LE_to_UTF_8
Beschreibung: Diese Funktion erzeugt
  • anhand von einer Zeichenkette, welche gemäß der Zeichenkodierung "Unicode Character Set - 2 byte per character; little endian encoded" ("UCS-2LE") kodiert ist,
  • eine neue Zeichenkette, welche gemäß der Zeichenkodierung "Unicode Transformation Format - 8 bit per part" ("UTF-8") kodiert ist.
Ereignismeldungen,
welche emittiert werden können: 		- Diese Funktion emittiert keine Ereignismeldung. -

Hinweis-Wert
Beschreibung: Ein Hinweis-Wert dient beim Dateiformat "portable executable" ("pe") um einen schnelleren Import zu ermöglichen.
Größe: 2 Byte
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen
Wert:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
11 00000011 00000000 2er-System
(Binär-System)
3 10er-System
(Dezimal-System)
3 03 00 16er-System
(Hexadezimal-System)

Parameter
Übersicht
(
Fehler_-_Identifikationskennung,
Quelle_-_Nutzdaten_-_Länge_in_Byte,
Quelle_und_Ziel_-_Nutzdaten_-_Länge_in_Zeichen,
Ziel_-_Nutzdaten_-_Länge_in_Byte
) = from_UCS_2LE_to_UTF_8(
Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil,
Quelle_-_Nutzdaten_-_Länge_in_Byte,
Quelle_-_Nutzdaten_-_Länge_in_Zeichen,
Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil
)

Eingabe
Anzahl: 4

Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
101011 00010100 00011110 11101000 11101000 00011110 00010100 00101011 2er-System
(Binär-System)
722.738.920 10er-System
(Dezimal-System)
2B 14 1E E8 E8 1E 14 2B 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_-_Nutzdaten_-_Länge_in_Byte
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
101000 00101000 00000000 00000000 00000000 2er-System
(Binär-System)
40 10er-System
(Dezimal-System)
28 28 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_-_Nutzdaten_-_Länge_in_Zeichen
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
11111111 11111111 11111111 11111111 11111111 11111111 11111111 11111111 2er-System
(Binär-System)
4.294.967.295 10er-System
(Dezimal-System)
FF FF FF FF FF FF FF FF 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
101011 00010100 00011111 00010000 00010000 00011111 00010100 00101011 2er-System
(Binär-System)
722.738.960 10er-System
(Dezimal-System)
2B 14 1F 10 10 1F 14 2B 16er-System
(Hexadezimal-System)
Beschreibung: Mit der Hilfe von diesem Wert wird die Adresse von der Speicherstelle angegeben, an welcher die Zeichenkette beginnen soll. Es handelt sich bei
  • dieser Adresse um eine virtuelle Adresse vom Segment vom Programm.
  • dieser Zeichenkette um jene Zeichenkette, welche geschrieben werden soll.

Diese Ziel-Zeichenkette ist
  • in Byte gerechnet
    • mindestens 1/2 mal so lang und
    • maximal 1 1/2 mal so lang
  • in Zeichen gerechnet exakt gleich lang
wie seine entsprechende Quell-Zeichenkette.

Wenn
  • für die Eingabe-Parameter
    • "Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil" und
    • "Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil"
    der selbe Wert verwendet wird,
dann
  • könnte während dem Erzeugen von der Ziel-Zeichenkette ein Teil von den Quell-Zeichenkette überschrieben werden, welcher noch nicht ausgelesen wäre.

    Deshalb
    • gilt in diesem Fall der Funktionsdurchlauf als gescheitert und
    • wird eine entsprechende Fehler-Identifikationskennung zurückgegeben.
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Rückgabe
Anzahl: 4

Fehler_-_Identifikationskennung
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
0 00000000 00000000 00000000 00000000 2er-System
(Binär-System)
0 10er-System
(Dezimal-System)
0 00 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Fehler-Identifikationskennungen,
welche zurückgegeben werden können:
Beschreibung:
Bibliothek:
(in welcher der Fehler aufgetreten ist) 		conversion/character_encodings
Funktion:
(in welcher der Fehler aufgetreten ist) 		gemeinsamer Code
Abschnitt:
(in welchem der Fehler aufgetreten ist) 		Parameterwerte überprüfen.Quelle_-_*Adresse_-_*==Ziel_-_Adresse_-_*
Fehler-Beschreibung: Es wurde der selbe Wert für die beiden Parameter
  • "Quelle_-_*Adresse_-_virtueller_Teil" und
  • "Ziel_-_*Adresse_-_virtueller_Teil"
übergeben.

Dies ist nicht zulässig.

Wenn
  • die Ziel-Zeichenkette länger werden würde, als die Quell-Zeichenkette lang ist,
dann
  • würde die Konvertierung nicht ordnungsgemäß ablaufen.
Wert:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
100000 01100000 01000001 00000001 00000001 01000001 01100000 00100000 2er-System
(Binär-System)
543.179.009 10er-System
(Dezimal-System)
20 60 41 01 01 41 60 20 16er-System
(Hexadezimal-System)
Beschreibung:
Bibliothek:
(in welcher der Fehler aufgetreten ist) 		conversion/character_encodings
Funktion:
(in welcher der Fehler aufgetreten ist) 		gemeinsamer Code
Abschnitt:
(in welchem der Fehler aufgetreten ist) 		Parameterwerte überprüfen.Quelle_-_Nutzdaten_-_Länge_in_Byte==Quelle_-_Nutzdaten_-_Länge_in_Zeichen==FF FF FF FF|h
Fehler-Beschreibung: Es wurde der selbe Wert für die beiden Eingabe-Parameter
  • "Quelle_-_Nutzdaten_-_Länge_in_Byte" und
  • "Quelle_-_Nutzdaten_-_Länge_in_Zeichen"
übergeben. In beiden Fällen wurde der höchstmögliche Wert "FF FF FF FF|h" übergeben.

Dies ist nicht zulässig.

Wenn
  • für einen von den beiden Parametern der höchstzulässige Wert übergeben wird,
dann
  • bedeutet dies, dass
    • die Begrenzung durch diesen Parameter ignoriert werden soll und
    • die Begrenzung durch den anderen Parameter verwendet werden soll.

Wenn
  • für beide Parameter der höchstzulässige Wert übergeben werden würde,
dann
  • würde dies bedeuten, dass beide Begrenzungen ignoriert werden sollen.

    Es wäre also nicht festgelegt, wann die Funktion die Konvertierung beenden soll.
Wert:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
100000 01100000 01000010 00000001 00000001 01000010 01100000 00100000 2er-System
(Binär-System)
543.179.265 10er-System
(Dezimal-System)
20 60 42 01 01 42 60 20 16er-System
(Hexadezimal-System)
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		extended accumulator (eax)
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_-_Nutzdaten_-_Länge_in_Byte
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
101000 00101000 00000000 00000000 00000000 2er-System
(Binär-System)
40 10er-System
(Dezimal-System)
28 28 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_und_Ziel_-_Nutzdaten_-_Länge_in_Zeichen
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
10100 00010100 00000000 00000000 00000000 2er-System
(Binär-System)
20 10er-System
(Dezimal-System)
14 14 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Ziel_-_Nutzdaten_-_Länge_in_Byte
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
10111 00010111 00000000 00000000 00000000 2er-System
(Binär-System)
23 10er-System
(Dezimal-System)
17 17 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

von UTF-8

nach ISO 8859-1

from_UTF_8_to_ISO_8859_1
allgemein
Name: from_UTF_8_to_ISO_8859_1
Beschreibung: Diese Funktion erzeugt
  • anhand von einer Zeichenkette, welche gemäß der Zeichenkodierung "Unicode Transformation Format - 8 bit per part" ("UTF-8") kodiert ist,
  • eine neue Zeichenkette, welche gemäß der Zeichenkodierung "International Organization for Standardization 8859-1" ("ISO 8859-1") kodiert ist.

Wenn
  • ein bestimmtes Zeichen nicht umgewandelt werden kann,
dann
  • wird dieses Zeichen
    • bei den Längen-Angaben mitgezählt und
    • nicht in die erzeugte Zeichenkette eingefügt, sondern stattdessen wird das Ersatzzeichen "?" (ein Fragezeichen) eingefügt.
Ereignismeldungen,
welche emittiert werden können: 		- Diese Funktion emittiert keine Ereignismeldung. -

Hinweis-Wert
Beschreibung: Ein Hinweis-Wert dient beim Dateiformat "portable executable" ("pe") um einen schnelleren Import zu ermöglichen.
Größe: 2 Byte
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen
Wert:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
100 00000100 00000000 2er-System
(Binär-System)
4 10er-System
(Dezimal-System)
4 04 00 16er-System
(Hexadezimal-System)

Parameter
Übersicht
(
Fehler_-_Identifikationskennung,
Quelle_-_Nutzdaten_-_Länge_in_Byte,
Quelle_und_Ziel_-_Nutzdaten_-_Länge_in_Zeichen,
Ziel_-_Nutzdaten_-_Länge_in_Byte
) = from_UTF_8_to_ISO_8859_1(
Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil,
Quelle_-_Nutzdaten_-_Länge_in_Byte,
Quelle_-_Nutzdaten_-_Länge_in_Zeichen,
Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil
)

Eingabe
Anzahl: 4

Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
101011 00010100 00011110 11101000 11101000 00011110 00010100 00101011 2er-System
(Binär-System)
722.738.920 10er-System
(Dezimal-System)
2B 14 1E E8 E8 1E 14 2B 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_-_Nutzdaten_-_Länge_in_Byte
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
10111 00010111 00000000 00000000 00000000 2er-System
(Binär-System)
23 10er-System
(Dezimal-System)
17 17 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_-_Nutzdaten_-_Länge_in_Zeichen
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
11111111 11111111 11111111 11111111 11111111 11111111 11111111 11111111 2er-System
(Binär-System)
4.294.967.295 10er-System
(Dezimal-System)
FF FF FF FF FF FF FF FF 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
101011 00010100 00011110 11111111 11111111 00011110 00010100 00101011 2er-System
(Binär-System)
722.738.943 10er-System
(Dezimal-System)
2B 14 1E FF FF 1E 14 2B 16er-System
(Hexadezimal-System)
Beschreibung: Mit der Hilfe von diesem Wert wird die Adresse von der Speicherstelle angegeben, an welcher die Zeichenkette beginnen soll. Es handelt sich bei
  • dieser Adresse um eine virtuelle Adresse vom Segment vom Programm.
  • dieser Zeichenkette um jene Zeichenkette, welche geschrieben werden soll.

Diese Ziel-Zeichenkette ist
  • in Byte gerechnet
    • mindestens 1/2 mal so lang und
    • maximal gleich lang
  • in Zeichen gerechnet exakt gleich lang
wie seine entsprechende Quell-Zeichenkette.

Wenn
  • für die Eingabe-Parameter
    • "Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil" und
    • "Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil"
    der selbe Wert verwendet wird,
dann
  • wird während dem Erzeugen von der Ziel-Zeichenkette kein Teil von den Quell-Zeichenkette überschrieben, welcher noch nicht ausgelesen wurde.
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Rückgabe
Anzahl: 4

Fehler_-_Identifikationskennung
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
0 00000000 00000000 00000000 00000000 2er-System
(Binär-System)
0 10er-System
(Dezimal-System)
0 00 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Fehler-Identifikationskennungen,
welche zurückgegeben werden können:
Beschreibung:
Bibliothek:
(in welcher der Fehler aufgetreten ist) 		conversion/character_encodings
Funktion:
(in welcher der Fehler aufgetreten ist) 		gemeinsamer Code
Abschnitt:
(in welchem der Fehler aufgetreten ist) 		Parameterwerte überprüfen.Quelle_-_Nutzdaten_-_Länge_in_Byte==Quelle_-_Nutzdaten_-_Länge_in_Zeichen==FF FF FF FF|h
Fehler-Beschreibung: Es wurde der selbe Wert für die beiden Eingabe-Parameter
  • "Quelle_-_Nutzdaten_-_Länge_in_Byte" und
  • "Quelle_-_Nutzdaten_-_Länge_in_Zeichen"
übergeben. In beiden Fällen wurde der höchstmögliche Wert "FF FF FF FF|h" übergeben.

Dies ist nicht zulässig.

Wenn
  • für einen von den beiden Parametern der höchstzulässige Wert übergeben wird,
dann
  • bedeutet dies, dass
    • die Begrenzung durch diesen Parameter ignoriert werden soll und
    • die Begrenzung durch den anderen Parameter verwendet werden soll.

Wenn
  • für beide Parameter der höchstzulässige Wert übergeben werden würde,
dann
  • würde dies bedeuten, dass beide Begrenzungen ignoriert werden sollen.

    Es wäre also nicht festgelegt, wann die Funktion die Konvertierung beenden soll.
Wert:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
100000 01100000 01000010 00000001 00000001 01000010 01100000 00100000 2er-System
(Binär-System)
543.179.265 10er-System
(Dezimal-System)
20 60 42 01 01 42 60 20 16er-System
(Hexadezimal-System)
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		extended accumulator (eax)
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_-_Nutzdaten_-_Länge_in_Byte
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
10111 00010111 00000000 00000000 00000000 2er-System
(Binär-System)
23 10er-System
(Dezimal-System)
17 17 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_und_Ziel_-_Nutzdaten_-_Länge_in_Zeichen
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
10100 00010100 00000000 00000000 00000000 2er-System
(Binär-System)
20 10er-System
(Dezimal-System)
14 14 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Ziel_-_Nutzdaten_-_Länge_in_Byte
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
10100 00010100 00000000 00000000 00000000 2er-System
(Binär-System)
20 10er-System
(Dezimal-System)
14 14 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

nach UCS-2LE

from_UTF_8_to_UCS_2LE
allgemein
Name: from_UTF_8_to_UCS_2LE
Beschreibung: Diese Funktion erzeugt
  • anhand von einer Zeichenkette, welche gemäß der Zeichenkodierung "Unicode Transformation Format - 8 bit per part" ("UTF-8") kodiert ist,
  • eine neue Zeichenkette, welche gemäß der Zeichenkodierung "Unicode Character Set - 2 byte per character; little endian encoded" ("UCS-2LE") kodiert ist.

Wenn
  • ein bestimmtes Zeichen nicht umgewandelt werden kann,
dann
  • wird dieses Zeichen
    • bei den Längen-Angaben mitgezählt und
    • nicht in die erzeugte Zeichenkette eingefügt, sondern stattdessen wird das Ersatzzeichen "?" (ein Fragezeichen) eingefügt.
Ereignismeldungen,
welche emittiert werden können: 		- Diese Funktion emittiert keine Ereignismeldung. -

Hinweis-Wert
Beschreibung: Ein Hinweis-Wert dient beim Dateiformat "portable executable" ("pe") um einen schnelleren Import zu ermöglichen.
Größe: 2 Byte
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen
Wert:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
101 00000101 00000000 2er-System
(Binär-System)
5 10er-System
(Dezimal-System)
5 05 00 16er-System
(Hexadezimal-System)

Parameter
Übersicht
(
Fehler_-_Identifikationskennung,
Quelle_-_Nutzdaten_-_Länge_in_Byte,
Quelle_und_Ziel_-_Nutzdaten_-_Länge_in_Zeichen,
Ziel_-_Nutzdaten_-_Länge_in_Byte
) = from_UTF_8_to_UCS_2LE(
Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil,
Quelle_-_Nutzdaten_-_Länge_in_Byte,
Quelle_-_Nutzdaten_-_Länge_in_Zeichen,
Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil
)

Eingabe
Anzahl: 4

Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
101011 00010100 00011110 11101000 11101000 00011110 00010100 00101011 2er-System
(Binär-System)
722.738.920 10er-System
(Dezimal-System)
2B 14 1E E8 E8 1E 14 2B 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_-_Nutzdaten_-_Länge_in_Byte
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
10111 00010111 00000000 00000000 00000000 2er-System
(Binär-System)
23 10er-System
(Dezimal-System)
17 17 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_-_Nutzdaten_-_Länge_in_Zeichen
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
11111111 11111111 11111111 11111111 11111111 11111111 11111111 11111111 2er-System
(Binär-System)
4.294.967.295 10er-System
(Dezimal-System)
FF FF FF FF FF FF FF FF 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
101011 00010100 00011110 11111111 11111111 00011110 00010100 00101011 2er-System
(Binär-System)
722.738.943 10er-System
(Dezimal-System)
2B 14 1E FF FF 1E 14 2B 16er-System
(Hexadezimal-System)
Beschreibung: Mit der Hilfe von diesem Wert wird die Adresse von der Speicherstelle angegeben, an welcher die Zeichenkette beginnen soll. Es handelt sich bei
  • dieser Adresse um eine virtuelle Adresse vom Segment vom Programm.
  • dieser Zeichenkette um jene Zeichenkette, welche geschrieben werden soll.

Diese Ziel-Zeichenkette ist
  • in Byte gerechnet
    • mindestens 2/3 mal so lang und
    • maximal 2 mal so lang
  • in Zeichen gerechnet exakt gleich lang
wie seine entsprechende Quell-Zeichenkette.

Wenn
  • für die Eingabe-Parameter
    • "Quelle_-_Nutzdaten_-_Adresse_-_virtueller_Teil" und
    • "Ziel_-_Nutzdaten_-_Adresse_-_virtueller_Teil"
    der selbe Wert verwendet wird,
dann
  • könnte während dem Erzeugen von der Ziel-Zeichenkette ein Teil von den Quell-Zeichenkette überschrieben werden, welcher noch nicht ausgelesen wäre.

    Deshalb
    • gilt in diesem Fall der Funktionsdurchlauf als gescheitert und
    • wird eine entsprechende Fehler-Identifikationskennung zurückgegeben.
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Rückgabe
Anzahl: 4

Fehler_-_Identifikationskennung
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
0 00000000 00000000 00000000 00000000 2er-System
(Binär-System)
0 10er-System
(Dezimal-System)
0 00 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Fehler-Identifikationskennungen,
welche zurückgegeben werden können:
Beschreibung:
Bibliothek:
(in welcher der Fehler aufgetreten ist) 		conversion/character_encodings
Funktion:
(in welcher der Fehler aufgetreten ist) 		gemeinsamer Code
Abschnitt:
(in welchem der Fehler aufgetreten ist) 		Parameterwerte überprüfen.Quelle_-_*Adresse_-_*==Ziel_-_Adresse_-_*
Fehler-Beschreibung: Es wurde der selbe Wert für die beiden Parameter
  • "Quelle_-_*Adresse_-_virtueller_Teil" und
  • "Ziel_-_*Adresse_-_virtueller_Teil"
übergeben.

Dies ist nicht zulässig.

Wenn
  • die Ziel-Zeichenkette länger werden würde, als die Quell-Zeichenkette lang ist,
dann
  • würde die Konvertierung nicht ordnungsgemäß ablaufen.
Wert:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
100000 01100000 01000001 00000001 00000001 01000001 01100000 00100000 2er-System
(Binär-System)
543.179.009 10er-System
(Dezimal-System)
20 60 41 01 01 41 60 20 16er-System
(Hexadezimal-System)
Beschreibung:
Bibliothek:
(in welcher der Fehler aufgetreten ist) 		conversion/character_encodings
Funktion:
(in welcher der Fehler aufgetreten ist) 		gemeinsamer Code
Abschnitt:
(in welchem der Fehler aufgetreten ist) 		Parameterwerte überprüfen.Quelle_-_Nutzdaten_-_Länge_in_Byte==Quelle_-_Nutzdaten_-_Länge_in_Zeichen==FF FF FF FF|h
Fehler-Beschreibung: Es wurde der selbe Wert für die beiden Eingabe-Parameter
  • "Quelle_-_Nutzdaten_-_Länge_in_Byte" und
  • "Quelle_-_Nutzdaten_-_Länge_in_Zeichen"
übergeben. In beiden Fällen wurde der höchstmögliche Wert "FF FF FF FF|h" übergeben.

Dies ist nicht zulässig.

Wenn
  • für einen von den beiden Parametern der höchstzulässige Wert übergeben wird,
dann
  • bedeutet dies, dass
    • die Begrenzung durch diesen Parameter ignoriert werden soll und
    • die Begrenzung durch den anderen Parameter verwendet werden soll.

Wenn
  • für beide Parameter der höchstzulässige Wert übergeben werden würde,
dann
  • würde dies bedeuten, dass beide Begrenzungen ignoriert werden sollen.

    Es wäre also nicht festgelegt, wann die Funktion die Konvertierung beenden soll.
Wert:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
100000 01100000 01000010 00000001 00000001 01000010 01100000 00100000 2er-System
(Binär-System)
543.179.265 10er-System
(Dezimal-System)
20 60 42 01 01 42 60 20 16er-System
(Hexadezimal-System)
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		extended accumulator (eax)
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_-_Nutzdaten_-_Länge_in_Byte
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
10111 00010111 00000000 00000000 00000000 2er-System
(Binär-System)
23 10er-System
(Dezimal-System)
17 17 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Quelle_und_Ziel_-_Nutzdaten_-_Länge_in_Zeichen
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
10100 00010100 00000000 00000000 00000000 2er-System
(Binär-System)
20 10er-System
(Dezimal-System)
14 14 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Ziel_-_Nutzdaten_-_Länge_in_Byte
Beispiel:
Wert gemäß Zahlensystem:
der regulären Schreibweise: dem Variablentyp "Ganzzahl ohne Vorzeichen":
101000 00101000 00000000 00000000 00000000 2er-System
(Binär-System)
40 10er-System
(Dezimal-System)
28 28 00 00 00 16er-System
(Hexadezimal-System)
Beschreibung: siehe: hier
Größe: 4 Byte
Speicherzelle,
welche für die Übergabe vom Wert dient: 		Stapel
Variablentyp,
gemäß welchem der Wert zu interpretieren ist: 		Ganzzahl ohne Vorzeichen

Stichwortverzeichnis

Funktionen

Namen

anhand von den Kategorien gruppiert


ungruppiert

weiteres Material zu diesem Thema

Bibliotheken

Name Beschreibung: Weblink:
vom Autor: von der Bibliothek:
conversion/character_encodings Dies ist die allgemeinfreie und kostenlose Bibliothek, welche in diesem Dokument beschrieben ist. ../../Betriebssystem-spezifisches/
../../Betriebssystem-unspezifisches/

Dokumente

Name vom Sprache: Umfang vom Inhalt: Weblink:
Autor: Dokument:
Zeichenkodierungen deutsch
  • beschreibt verschiedene Zeichenkodierungen
 OnTheServer.de/Downloads/

über Dateiformate

Name vom Sprache: Umfang vom Inhalt: Weblink:
Autor: Dokument:
Betriebssystem-spezifische - Linux - Dateiformate - ausführbare Dateien und Bibliotheken deutsch
  • beschreibt das Dateiformat "executable and linking" ("elf"), also das Dateiformat, welches in Linux für
    • ausführbare Dateien und
    • Bibliotheken
    verwendet wird
  • zeigt Schritt für Schritt, wie mit der Hilfe von einem Hex-Editor
    • ein "Hallo Welt!"-Programm und
    • eine Bibliothek mit einer "Hallo Welt!"-Funktion
    geschrieben werden kann.
OnTheServer.de/Downloads/
Betriebssystem-spezifische - Windows - Dateiformate - ausführbare Dateien und Bibliotheken
  • behandelt das Dateiformat "portable executable" ("pe"), also das Dateiformat, welches in Windows für
    • ausführbare Dateien und
    • Bibliotheken
    verwendet wird
  • zeigt Schritt für Schritt, wie mit der Hilfe von einem Hex-Editor
    • ein "Hallo Welt!"-Programm und
    • eine Bibliothek mit einer "Hallo Welt!"-Funktion
    geschrieben werden kann.

Programme

Name vom Beschreibung: notwendiges Betriebssystem: Sprache: Weblink:
Autor: Programm:
Steve Hutchesson Binary to Hex Editor "Binary to Hex Editor" ist ein kostenloses, minimalistisches, "20 Kilobyte"-großes Programm mit grafischer Benutzeroberfläche. Das Programm ist nicht allgemeinfrei und den Quelltext bekommt man glaube ich auch nicht.

Funktionen:
  • Hexeditor, mit welchem man Rohdaten-Dateien öffnen und editieren kann
  • Speicherung von der hexadezimal-Darstellung von einer Rohdaten-Datei als ASCII-kodierte Textdatei
  • Speicherung von einer hexadezimal-Darstellung als Rohdaten-Datei

Nachteilhaft ist allerdings, dass es lange braucht und viel Arbeitsspeicher notwendig ist, um große Dateien zu öffnen. 		Windows englisch movsd.com/download/b2hedit.zip
Fehler-Identifikationskennung → Fehlermeldung Dies ist ein kostenloses Konsolen-Programm. Das Programm ist allgemeinfrei.

Funktionen:
  • kann anhand von einer vorgegebenen Fehler-Identifikationskennung eine Fehlermeldung anzeigen
 deutsch OnTheServer.de/Downloads/

Sonstiges

Name vom Beschreibung: Sprache: Weblink:
Autor: Material:
Import-Definitionsdatei für Minicode Diese Datei enthält die Import-Definitionen, um die Bibliothek "conversion/character_encodings" mit der Hilfe von der Programmiersprache "Minicode" zu verwenden. Minicode ../Minicode/
conversion/character_encodings.mico-imde

Aufnahme von weiteren Materialien

Wenn dann
Sie dürfen durchaus auch Ihre eigenen Materialien zuschicken.

Bei den zugesendeten Materialien werde ich beurteilen, ob sie sich für die Auflistung eignen. Manche Materialien werden nicht aufgenommen, weil beispielsweise ein Hinweis enthalten ist, dass Es besteht kein Anspruch darauf, dass zugesendete Materialien aufgenommen werden.

Link zum Kapitel "wie man den Verfasser kontaktiert".