Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

inline — funções e variáveis definidas em cabeçalhos

inline permite definir funções e variáveis em cabeçalhos, respeitando a regra de uma definição. Não obriga a substituir a chamada pelo corpo da função nem garante um programa mais rápido.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

inline int twice(int x) { return 2 * x; }
inline int counter = 0;
inline constexpr int limit = 10;

inline não força a otimização. O compilador pode manter uma chamada de função normal. O especificador não pode surgir numa declaração com âmbito de bloco nem numa declaração de parâmetro.

Em cabeçalhos comuns, fora de módulos nomeados, as funções e variáveis inline podem ter definições em várias unidades de tradução. No entanto, a regra de uma definição (ODR) exige a mesma sequência de tokens e uma pesquisa de nomes coerente, sem prejuízo das exceções previstas na norma. Continua a ser permitida apenas uma definição em cada unidade de tradução. A definição tem de estar acessível onde a ODR o exigir; na prática, inclua um cabeçalho partilhado. Macros que alterem a definição entre ficheiros podem violar a ODR sem que seja obrigatória uma mensagem de diagnóstico.

As variáveis inline com ligação externa designam um único objeto com um único endereço, e não uma cópia separada em cada ficheiro. inline, por si só, não significa const nem constexpr: o counter do exemplo é modificável. Uma função constexpr é implicitamente inline, tal como um membro de dados estático declarado constexpr. Uma variável comum ao nível do espaço de nomes declarada constexpr não se torna, por isso, implicitamente inline.

O exemplo mostra a função next() e as variáveis counter e step. Chamadas sucessivas escrevem 2 e 4. Um único ficheiro demonstra a sintaxe e as alterações de estado, mas não comprova a identidade partilhada do objeto entre unidades de tradução. O código fornecido é um rascunho de trabalho em evolução, não uma edição congelada de C++23.

Exemplos

#include <iostream>

inline int counter = 0;
inline constexpr int step = 2;

inline int next() {
    counter += step;
    return counter;
}

int main() {
    std::cout << next() << '\n';
    std::cout << next() << '\n';
}

Resultado

2
4

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes