BLOB to text

4D v16.3

BLOB

BLOB to text


BLOB to text ( BLOB ; formatoTexto {; offset {; longitudTexto}} ) -> Resultado

Parámetro	Tipo	Descripción
BLOB	BLOB	BLOB del cual obtener el texto
formatoTexto	Entero largo	Formato y conjunto de caracteres de texto
offset	Variable	Offset en el BLOB (expresado en bytes)
		Nuevo offset después de la lectura
longitudTexto	Entero largo	Número de caracteres a leer
Resultado	Texto	Valor del texto

Descripción

El comando BLOB to text devuelve un valor de tipo Texto leído del BLOB blob.

El parámetro formatoTexto fija el formato interno y el conjunto de caracteres del valor de tipo Texto a leer. En las bases de datos creadas a partir de la versión 11, 4D utiliza por defecto el conjunto de caracteres Unicode (UTF8) para la gestión de textos. Por compatibilidad, este comando permite "forzar" la utilización del conjunto de caracteres Mac Roman (conjunto de caracteres utilizado en las versiones anteriores de 4D). La elección del conjunto de caracteres se efectúa vía el parámetro formatoTexto. Para hacer eso, pase una de las siguientes constantes (del tema BLOB) en el parámetro formatoTexto:

Constante	Tipo	Valor
Mac C string	Entero largo	0
Mac Pascal string	Entero largo	1
Mac text with length	Entero largo	2
Mac text without length	Entero largo	3
UTF8 C string	Entero largo	4
UTF8 text with length	Entero largo	5
UTF8 text without length	Entero largo	6

Notas:

Las constantes "UTF8" sólo pueden ser utilizadas cuando la aplicación se ejecuta en modo Unicode.
La constante Mac Text with length no puede trabajar con textos de más de 32 KB.
Si quiere trabajar con conjuntos de caracteres diferentes de UTF8, utilice el comando Convert to text.

Para mayor información sobre estas constantes y los formatos que representan, consulte la descripción del comando TEXT TO BLOB.

Atención: el número de caracteres a leer se determina por el parámetro formatoTexto, EXCEPTO para el formato Text without length y UTF8 Text without length, para el cual usted DEBE especificar el número de caracteres a leer en el parámetro longitudTexto. Para los otros formatos, longitudTexto se ignora y usted puede omitirlo.

Si especifica la variable del parámetro opcional offset, el valor del texto se lee en el offset (a partir de cero) del BLOB. Si no especifica la variable del parámetro opcional offset, se leen los primeros bytes del BLOB de acuerdo al valor pasado en textFormato. Note que debe pasar la variable del parámetro offset cuando esté leyendo texto sin longitud.

Nota: debe pasar un valor de offset entre 0 (cero) y el tamaño del BLOB menos el tamaño del texto a leer. Si no lo hace, el resultado de la función es impredecible.

Después de la ejecución del comando, la variable se incrementa en el número de bytes leídos. Por lo tanto, puede reutilizar la misma variable con otro comando de lectura de BLOBs para leer otro valor.

Ver también

BLOB to integer
BLOB to longint
BLOB to real
Convert to text
INTEGER TO BLOB
LONGINT TO BLOB
REAL TO BLOB
TEXT TO BLOB