SPECTRALANG_

// DOCS NAVIGATION

std.fs — Sistema de Arquivos_

SOURCE: content/docs/reference/05-stdlib.md05 Stdlib / 8. std.fs — Sistema de Arquivos / File System

import std.fs

fs_read(path: string) -> string

PT-BR: Lê o conteúdo completo de um arquivo. Retorna "" em caso de erro.
EN-US: Reads the full content of a file. Returns "" on error.

let conteudo = std.fs.fs_read("dados.txt")
if std.string.is_empty(conteudo) {
    println("Arquivo não encontrado ou vazio")
}

fs_write(path: string, content: string) -> bool

PT-BR: Escreve (substitui) o conteúdo de um arquivo. Cria diretórios pais ausentes quando possível. Retorna true em sucesso e false em falhas controladas de sistema de arquivos. EN-US: Writes (replaces) file content. Creates missing parent directories when possible. Returns true on success and false for controlled filesystem failures.

let ok = std.fs.fs_write("target/artefatos/saida.txt", "Hello, World!\n")

fs_append(path: string, content: string) -> bool

PT-BR: Adiciona conteúdo ao final de um arquivo. Cria diretórios pais ausentes quando possível e retorna false em falhas controladas. EN-US: Appends content to the end of a file. Creates missing parent directories when possible and returns false for controlled failures.

std.fs.fs_append("log.txt", "Nova entrada de log\n")

Falhas comuns, como caminho vazio, pai bloqueado por arquivo, permissão negada ou arquivo inexistente em leitura/remoção, não devem derrubar o processo nativo. Use o valor de retorno para decidir o fluxo de erro.

fs_exists(path: string) -> bool

if std.fs.fs_exists("config.txt") {
    let cfg = std.fs.fs_read("config.txt")
}

fs_remove(path: string) -> bool

let removido = std.fs.fs_remove("temp.txt")