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

CKTIS / C++

this — ponteiro para o objeto atual

A palavra-chave this aponta para o objeto tratado por uma função membro com parâmetro de objeto implícito. Permite aceder explicitamente aos membros, distinguir um membro de dados de um parâmetro com o mesmo nome e devolver o objeto atual por referência.

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

Sintaxe

this
this->member
*this
ReturnType function(this ClassName& self); // C++23 explicit object parameter

this é uma expressão prvalue cujo valor é um ponteiro para o objeto atual, e não o próprio objeto. Numa função membro comum da classe X, o seu tipo é X*; numa função membro const, é const X*. Um qualificador volatile também afeta o tipo apontado. Não é possível atribuir um novo valor a this.

A expressão this->member acede explicitamente a um membro; *this representa o objeto atual. No exemplo, this->value representa o membro de dados, enquanto value sem mais, em set, representa o parâmetro. Devolver *this como Counter& permite encadear chamadas sem copiar o objeto.

this está disponível em funções membro com parâmetro de objeto implícito e nos inicializadores predefinidos de membros de dados não estáticos. Uma função static não tem esse ponteiro. Em C++23, uma declaração como void f(this X& self) utiliza this para assinalar um parâmetro de objeto explícito; dentro dessa função, deve utilizar-se self, e não a expressão this.

Esta entrada diz respeito a C++23. A fonte fornecida é um rascunho de trabalho em evolução, não uma publicação C++23 definitiva e imutável. Uma opção do compilador num repositório não certifica o ambiente de execução de produção.

Exemplos

#include <iostream>

class Counter {
    int value = 0;

public:
    Counter& set(int value) {
        this->value = value;
        return *this;
    }

    int get() const {
        return this->value;
    }
};

int main() {
    Counter counter;
    counter.set(7).set(9);
    std::cout << counter.get() << '\n';
}

Resultado

9

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