versión 6.0
INTEGER TO BLOB (entero; BLOB; byteOrden{; offset | *})
Parámetro | Tipo | Descripción | |
entero | Numérico | Valor entero a escribir en el BLOB | |
BLOB | BLOB | BLOB a recibir el valor entero | |
byteOrden | Numérico | 0 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:
Constante | Tipo | Valor |
Native byte ordering | Entero largo | 0 |
Macintosh byte ordering | Entero largo | 1 |
PC byte ordering | Entero largo | 2 |
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.