USE CHARACTER SET
USE CHARACTER SET ( mapa {; mapaImpExp} )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| mapa | Text, * | → | Nombre del conjunto de caracteres a a utilizar (Modo Unicode) o nombre del documento del mapa ASCII a utilizar (Modo ASCII) o * para restaurar el mapa ASCII/conjunto de caracteres por defecto |
| mapaImpExp | Integer | → | 0 = Mapa de exportación 1 = Mapa de importación Si se omite, mapa de exportación |
Descripción
USE CHARACTER SET modifica el conjunto de caracteres utilizado por 4D para todas las operaciones de transferencia de datos entre la base y un documento o puerto serial para el proceso actual. Las operaciones de transferencia incluyen la importación y exportación de texto, DIF y SYLK. Un mapa de caracteres también funciona con los datos enviados por los comandos SEND PACKET, RECEIVE PACKET (para paquetes de tipo texto), y RECEIVE BUFFER. No tiene efecto en transferencias de datos realizadas con SEND RECORD, SEND VARIABLE, RECEIVE RECORD, SEND PACKET, RECEIVE PACKET (para paquetes tipo BLOB) y RECEIVE VARIABLE.
El parámetro mapa debe corresponder al nombre "IANA" del conjunto de caracteres a utilizar, o a uno de sus alias. Por ejemplo, los nombres "iso-8859-1" o "utf-8" son ambos nombres válidos, así como los alias "latin1" u "11". Para mayor información sobre estos nombres, por favor consulte la siguiente dirección: http://www.iana.org/assignments/character-sets. También se presentan ejemplos de nombres IANA en la descripción del comando CONVERT FROM TEXT.
Si mapaImpExp es 0, el mapa está definido para la exportación. Si mapaImpExp es 1, el mapa es para importación. Si no pasa el parámetro mapaImpExp, se utiliza el mapa de exportación por defecto.
Cuando se pasa el parámetro *, el conjunto de caracteres por defecto se restablece (mapa de importación o exportación dependiendo del valor de mapaImpExp.
En 4D, el conjunto de caracteres por defecto es UTF-8.
Ejemplo
El siguiente ejemplo (modo Unicode) utiliza el conjunto de caracteres UTF-16 para exportar un texto, luego restablece el conjunto de caracteres por defecto:
USE CHARACTER SET("UTF-16LE";0) // Utilizar el conjunto de caracteres UTF-16 "Litttle Endian"
EXPORT TEXT([MiTabla];"MiTexto") // Exportar los datos con el mapa
USE CHARACTER SET(*;0) // Restablecer el conjunto de caracteres por defecto
Variables y conjuntos del sistema
La variable sistema OK toma el valor 1 si el mapa se carga correctamente, de lo contrario toma el valor 0.
Ver también
EXPORT DIF
EXPORT SYLK
EXPORT TEXT
IMPORT DIF
IMPORT SYLK
IMPORT TEXT
RECEIVE BUFFER
RECEIVE PACKET
SEND PACKET
Propiedades
| Número de comando | 205 |
| Hilo seguro | ✓ |
| Modifica variables | OK |