Lê de um arquivo binário um valor do tipo int, short ou char, dependendo do tamanho especificado em bytes. A leitura é feita a partir da posição atual do ponteiro do arquivo.
Lê de um arquivo CSV uma string da posição atual até o separador (ou até o fim da linha de texto) e converte a string lida para um valor do tipo int, short ou char, dependendo do tamanho especificado em bytes.
int FileReadInteger(
|
Parâmetros
file_handle
[in] Descritor de arquivo retornado pelo FileOpen().
size=INT_VALUE
[in] Número de bytes (até 4 inclusive), que devem ser lidos. As constantes correspondentes são fornecidos: CHAR_VALUE = 1, SHORT_VALUE = 2 e INT_VALUE = 4, então a função pode ler todo o valor do tipo char, short ou int.
Valor do Retorno
Um valor do tipo int. O resultado desta função deve ser explicitamente convertido para um tipo de destino, ou seja, para o tipo de dados que você precisa ler. Uma vez que um valor do tipo int é retornado, ele pode ser facilmente convertido para qualquer valor inteiro. O ponteiro do arquivo é deslocado pelo número de bytes lidos.
Equivalente à chamada da função FileRead com um parâmetro do tipo char, short ou int. Para ler dados do tipo uint de forma garantida, recomenda-se usar FileRead com o parâmetro correspondente.
char char_value;
|
Observação
Para obter informações sobre o erro, chame a função GetLastError().
Quando ler menos do que 4 bytes, o resultado recebido é sempre positivo. Se um ou dois bytes são lidos, o sinal do número pode ser determinado por colagem explícita do tipo char (1 byte) ou short (2 bytes). Recebendo o sinal para um número de três bytes não é simples, uma vez que não há nenhuma correspondente tipo subjacente.
Exemplo (o arquivo obtido após a execução do exemplo pela função FileWriteInteger é usado aqui)
//+------------------------------------------------------------------+
|
Também Veja
IntegerToString, StringToInteger, Tipos inteiros, FileWriteInteger