BufferToHexa (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / String functions

Creating an identifier

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

BufferToHexa (Function)

In french: BufferVersHexa

Converts a buffer into a displayable hexadecimal string (e.g. "4A 5B 00").

This function is mainly used to check the content of a buffer byte by byte.

Note: To convert a hexadecimal string into a buffer, use the HexaToBuffer function..

Example

// Clic du bouton
s is Buffer = fChargeTexte(SAI_NomFichier)
SAI_Dump = BufferToHexa(s)

s is string Unicode = "abdcefghijkl"
Trace(BufferToHexa(s))
// affiche :
// 61 00 62 00 64 00 63 00 65 00 66 00 67 00 68 
// 69 00 6A 00 6B 00 6C 00

s is string Unicode = "Plétopabo"

// Affiche 50 00 6C 00 E9 00 74 00 6F 00 70 00 61 00 62 00<\r><\n>6F 00
Trace(BufferToHexa(s, 1)) 
// Affiche 0050 006C 00E9 0074 006F 0070 0061 0062<\r><\n>006F
Trace(BufferToHexa(s, 2)) 
// Affiche 5000 6C00 E900 7400 6F00 7000 6100 6200<\r><\n>6F00
Trace(BufferToHexa(s, 2, BigEndian))  
// Affiche 006C0050 007400E9 0070006F 00620061<\r><\n>6F 00
Trace(BufferToHexa(s, 4)) 
// Affiche 50006C00 E9007400 6F007000 61006200<\r><\n>6F 00
Trace(BufferToHexa(s, 4, BigEndian))

Syntax

<Result> = BufferToHexa(<Buffer to convert> [, <Nb bytes per word> [, <Nb bytes per line>]])

<Result>: Character string

Character string in hexadecimal format.

<Buffer to convert>: Buffer

Buffer to use. This parameter can also correspond to an ANSI or Unicode string.

<Nb bytes per word>: Integer or Integer constant

Number of bytes per word. This parameter can correspond to:
1 (default): values are grouped by byte.
2: values are grouped in 2-byte words.
4: values are grouped by double word of 4 bytes.
the constant NoGrouping: no grouping will be performed. All hexadecimal codes will have no spaces. Example: 61002345A1.

<Nb bytes per line>: Integer or Integer constant

Number of bytes before moving to the next line.
After each <Nb bytes per line> a Carriage Return (CR) is added to the result string.
If <Nb bytes per line> is less than <Nb bytes per word>, the Carriage Return (CR) will be added every <Nb bytes per word>.
If this parameter corresponds to the NoLine constant, all bytes will be positioned on the same line.
By default:
this number is equal to 16.
the grouping is performed using the Little-Endian method (the least significant byte is stored first, like in x86).
if <Nb bytes per word> is set to NoGrouping, then <Nb bytes per line> will correspond to the NoLine constant by default.
To group values in Big-Endian format:
use the BigEndian constant.
add the BigEndian constant to the value of <Nb bytes per line>.
Note: the constant SansLigne can be combined with the constant BigEndian.

Remarks

Creating an identifier

The NoGrouping and NoLine constants are used to simplify the creation of an identifier from a buffer.

Business / UI classification: Neutral code

Component: wd300std.dll