FiveTech Support Forums

 HB_Uncompress() : Uncompresses a compressed character string (ZIP).
Syntax  
HB_Uncompress( <nBytes>, <cCompressed> ) --> cUncompressed

or

HB_Uncompress( <nBytes>     , ;
               <cCompressed>, ;
               <nComprLen>  , ;
              @<cString>      ) --> nError
Arguments   

<nBytes>
This numeric value indicates the number of bytes the uncompressed string is going to have.

<cCompressed>
This is a character string holding the copressed data. It is obtained from function HB_Compress().

<nComprLen>
This numeric value indicates the number of bytes of the input string to uncompress. Use the expression Len(<cCompressed>) to uncompress the entire input string.

@<cString>
This is a pre-allocated character string. It must be passed by reference and receives the uncompressed data.

Return value
The function returns either the uncompressed character string, or a numeric error code indicating success of the uncompression operation. See the description below.

Description     
hb_uncompress() is the reverse function of HB_Compress() and uncompressed character string holding ZIP compressed data. It is implemented in two "flavours" allowing for simple and advanced uncompression of data.

The easiest way of uncompressing a character string is by passing the number of bytes for the result string and the ZIP compressed string to hb_uncompress(). In this case, the function returns the uncompressed data as a character string.

Alternatively, the number od bytes to use from <cCompressed> can be specified as <nComprLen>. This requires <cString> be passed by reference as fourth parameter, since the function returns a numeric error code in this case. The value zero indicates a successful operation. Values other than zero can be passed to HB_CompressErrorDesc() to obtain a descriptive error message.

HB_Uncompress() : Descomprime un cadena de caracteres comprimida (ZIP).

Sintaxis 
HB_Uncompress( <nBytes>, <cCompressed> ) --> cDescomprimida

ó

HB_Uncompress( <nBytes>     , ;
               <cCompressed>, ;
               <nComprLen>  , ;
              @<cString>      ) --> nError
Argumentos   

<nBytes>
Este valor numerico indica el número de bytes que la cadena descomprimida va a tener.

<cCompressed>
Esta es una cadena de caracteres que contiene los datos comprimidos. Obtenida con la función HB_Compress().

<nComprLen>
Este valor numerico indica el número de bytes de la cadena de entrada a descomprimir. Use la expresión LEN(<cCompressed>) para descomprimir toda la cadena de entrada.

@<cString>
Esta es una cadena de caracteres pre-allocated. Debe ser pasada por referencia y recibe los datos descomprimidos.

Valor devuelto
La función devuelve la cadena de caracteres descomprimidos o un código de error numerico indicando el resultado de la operación de descompreción. Vea la siguiente descripción.

Descripción
hb_uncompress() is la función inversa de la función HB_Compress() y la cadena de caracteres descomprimida contenida en los datos ZIP comprimidos. Esta implementada en dos "sabores", para sencilla y avanzada descompresión de datos.

La forma más fácil de descomprimir una dacena de caracteres es pasando el numero de bytes para la cadena resultante y la cadena ZIP comprimida a la función HB_Uncompress(). EN este caso la función devuelve los datos descomprimidos como una cadena de caracteres.

Alternativamente, el numero de bytes a usar de <cCompressed> puede ser especificado como <nComprLen>. Esto requiere que <cString>  sea pasado por referencia como cuarto parametro, en este caso, la función devuelve un código de error numerico. El valor cero indica una operación exitosa. Los valores diferentes de cero pueden ser pasados a la función HB_CompressErrorDesc() para obtener una descripción detallada del error.