xHarbour Reference Documentation > Function Reference

HB_DeserialNext()

Deserialization the next variable of simple or complex data types.

Syntax

HB_DeserialNext( @<cSerial>, <nBytes> ) --> xValue

Arguments

<cSerialNext>

This parameter must be passed by reference. The first call to HB_DeserialNext() requires the return value of HB_DeserialBegin() while subsequent calls expect @<cSerial> be passed as reference parameter.

<nBytes>

This numeric value specifies the number of bytes to use from <cSerial> for decoding a serialized value. It is the return value of HB_GetLen8().

Return

The function returns the next value from a serialized binary string.

Description

HB_DeserialNext() is a utility function used in xHarbour's serialization system. HB_Serialize() converts any data type to a binary character string that can be transferred between local and remote processes.

Note:  refer to function HB_Deserialize() for more information on deserialization, and read the file source\rtl\hbserial.prg for a usage example of HB_DeserialNext().

Info

See also:	HB_GetLen8(), HB_Deserialize(), HB_DeserialBegin(), HB_Serialize()
Category:	Serialization functions , xHarbour extensions
Source:	rtl\hbserial.prg
LIB:	xhb.lib
DLL:	xhbdll.dll