Partilhar via


Fwrite

Grava dados em um fluxo.

size_t fwrite(
   const void *buffer,
   size_t size,
   size_t count,
   FILE *stream 
);

Parâmetros

  • buffer
    Ponteiro para os dados a serem gravados.

  • size
    Tamanho em bytes do item.

  • count
    Número máximo de itens a serem gravados.

  • stream
    Ponteiro para FILE estrutura.

Valor de retorno

fwriteRetorna o número de full itens realmente escritas, que pode ser menor do que count se ocorrer um erro.Além disso, se ocorrer um erro, o indicador de posição do arquivo não pode ser determinado.Se qualquer um dos stream ou buffer é um ponteiro null, a função chama o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, essa função define errno para EINVAL e retorna 0.

Comentários

O fwrite função grava até count itens, de size comprimento cada, de buffer na saída de stream*.* O ponteiro de arquivo associado stream (se houver) é incrementado pelo número de bytes gravados.Se stream é aberto no modo de texto, cada retorno de carro é substituído por um retorno de carro – o par de avanço de linha.A substituição não tem efeito sobre o valor de retorno.

Esta função bloqueia o segmento de chamada e, portanto, é thread-safe.Para obter uma versão não-bloqueio, consulte _fwrite_nolock.

Requisitos

Função

Cabeçalho necessário

fwrite

<stdio.h>

Para obter informações adicionais de compatibilidade, consulte compatibilidade na introdução.

Exemplo

Consulte o exemplo para fread.

Equivalência do .NET Framework

System::IO::FileStream::Write

Consulte também

Referência

Fluxo de i/O

fRead

Write