Perguntas Frequentes
Licenciamento & Código Aberto
Qual licença o Aspose.Cells FOSS para Rust usa?
O crate é lançado sob a MIT License. O texto completo está incluído no repositório como LICENSE.txt.
Posso usá-lo em produtos comerciais?
Sim. A MIT License permite uso comercial, modificação e redistribuição. O único requisito é preservar o aviso de direitos autorais e a licença nas cópias ou nas partes substanciais do software.
Instalação & Requisitos
Como instalo o crate?
Adicione aspose-cells-foss-rust ao seu Cargo.toml como uma dependência git:
# Cargo.toml
[dependencies]
aspose-cells-foss-rust = { git = "https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Rust" }Veja o guia de instalação para um walkthrough passo a passo.
Quais versões do Rust são suportadas?
A crate tem como alvo a edição 2021 do Rust.
Ele requer Microsoft Office ou bibliotecas nativas?
Não. A biblioteca lê e grava o formato de pacote XLSX diretamente — sem instalação do Microsoft Office, automação COM ou runtime externo envolvido.
Suporte a Formatos
Quais formatos podem ser lidos e gravados?
XLSX é o formato suportado na versão atual: leitura e gravação completas em round-trip. O carregamento passa por Workbook::load_xlsx (o enum LoadFormat cobre Auto e Xlsx), e a gravação passa por save, save_xlsx ou save_with_format com o enum SaveFormat.
Pode reparar arquivos XLSX danificados?
LoadOptions expõe try_repair_package e try_repair_xml flags, e LoadDiagnostics relata os problemas encontrados durante o carregamento:
let options = LoadOptions {
try_repair_package: true,
try_repair_xml: true,
..LoadOptions::default()
};
let loaded = Workbook::load_xlsx_with_options(&path, &options)?;API Usage
Qual é o padrão típico para criar uma pasta de trabalho?
Crie um Workbook, delimite os empréstimos mutáveis, escreva valores, então salve:
let mut workbook = Workbook::new();
{
let mut worksheets = workbook.get_worksheets_mut();
let sheet = worksheets.get(0)?;
let mut cells = sheet.get_cells_mut();
cells.get("A1")?.put_value_string("Hello")?;
}
workbook.save("hello.xlsx")?;Como escrevo diferentes tipos de valores nas células?
Use os setters tipados em uma célula mutável: put_value_string, put_value_i32, put_value_bool, put_value_decimal e put_value_date_time.
Como escrevo uma fórmula?
Use put_formula_with_cached_value, fornecendo o valor que o Excel deve exibir antes de sua primeira recalculação:
cells.get("G1")?
.put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;Como leio os valores de volta de uma pasta de trabalho carregada?
Obtenha a planilha com worksheet (ou a coleção de planilhas), então leia as células via get_cells; display_string_value devolve o texto exibido e value_type informa o tipo armazenado.
Limitações Conhecidas
O crate está no crates.io?
Ainda não — instale-o como uma dependência git do Cargo a partir do repositório GitHub. O Cargo registra o commit exato em Cargo.lock, para que as compilações permaneçam reproduzíveis.
Outras formatos além de XLSX são suportados?
Não. A versão atual concentra-se no round-trip de XLSX; outros formatos de planilha não são lidos nem escritos.
