Fread PT

From SA-MP Wiki

Jump to: navigation, search

fread

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


Descrição:

Lê uma única linha de um arquivo.


Parâmetros:
(File:handle, string[], size = sizeof string, bool: pack = false)
handleO identificador do arquivo aberto (retornado pela função fopen).
stringA array para armazenar a linha lida, passada por referência.
sizeO número de bytes que vai ler.
packA array vai ser compactada? true ou false.


Valores de retorno:

O tamanho do texto que lido.


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:

// Abre o arquivo "file.txt" em modo de leitura
new File:handle = fopen("file.txt", io_read),
 
    // Declara a array "buf"
    buf[128];
 
// Verifica se o arquivo foi aberto
if(handle)
{
    // O arquivo foi aberto
 
    // Lê todo o arquivo e imprime no console
    while(fread(handle, buf)) print(buf);
 
    // Fecha o arquivo
    fclose(handle);
}
else
{
    // Falha ao abrir o arquivo
    print("O arquivo \"file.txt\" não existe ou não pode ser aberto.");
}
// Abre o arquivo "file.txt" em modo de leitura e escrita
new File:handle = fopen("file.txt"),
 
    // Declara a array "buf"
    buf[128];
 
// Verifica se o arquivo foi aberto
if(handle)
{
    // O arquivo foi aberto
 
    // Lê todo o arquivo e imprime no console
    while(fread(handle, buf)) print(buf);
 
    // Seta o ponteiro do arquivo para o primeiro byte
    fseek(handle, _, seek_begin);
 
    // Escreve "Hello World!" no arquivo
    fwrite(handle, "Hello World!");
 
    // Fecha o arquivo
    fclose(handle);
}
else
{
    // Falha ao abrir o arquivo
    print("O arquivo \"file.txt\" não existe ou não pode ser aberto.");
}

Funções Relacionadas

As seguintes funções podem ser úteis, pois estão de alguma forma, relacionadas a esta função.


  • fopen: Abre um arquivo.
  • ftemp: Cria um arquivo temporário.
  • fwrite: Escreve em um arquivo aberto.
  • fread: Lê um arquivo.
  • 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