4D Doc Center : IT

4D Internet Commands v14

IT_Encode


IT_Encode ( nomeArquivo ; nomArquiCod ; modoCod ) -> Resultado

Parâmetro	Tipo	Descrição
nomeArquivo	Texto	Via de acesso local a um arquivo
nomArquiCod	Texto	Via de acesso local a um arquivo codificado
		Via de acesso local a um arquivo codificado resultante
modoCod	Inteiro	1 = BinHex 2 = Base64 (Data fork only) 3 = AppleSingle 4 = AppleDouble 5 = AppleSingle E Base64 6 = AppleDouble E Base64 7 = UUEncode 8 = MacBinary
Resultado	Inteiro	Código de erro

Descrição

O comando IT_Encode codifica um arquivo utilizando o modoCod especificado. O arquivo especificado não será modificado e é criada uma cópia codificada. O nome do arquivo codificado criado será o nome do arquivo original mais um sufixo para especificar o método de codificação. Para a codificação BinHex, será adicionado o sufixo ".hqx". Para a codificação Base64, será adicionado o sufixo ".b64". Para a codificação AppleSingle, será adicionado o sufixo ".as".

nomeArquivo contém a via de acesso completa do arquivo a codificar. Se passar uma cadeia vazia neste parâmetro, aparece uma caixa de diálogo para selecionar um arquivo.

nomArquiCod pode conter:

A via de acesso completa da cópia codificada do arquivo, o que permite definir o nome e a localização.
A via completa de acesso da pasta que vai receber o arquivo codificado (sem especificar o nome do arquivo); o nome do arquivo será o nome do arquivo original com um sufixo para especificar o método de codificação.
Uma cadeia vazia (neste caso, o comando IT_Encode) atribui um nome para o documento, que se localiza na mesma pasta que o arquivo especificado no primeiro parâmetro. Se especificado ou não, a via completa do documento codificado será devolvida neste parâmetro. Devido a possibilidade de possíveis conflitos de nomes no diretório especificado, se recomenda ter como base o valor resultante do parâmetro.

modoCod define o método de codificação a aplicar ao arquivo. O valor por padrão é 1 para a codificação BinHex. Outros métodos são os seguintes:

Código	Método
1	BinHex
2	Base64 (Data fork unicamente)
3	AppleSingle
4	AppleDouble
5	AppleSingle e Base64
6	AppleDouble e Base64
7	UUEncode
8	MacBinary

Para a codificação utilizando AppleDouble (modos de codificação 4 e 6), são criados dois arquivos chamados "%nomeArquivo" e "nomeArquivo".