Criando uma Biblioteca em Rust

Introdução

Neste laboratório, criaremos uma biblioteca chamada rary em Rust. A biblioteca rary contém uma função pública chamada public_function, uma função privada chamada private_function e uma função de acesso indireto chamada indirect_access. Posteriormente, compilaremos a biblioteca usando o comando rustc, resultando num ficheiro chamado library.rlib.

Nota: Se o laboratório não especificar um nome de ficheiro, pode usar qualquer nome que desejar. Por exemplo, pode usar main.rs, compilá-lo e executá-lo com rustc main.rs && ./main.

Criando uma Biblioteca

Vamos criar uma biblioteca e, em seguida, ver como ligá-la a outro projeto.

Em rary.rs:

pub fn public_function() {
    println!("chamada da função `public_function()` da biblioteca rary");
}

fn private_function() {
    println!("chamada da função `private_function()` da biblioteca rary");
}

pub fn indirect_access() {
    print!("chamada da função `indirect_access()` da biblioteca rary, que\n> ");

    private_function();
}

$ rustc --crate-type=lib rary.rs
$ ls lib*
library.rlib

As bibliotecas são prefixadas com "lib" e, por padrão, recebem o nome do seu ficheiro de projeto, mas este nome padrão pode ser alterado passando a opção --crate-name para rustc ou usando o atributo #[crate_name].

Resumo

Parabéns! Concluiu o laboratório de Criação de uma Biblioteca. Pode praticar mais laboratórios no LabEx para melhorar as suas competências.