versión 11 (Modificado)
USE CHARACTER SET (mapa | *{; mapaImpExp})
Parámetro | Tipo | Descripción | |
mapa | * | Alfa | * | 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 | Numérico | 0 = Mapa de exportación | |
1 = Mapa de importación | |||
Si se omite, mapa de exportación |
Descripción
USE CHARACTER SET puede utilizarse para modificar el conjunto de caracteres utilizado por 4D durante la transferencia de datos entre la base y un documento o puerto serial. Las operaciones de transferencia incluyen la importación y exportación de texto (ASCII), DIF, y archivos SYLK. Un mapa ASCII trabaja sobre datos transferidos con 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 y RECEIVE PACKET (para paquetes tipo BLOB) y RECEIVE VARIABLE.
El comando USE CHARACTER SET se utiliza de forma diferente si la base está operando en modo Unicode o en modo compatibilidad ASCII. Carga en memoria o un conjunto de caracteres o un mapa ASCII.
Nota: Para mayor información sobre estos modos, por favor consulte la sección Acerca de Unicode.
Modo unicode
En modo Unicode, 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.
Modo compatibilidad ASCII
En este modo, el comando carga en memoria y utiliza el documento del mapa ASCII (pasado en map) guardado previamente. El mapa ASCII debe haber sido creado de antemano utilizando una versión anterior de 4D. Si pasa una cadena vacía en map, USE CHARACTER SET muestra una ventana de apertura de archivos de manera que el usuario pueda especificar un documento de mapa ASCII existente.
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 modo Unicode en 4D v11, el conjunto de caracteres por defecto es UTF-8.
En modo compatibilidad, el Mac ASCII se restablece.
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
Ver también
EXPORT DIF, EXPORT SYLK, EXPORT TEXT, IMPORT DIF, IMPORT SYLK, IMPORT TEXT, Mac to Win, RECEIVE BUFFER, RECEIVE PACKET, SEND PACKET, Win to Mac.
Variables y conjuntos sistema
La variable sistema OK toma el valor 1 si el mapa se carga correctamente, de lo contrario toma el valor 0.