INTEGER TO BLOB

4D - Documentation   Français   English   German   Español   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente

versión 6.0


INTEGER TO BLOB (entero; BLOB; byteOrden{; offset | *})

ParámetroTipoDescripción
enteroNuméricoValor entero a escribir en el BLOB
BLOBBLOBBLOB a recibir el valor entero
byteOrdenNumérico0  Orden de bytes en modo nativo
1  Orden de los bytes Macintosh
2  Orden de los bytes PC
offset | *Variable | *Offset expresado en bytes en el BLOB
o * para añadir el valor
Nuevo offset después de la escritura si se omite *

Descripción

El comando INTEGER TO BLOB escribe el valor entero (2 bytes) entero en el BLOB blob.

El parámetro byteOrden fija el orden de los bytes ("byte ordering) del valor entero a escribir (2 bytes). Usted pasa uno de las siguientes constantes predefinidas suministradas 4D:

ConstanteTipoValor
Native byte orderingEntero largo0
Macintosh byte orderingEntero largo1
PC byte orderingEntero largo2

Nota sobre la independencia de plataforma: si usted intercambia BLOBs entre las plataformas Macintosh y PC, es su decisión administrar los temas de byte swapping cuando utilice este comando.

Si especifica el parámetro opcional *, el valor entero de 2 bytes se añade al BLOB y el tamaño del BLOB se extiende en consecuencia. Utilizando el parámetro opcional *, puede almacenar secuencialmente todos los valores de tipo Entero, Entero largo, Real o Texto (ver otros comandos de BLOB) en un BLOB, siempre y cuando tenga memoria disponible.

Si no especifica el parámetro opcional * o la variable del parámetro offset, el valor entero de 2 bytes se almacena al comienzo del BLOB, sobreescribiendo su contenido anterior; el tamaño del BLOB se ajusta en consecuencia.

Si pasa la variable del parámetro offset, el valor entero de 2 bytes se escribe a partir del offset (comenzando desde cero) del BLOB. Sin importar donde escriba el valor entero de 2 bytes, el tamaño del BLOB aumenta de acuerdo a la ubicación pasada (hasta en 2 bytes, si es necesario). Los bytes recientemente definidos, diferentes a los que está escribiendo, se inicializan en cero.

Después de llamar el comando, se devuelve la variable del parámetro offset, incrementada en el número de bytes que se han escrito. Por lo tanto, usted puede reutilizar esa misma variable con otro comando de escritura de BLOB para escribir otro valor.

Ejemplos

1. Después de la ejecución de este código:

   INTEGER TO BLOB (0x0206;vxBlob;Native byte ordering)

El tamaño de vxBlob es 2 bytes

En Macintosh vxBLOB{0} = $02 y vxBLOB{1} = $06

En PC vxBLOB{0} = $06 y vxBLOB{1} = $02

2. Después de la ejecución de este código:

   INTEGER TO BLOB (0x0206;vxBlob;Macintosh byte ordering)

El tamaño de vxBlob es 2 bytes

En todas las plataformas vxBLOB{0} = $02 and vxBLOB{1} = $06

3. Después de la ejecución de este código:

   INTEGER TO BLOB (0x0206;vxBlob;PC byte ordering)

El tamaño de vxBlob is 2 bytes

En todas las plataformas vxBLOB{0} = $06 and vxBLOB{1} = $02

4. Después de la ejecución de este código:

   SET BLOB SIZE (vxBlob;100)
   INTEGER TO BLOB (0x0206;vxBlob;PC byte ordering;*)

El tamaño de vxBlob es 102 bytes

En todas las plataformas vxBLOB{100} = $06 and vxBLOB{101} = $02

Los otros bytes del BLOB no cambian

5. Después de la ejecución de este código:

   SET BLOB SIZE (vxBlob;100)
   vlOffset:=50
   INTEGER TO BLOB (518;vxBlob;Macintosh byte ordering;vlOffset)

El tamaño de vxBlob es 100 bytes

En todas las plataformas vxBLOB{50} = $02 and vxBLOB{51} = $06

Los otros bytes del BLOB no cambian

La variable vlOffset se ha incrementado en 2 (y ahora es igual a 52)

Ver también

BLOB to integer, BLOB to longint, BLOB to real, BLOB to text, LONGINT TO BLOB, REAL TO BLOB, TEXT TO BLOB.


4D - Documentation   Français   English   German   Español   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente