A biblioteca padrãoSlide 57 de 85
57xlsxA biblioteca padrão
Planilhas
hive.file.xlsx(path) e hive.file.ods(path) leem cada um uma pasta de trabalho inteira e respondem com um Result<Table[dyn], hive.file.TableError> — uma Table por aba, na ordem do documento, então uma aba vazia é uma Table vazia e não uma ausente. As abas são alcançadas pela posição: os nomes delas não são guardados. Os dois leitores são escritos sem dependências, e nomear um é o que o traz para a build.
- Toda linha é completada até a mais larga da aba, então uma célula dentro dos limites da primeira linha está dentro dos limites de toda linha.
- Uma célula chega como o arquivo a guarda — números, booleanos e o último resultado de uma fórmula intocados — com uma exceção: o xlsx guarda uma data como uma contagem de dias, então o formato de número dela é consultado e uma data sai como
2026-07-25,2026-07-25 18:00:00ou18:00:00. Um ods já guarda datas de verdade. - Um arquivo xlsx deixa de fora uma linha sem nada, então uma segunda linha em branco faz da terceira a
table[1]; um ods mantém as linhas em branco entre as preenchidas.
proc main(): void {
sheets := hive.file.xlsx("./ledger.xlsx")
if sheets is Result.Ok(tables) {
if tables bounds 0 {
echo len(tables[0])
}
} else if sheets is Result.Error(err) {
echo "ainda sem planilha: {err.message}"
}
}