4D v13.4
USE CHARACTER SET
USE CHARACTER SET
| USE CHARACTER SET ( mapa {; mapaEntradaSaida} ) | ||||||||
| Parâmetro | Tipo | Descrição | ||||||
| mapa | cadeia, Operador |
|
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 | Inteiro longo |
|
0 = Mapa de saída 1 = Mapa de entrada, se omitido, mapa de saída | |||||
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 ASCII também trabalha sobre dados transferidos com SEND PACKET, RECEIVE PACKET (para pacotes tipo texto) e RECEIVE BUFFER. Não tem nenhum efeito sobre as transferências de dados feitas com SEND RECORD, SEND VARIABLE, RECEIVE RECORD, SEND PACKET e RECEIVE PACKET (para pacotes tipo BLOB) e RECEIVE VARIABLE.
O comando USE CHARACTER SET é usado de forma diferente de acordo se o banco está operando em modo Unicode ou em modo de compatibilidade ASCII. Ele carrega na memória ou um conjunto de caracteres ou um mapa ASCII.
Nota: Para mais informações sobre esses modos, consulte a seção de Códigos ASCII.
Modo unicode
No modo Unicode, 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.
Modo compatibilidade ASCII
Neste modo, o comando carrega na memória e usa o documento de mapa ASCII (aprovada no mapa), que foi salvo anteriormente. O mapa ASCII deve ter sido criado com antecedência, usando uma versão anterior de 4D. Se você der uma cadeia vazia para o mapa, USE CHARACTER SET exibe uma janela de abertura de arquivos de modo que o usuário possa especificar um documento de mapa ASCII existente.
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).
No modo Unicode em 4D v11, o conjunto de caracteres por padrão é UTF-8.
No modo de compatibilidade, o padrão Mac ASCII é restaurado.
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ãoA variável de sistema OK é definida como 1 se o mapa é carregado corretamente. Caso contrário, é definido como 0.
Produto: 4D
Tema: Comunicações
Número
205
Modificado: 4D v11 SQL
EXPORT DIF
EXPORT SYLK
EXPORT TEXT
IMPORT DIF
IMPORT SYLK
IMPORT TEXT
Mac to Win
RECEIVE BUFFER
RECEIVE PACKET
SEND PACKET
Win to Mac
