Função Write() na Linguagem C

O gerenciamento de arquivos na programação é uma tarefa que o programador deve dominar. O conhecimento das diversas funções de abrir, ler e escrever é essencial, pois sempre precisamos delas para armazenar ou descartar as informações que estão armazenadas nos arquivos.

Neste artigo Linux Hint, você aprenderá como usar a função write() para gravar os arquivos.

Explicaremos tudo sobre esta ella, sua sintaxe, o método de chamada, os argumentos de entrada e saída, o tipo de dado que ela aceita em cada caso e como declará-la corretamente.

Em seguida, aplicamos o que aprendemos colocando o uso dessa função em exemplos práticos que preparamos para você com trechos de código e imagens, mostrando o uso de write() na linguagem C.

Para que você tenha um conhecimento abrangente do uso da função write(), adicionamos uma seção especial que descreve os erros individuais que podem ocorrer ao usar esta função, bem como sua detecção e identificação, para que você tenha o técnicas necessárias para uma solução rápida em caso de sua ocorrência.

Sintaxe da Função Write() na Linguagem C

Descrição da Função Write() na Linguagem C

A função write() grava em um arquivo aberto. Esta função escreve o conteúdo do buffer apontado por “buf” para o arquivo que é especificado por seu descritor no argumento de entrada “fd”. O tamanho do bloco a ser gravado no arquivo deve ser especificado no argumento de entrada “n”.

Para poder escrever com a função write(), o arquivo deve ser aberto com a função open() e especificado nos atributos O_RDONLY ou O_RDWR. Caso contrário, esta função não tem efeito.

Se a chamada for bem-sucedida, ela retorna o número de caracteres inseridos. Se ocorrer um erro durante a escrita, retorna um resultado igual a -1. O código de identificação que indica o erro pode ser recuperado da variável global errno que é definida no cabeçalho “errno.h”.

Mais adiante, você encontrará uma seção onde explicamos como detectar e identificar os erros mais comuns desta função.

A função write() é definida no cabeçalho “unistd.h”. As flags que definem os atributos e o modo de abertura do arquivo são definidas em “fcntl.h”. Para usar as funções open() e write(), você deve incluir esses cabeçalhos em seu código da seguinte forma:

Como gravar em um arquivo usando a função Write () na linguagem C

Neste exemplo, escrevemos um arquivo de texto vazio chamado “example.txt” que criamos anteriormente no diretório “Documents”.

O primeiro passo é inserir os cabeçalhos necessários. Dentro da função main(), abra o arquivo com a função open(). Para fazer isso, precisamos declarar o inteiro “fd” que serve como descritor de arquivo e o array de buffer “buf” de 1024 caracteres que contém o texto que queremos escrever no arquivo. Neste buffer, armazenamos o primeiro parágrafo da página man do GCC para escrevê-lo no arquivo “example.txt”.

Depois de abrir o arquivo com a função open() no modo de leitura/gravação, escrevemos no arquivo chamando a função write() e passando o descritor de arquivo “fd” como o primeiro argumento de entrada, o ponteiro “buf” como o segundo argumento e o tamanho da string que está contida no array como o terceiro argumento, que obtemos com a função strlen(). Aqui está o código para este exemplo:

Na figura a seguir vemos a compilação e execução deste código juntamente com o arquivo aberto que é escrito pela função write():

Como adicionar um texto no final de um arquivo com a função Write () na linguagem C

Quando um arquivo é aberto especificando os sinalizadores O_WRONLY ou O_RDWR, o cursor pula para a primeira posição e começa a gravar a partir daí.

Para adicionar um texto no final de um arquivo, ele deve ser especificado por uma operação lógica OR entre os sinalizadores O_WRONLY ou O_RDWR e o sinalizador O_ APPEND no argumento dos sinalizadores de entrada da função open() quando o arquivo é aberto. Desta forma, o cursor é colocado no final do arquivo e a escrita começa a partir daí. Além disso, os atributos e o modo de gravação podem ser alterados assim que o arquivo for aberto com a função fcntl().

Na ilustração a seguir, você pode ver um código que adiciona um texto ao final do arquivo que escrevemos no exemplo anterior:

A imagem a seguir mostra o texto adicionado. Como você pode ver, com este método de abertura, a função write() começa a escrever na posição do último caractere escrito no arquivo:

Como detectar e identificar os erros que podem ocorrer ao usar a função Write() na linguagem C

Usar write() pode gerar vários erros. Quando isso acontece, esta função retorna um resultado igual a -1.

A maneira mais fácil de determinar se ocorreu um erro é usar uma condição “se” em que a condição é o valor de retorno de -1. Agora, vamos ver como você pode usar esse método para determinar se ocorreu um erro:

Se a função write() retornar com um erro, ela fará a transição para a instrução “if” e imprimirá a mensagem “ Ocorreu um erro ao tentar gravar o arquivo “.

Quando ocorre um erro, um código numérico é armazenado automaticamente na variável global errno que é definida no cabeçalho “errno.h”. Este código pode ser usado para identificar o erro ocorrido.

Segue um trecho com os erros que a função write() pode gerar e que são definidos no cabeçalho “errno.h”, juntamente com uma breve descrição de cada erro e o valor inteiro associado:

A maneira mais fácil de identificar um erro é abrir uma chave onde a variável errno é a condição de salto e cada caso é uma definição de erro.

A seguir, vejamos um exemplo onde tentamos inserir um descritor com sinal negativo, resultando em erro. Para identificar um erro, usamos a condição “if” que vimos no snippet anterior. Para identificá-lo, abrimos um switch com os três erros mais comuns que essa função pode produzir.

Como podemos ver na figura a seguir, a função write() retorna um erro quando um descritor inválido é passado como argumento de entrada. O valor que é recuperado da variável errno é usado como uma condição de salto que nos permite identificar o erro quando entramos no caso EBADF.

Conclusão

Neste artigo Linux Hint, mostramos como usar a função write() para gravar nos arquivos. Mostramos a você a sintaxe e a descrição teórica desta função. Também explicamos os métodos de detecção e identificação de erros para que você tenha as ferramentas e técnicas necessárias para resolver esses problemas rapidamente.

Para ajudar você a entender como o write() funciona, implementamos o uso dessa função em exemplos práticos com códigos e imagens que mostram o uso dessa e de outras funções de processamento de arquivos.

Também mostramos como selecionar o modo de abertura de arquivo para inserir um texto no início ou no final do arquivo e quais funções estão disponíveis para alterar esses atributos.