USE CHARACTER SET
USE CHARACTER SET ( mapa {; mapaEntradaSaida} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| mapa | Text, * | → | Nome do conjunto de caracteres a ser usado (modo Unicode), ou nome do Documento do mapa ASCII a ser usado (ASCII mode) ou * para reiniciar para o conjunto de caracteres/mapa ASCII padrão |
| mapaEntradaSaida | Integer | → | 0 = Mapa de saída 1 = Mapa de entrada, se omitido, mapa de saída |
Descrição
USE CHARACTER SET modifica o conjunto de caracteres usado por 4D durante a transferência de dados entre o banco de dados e um documento ou uma porta serial para o processo atual. As operações de transferência incluem a importação e exportação de texto (ASCII), DIF, e os arquivos SYLK. Um mapa de caracteres também funciona com os dados enviados pelos comandos SEND PACKET, RECEIVE PACKET (para pacotes de tipo texto), e RECEIVE BUFFER. Não tem efeito em transferências de dados realizadas com SEND RECORD, SEND VARIABLE, RECEIVE RECORD, SEND PACKET, RECEIVE PACKET (para pacotes tipo BLOB) e RECEIVE VARIABLE.
O parâmetro mapa deve corresponder ao nome do conjunto de caracteres "IANA" a ser utilizado, ou a um dos seus apelidos. Por exemplo, os nomes "iso-8859-1" ou "UTF-8" são nomes válidos, bem como os apelidos "latin1" ou "L1". Para mais informações sobre esses nomes, consulte o seguinte endereço:
http://www.iana.org/assignments/character-sets. Também se apresentam exemplos de nomes IANA na descrição do comando CONVERT FROM TEXT.
Se mapaEntradaSaida for 0, o mapa é definido para a exportação. Se mapaEntradaSaida for 1, o mapa é definido para a importação. Se você não passar o parâmetro mapaEntradaSaida, o mapa de exportação é usado por padrão.
Quando o parâmetro * é passado, o conjunto de caracteres padrão é restaurado (mapa de importação ou exportação dependendo do valor de mapaEntradaSaida).
Em 4D v11, o conjunto de caracteres por padrão é UTF-8.
Exemplo
O exemplo a seguir (modo Unicode) usa o caracteres UTF-16 para exportar um texto, então o conjunto de caracteres padrão é restaurado:
USE CHARACTER SET("UTF-16LE";0) // Use o conjunto de caracteres UTF-16 "Little Endian"
EXPORT TEXT([MiTabla];"MiTexto") // Exportar dados através do mapa
USE CHARACTER SET(*;0) // Restaure o conjunto de caracteres padrão
Variáveis e conjuntos do sistema
A variável de sistema OK é definida como 1 se o mapa é carregado corretamente. Caso contrário, é definido como 0.
Ver também
EXPORT DIF
EXPORT SYLK
EXPORT TEXT
IMPORT DIF
IMPORT SYLK
IMPORT TEXT
RECEIVE BUFFER
RECEIVE PACKET
SEND PACKET
Propriedades
| Número do comando | 205 |
| Thread-seguro | ✓ |
| Modificar variáveis | OK |