prevnext   » Startseite » Haupt-Referenz » Funktions-Referenz » endian()

endian()

Eine Ganzzahl wird in bzw. aus einer Zeichenkette mit angegebener Endian-Folge gewandelt.

Syntax:

string endian ( int:source, bool:big_endian )
none/int endian ( string:source, bool:big_endian )

Parameter:

source Die Quelle der Umwandlung sollte entweder als Ganzzahl (32 oder 64 Bit) oder als Zeichenkettemit genau 4 oder 8 Zeichen vorliegen. Alle anderen Formate führen zum Fehlerergebnis NONE mit Fehlerstatus _ERR_VALUE.
big_endian Dieser Parameter wird mittels bool() zwangsweise in einen Wahrheitswert gewandelt. Ist der Wert nach der Wandlung TRUE, dann enthält das erste Zeichen der Zeichenkette das höchstwertige Byte der Ganzzahl. Anderenfalls ist der Wert FALSE und das erste Zeichen der Zeichenkette enthält das niederwertigste Byte der Ganzzahl. Für diesen Parameter sind die Konstanten _LITTLE_ENDIAN, _BIG_ENDIAN, _LOCAL_ENDIAN und _REVERSE_ENDIAN, die alle unten beschrieben sind, vorgesehen.

Beschreibung:

Es wird eine der vier folgenden Umwandlungen durchgeführt:

Bei einem ungültigen Parameter ist das Ergebnis vom Typ NONE und der Fehlerstatus _ERR_VALUE wird gesetzt.

Konstanten für Parameter big_endian:

Der Endian wird mit dem Parameter big_endian gefiniert. Hierzu gibt es die vier folgenden Konstanten:

Konstante Wert Beschreibung
_LITTLE_ENDIAN 0 Das erste Zeichen der Zeichenkette enthält das niederwertigste Byte der Ganzzahl.
_BIG_ENDIAN 2 Das erste Zeichen der Zeichenkette enthält das höchstwertigste Byte der Ganzzahl.
_LOCAL_ENDIAN ? Dieses Konstante ist gemäß des lokalen Systems entweder _LITTLE_ENDIAN oder _BIG_ENDIAN.
_REVERSE_ENDIAN ? Dieses Konstante ist entweder _LITTLE_ENDIAN oder _BIG_ENDIAN, wobei gilt: _REVERSE_ENDIAN := not(_LOCAL_ENDIAN)

Alternative Funktionen:

Unter der Voraussetzung, das x vom Typ INT32 ist, gilt:
char(x,4) == endian(x,_little_endian)

Unter der Voraussetzung, das x eine Zeichenkette mit genau 4 Zeichen ist, gilt:
ord(x,4) == endian(x,_little_endian)

Funktionsergebnis:   NONE/INT32/INT64/STRING

Das Funktionsergebnis ist wie oben beschrieben.

Siehe auch:
 char()   ord()   reverse() 

Weitere ähnliche Funktionen:

Zeichenketten, Transformation
Funktion Kurzinfo
ansi2dos()
breakIntoLines()
capitals() Den ersten Buchstabe jedes Wortes in einen Großbuchstaben und alle anderen Buchstaben in Kleinbuchstaben wandeln.
char()
charMB()
chgCase() Alle Kleinbuchstaben in Großbuchstaben und umgekehrt wandeln.
decode64()
dos2ansi()
encode64()
endian() Eine Ganzzahl wird in bzw. aus einer Zeichenkette mit angegebener Endian-Folge gewandelt.
expand() Eine Zeichenkette auf eine festgelegte Größe erweitern.
getCoding() Die Kodiermethode einer Zeichenkette ermittlen oder ersatzweise erraten.
hexDump() Eine Zeichenkette als Hex-Dump ausgeben.
indent()
lower() Alle Großbuchstaben in Kleinbuchstaben wandeln.
ord()
ordMB()
query2text() Einen HTTP-Query-Text in Klartext wandeln.
randomize()
recode()
reverse()
sortString()
text2query() Einen Klartext in einen HTTP-Query-Text wandeln.
text2utf8()
text2xml() Einen Klartext in einem XML/HTML/QUERY-Text wandeln.
translate()
trim() Leer- und Kontrollzeichen aus einer Zeichenkette entfernen.
upper() Alle Kleinbuchstaben in Großbuchstaben wandeln.
utf82text()
xml2text()