Fblockread PT

From SA-MP Wiki

Jump to: navigation, search

fblockread

Image:Farm-Fresh text lowercase.png Nota: O nome desta função começa com uma letra minúscula.


Descrição:

Esta função permite ler dados de um arquivo, sem codificação e terminadores de linha.


Parâmetros:
(File:handle, buffer[], size = sizeof buffer)
handleIdentificador do arquivo, retornado pela função fopen.
bufferA array para salvar os dados.
size = sizeof bufferO número de células que vai ser lido.


Valores de retorno:

O número de células que foram lidas. Zero, se o chegar ao final do arquivo.


Image:32px-Circle-style-warning.png

Aviso

Usando um identificador inválido irá crashar seu servidor! Obtenha um identificador válido usando fopen ou ftemp.


Exemplo de uso:

// Define "some_enum"
enum _:some_enum
{
    	some_data1,
	some_data2[20],
	Float:some_data3
}
 
// Declara a array "some_data"
new some_data[some_enum];
 
// ...
 
// Abre o arquivo "file.bin" no modo de leitura
new File:handle = fopen("file.bin", io_write)
 
	// Declara a variável "file_len"
	file_len;
 
// Verifica se o arquivo foi aberto
if(handle)
{
	// O arquivo foi aberto
 
	// Pega o tamanho do arquivo
	file_len = flength(handle);
 
	// Verifica se o arquivo é do mesmo tamanho que array
	if(file_len == (some_enum*4))
	{
		// É do mesmo tamanho
 
		// Lê o arquivo e armazena os dados na array "some_data"
		fblockread(handle, some_data);
	}
	else
	{
		// O tamanho é diferente
		print("\"file.bin\" não é compatível com esta array.");
	}
 
	// Fecha o arquivo
	fclose(handle);
}
else
{
	// Falha ao abrir
	print("Falha ao tentar abrir o arquivo \"file.bin\".");
}


  • fopen: Abre um arquivo.
  • ftemp: Cria um arquivo temporário.
  • fwrite: Escreve em um arquivo aberto.
  • fputchar: Coloca um caractere dentro do arquivo.
  • fgetchar: Pega um caractere de dentro do arquivo.
  • fblockread: Lê blocos de dados de dentro de um arquivo.
  • fseek: Pula para uma determinada posição no arquivo.
  • flength: Pega o tamanho de um arquivo.
  • fexist: Verifica se um arquivo existe.
  • fmatch: Verifica se os padrões com um nome de arquivo correspondem.
Personal tools
Navigation
Toolbox