El
Grabar se utiliza para (modificarmanipular, guardar, ...) los valores de un registro. Este registro puede ser un registro que se encuentra en unaarchivo de datos, una consulta o una vista.. La variable asociada a la variable
Grabar se estructurará como un registro de la base de datos.
Ejemplos de uso: Esto le permite almacenar en diferentes variables el contenido de varios registros para compararlos o para comparar algunos artículos..
Versiones 23 y posteriores
Nueva funcionalidad versión 23
CustomerRec is Record of CUSTOMER
HReadFirst(CUSTOMER, CUSTNUM)
IF NOT HOut() THEN
CustomerRec = CUSTOMER
// Display the last and first names of the customer
Info(CustomerRec.LASTNAME, CustomerRec.FIRSTNAME)
END
CustomerRec is Record of CUSTOMER
CustomerRec.LastName = "MOORE"
CustomerRec.FirstName = "Paul"
CustomerRec.City = "PARIS"
// Assigns the content of the CustomerRec variable in the buffer of CUSTOMER file
CUSTOMER = CustomerRec
HAdd(CUSTOMER)
// You have the ability to do: HAdd(CUSTOMER, CustomerRec)
Observaciones
Declaración de una variable de registro
La siguiente sintaxis se utiliza para declarar un
Grabar fluctuante:
<Variable Name> is Record [of <Name of Analysis File>]
- Si se especifica <Nombre del archivo de análisis>, el registro se asocia con una descripción de uno de los archivos de datos encontrados en el análisis.. En este caso, usted tiene la capacidad de manipular los diferentes elementos de registro.
- Si no se especifica <Nombre del archivo de análisis>, la estructura del registro se construirá dinámicamente de acuerdo con el búfer del archivo que se le ha asignado..
Acceso a los artículos
Para acceder a los elementos de una
Grabar utilice la siguiente sintaxis:
- Para asignar un elemento de la variable:
<Variable Name>.<Item Name> = <Value to Assign>
- Para recuperar el valor de los elementos:
<Value> = <Variable Name>.<Item Name>
Nota: Cuando se utiliza un
récord asociada a una archivo de datos de las variables del análisis, el editor de código propone automáticamente los diferentes ítems de registro:
Lectura y asignación de una variable de registro
A
Grabar puede ser leída o asignada. La sintaxis es la siguiente:
- Para almacenar el búfer de a archivo de datos en un Grabar fluctuante:
<Name of Record Variable> = <Name of Data File>
- Para asignar la memoria intermedia de a archivo de datos desde un Grabar fluctuante:
<Name of Data File> = <Name of Record Variable>
Casos especiales
- HRetrieveRecord usado en un Grabar devuelve una cadena de caracteres que contiene el valor de cada elemento separado por un carácter TAB.
- No se produce ningún error de compilación si un Grabar con el tipo en a archivo de datos se asigna con el buffer de otro fichero. Se realiza una copia homónima de los búferes: sólo se asignarán los elementos con el mismo nombre de cada búfer. Los demás elementos no se asignarán.
- Sólo la serialización JSON está disponible para este tipo de variable (Serialize). No es posible la deserialización.
Funciones que manipular el tipo de registro
Las siguientes funciones utilizan el
Grabar escribir a máquina:
| |
Versiones 09 y posterioresHAdd Nueva funcionalidad versión 09HAdd HAdd | Agrega: - el registro encontrado en la memoria en la (consulta archivo de datos o vista).
- el registro encontrado en una variable Registro en archivo de datos (consulta o vista).
|
| HCopyRecord | Copies: - the content of current record (loaded in memory) into the current record of a data file.
- the content of Record variable into the current record of a data file.
|
| HExtractMemo | Extracts the content of a binary memo item from a HFSQL file, a query or a HFSQL view into a physical file (on disk). |
| HInfoMemo | Retorna las características de notas binarias y de texto. |
| HLinkMemo | Le permite asociar un archivo con un elemento memo binario o cancelar el enlace existente entre un archivo y un elemento binario. |
| HListItem | Returns the list of items:- found in a data file ( a query or a view) known to the HFSQL engine. The data files defined by HDeclare, HDeclareExternal and HDescribeFile are taken into account.
- found in a Record variable.
|
Versiones 09 y posterioresHReset Nueva funcionalidad versión 09HReset HReset | %00000021% %00000021%:
Inicializa. - una o todas las variables de las posiciones de fichero con sus valores por defecto.
|
| HRetrieveRecord | %00000017% %00000017% |
señalar: Para reiniciar el contenido de un archivo
Grabar tiene la posibilidad de usar
VariableReset.
Propiedades específicas de la descripción de las variables de registro
Se pueden utilizar las siguientes propiedades para averiguar las características de un
Grabar variable:
| | |
| Nombre de la propiedad | Tipo utilizado | Efecto |
|---|
| Contenido | Cadena de caracteres | Contenido del registro actual (idéntico al resultado devuelto por HRetrieveRecord). Esta propiedad está disponible en sólo lectura. |
| AssociatedFile | Cadena de caracteres | Nombre del archivo HFSQL en el que se basa la variable. Esta propiedad está disponible en sólo lectura. |
Nota: Estas propiedades se pueden utilizar con una de las siguientes sintaxis:
- <Nombre de la variable>...<Nombre de la propiedad>
- <Nombre de la variable>.<Nombre de la propiedad>>Nombre de la variable