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.