A biblioteca padrão
Slide 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:00 ou 18: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}"
	}
}