Fwrite PT

From SA-MP Wiki

Jump to: navigation, search

fwrite

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


Descrição:

Escreve em um arquivo.


Parâmetros:
(File:handle, string[])
handleO identificador do arquivo aberto (retornado pela função fopen).
stringO texto que vai ser escrito.


Valores de retorno:

O tamanho do texto escrito no 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.


Image:32px-Ambox_warning_orange.png

Nota

Esta função escreve no arquivo em UTF-8, o que não pode suportar alguns símbolos de algumas linguagens.


Exemplo de uso:

// Abre o arquivo 'file.txt' em modo de escrita
new File:handle = fopen("file.txt", io_write);
 
// Verifica se o arquivo foi aberto
if(handle)
{
    // O arquivo foi aberto
 
    // Escreve "Hello World!" no arquivo
    fwrite(handle, "Hello World!");
 
    // fecha o arquivo
    fclose(handle);
}
else
{
    // Falha ao tentar abrir o arquivo
    print("Falha ao tentar abrir o arquivo \"file.txt\".");
}
// Abre o arquivo 'file.txt' no 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 um ponteiro no 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.");
}
// Abre o arquivo 'file.txt' no modo append
new File:handle = fopen("file.txt", io_append);
 
// Verifica se o arquivo foi aberto
if(handle)
{
    // O arquivo foi aberto
 
    // Escreve "Hello World!\r\n" no final do arquivo
    fwrite(handle, "Hello World!\r\n");
 
    // Fecha o arquivo
    fclose(handle);
}
else
{
    // Erro ao abrir o arquivo
    print("Falha ao tentar abrir o arquivo \"file.txt\".");
}

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.
  • 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