CKTIS / C++
std::ofstream — escrever num ficheiro
std::ofstream de <fstream> escreve dados num ficheiro através de uma interface de fluxo. Aprende sobre a substituição predefinida do conteúdo, a escrita no fim do ficheiro e a verificação de erros ao abrir, escrever e fechar.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <fstream>
std::ofstream out("file.txt");
out << "text\n";
out.close();std::ofstream de <fstream> é um alias de std::basic_ofstream<char>. Fornece um fluxo de saída associado a um ficheiro; o operador << realiza saída formatada. O objeto pode ser movido, mas não copiado.
Um construtor que recebe um caminho tenta abrir imediatamente o ficheiro. Por predefinição, std::ios::out cria o ficheiro, se possível, ou elimina o conteúdo de um ficheiro existente. std::ios::trunc exprime explicitamente essa eliminação. Para acrescentar dados, utiliza std::ios::app, que encaminha cada escrita para o fim do ficheiro. std::ios::ate posiciona no fim apenas depois da abertura; não substitui a escrita em modo de acrescento. std::ios::binary seleciona o modo binário, mas não transforma << numa escrita bruta da representação de um objeto.
Verifica o estado com if (!out) depois da abertura e depois de escrever e fechar. is_open() indica que existe um ficheiro aberto associado, não que todas as escritas tenham sido bem-sucedidas. Por predefinição, os erros do fluxo são comunicados através de indicadores de estado; é possível ativar exceções com exceptions(). A saída é armazenada em buffer: um erro pode só se tornar visível quando o buffer é esvaziado ou quando se chama close().
A destruição do objeto fecha automaticamente o ficheiro através do respetivo buffer. Uma chamada explícita a close() permite verificar se ocorreu um erro ao fechar antes de o fluxo deixar de existir. O exemplo substitui o conteúdo de cktis-ofstream-example.txt no diretório de trabalho atual e escreve saved apenas depois de verificar o estado após o fecho. Utiliza funcionalidades disponíveis em C++23; o documento ligado é um projeto de norma em evolução, não uma edição definitiva de C++23.
Exemplos
#include <fstream>
#include <iostream>
int main() {
std::ofstream out("cktis-ofstream-example.txt",
std::ios::out | std::ios::trunc);
if (!out) {
std::cerr << "open failed\n";
return 1;
}
out << "Hello, file!\n";
out.close();
if (!out) {
std::cerr << "write or close failed\n";
return 1;
}
std::cout << "saved\n";
}
Resultado
saved
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.