static_cast conversion

Преобразует между типами, используя комбинацию неявных и пользовательских преобразований.

Синтаксис

Возвращает значение типа target-type .

Объяснение

Только следующие преобразования могут быть выполнены с помощью static_cast , за исключением случаев, когда такие преобразования снимают константность (или волатильность).

struct B {};
struct D : B { B b; };
D d;
B& br1 = d;
B& br2 = d.b;
static_cast<D&>(br1); // OK, lvalue обозначает исходный объект "d"
static_cast<D&>(br2); // UB: подобъект "b" не является подобъектом базового класса

Как и для всех выражений приведения, результат:

• lvalue, если target-type является типом lvalue-ссылки или rvalue-ссылкой на тип функции (начиная с C++11) ;

• в противном случае является prvalue.

1. ↑ Этот тип static_cast используется для реализации семантики перемещения в std::move .
2. ↑ Если поддерживается арифметика IEEE, округление по умолчанию происходит к ближайшему значению.

Указательно-конвертируемые объекты

Два объекта a и b являются pointer-interconvertible если:

• они являются одним и тем же объектом, или
• один является объектом объединения, а другой - нестатическим элементом данных этого объекта, или
• один является стандартно-компонуемым объектом класса, а другой - первым нестатическим элементом данных этого объекта или любого подобъекта базового класса этого объекта, или
• существует объект c такой, что a и c являются pointer-interconvertible, и c и b являются pointer-interconvertible.

union U { int a; double b; } u;
void* x = &u;                        // значение x — «указатель на u»
double* y = static_cast<double*>(x); // значение y — «указатель на u.b»
char* z = static_cast<char*>(x);     // значение z — «указатель на u»

Примечания

Преобразования из базового класса в производный ( понижающие приведения ) с использованием static_cast не выполняют проверок во время выполнения, чтобы убедиться, что динамический тип указываемого/ссылаемого объекта является Derived , и могут безопасно использоваться только если это предусловие гарантировано другими средствами, например при реализации статического полиморфизма . Безопасное понижающее приведение может быть выполнено с помощью dynamic_cast .

static_cast также может использоваться для разрешения неоднозначности перегруженных функций путем выполнения преобразования функции в указатель определенного типа, как в

std::for_each(files.begin(), files.end(),
              static_cast<std::ostream&(*)(std::ostream&)>(std::flush));

Ключевые слова

static_cast

Пример

#include <iostream>
#include <vector>
struct B
{
    int m = 42;
    const char* hello() const
    {
        return "Hello world, this is B!\n";
    }
};
struct D : B
{
    const char* hello() const
    {
        return "Hello world, this is D!\n";
    }
};
enum class E { ONE = 1, TWO, THREE };
enum EU { ONE = 1, TWO, THREE };
int main()
{
    // 1. статическое приведение вниз
    D d;
    B& br = d; // приведение вверх через неявное преобразование
    std::cout << "1) " << br.hello();
    D& another_d = static_cast<D&>(br); // приведение вниз
    std::cout << "1) " << another_d.hello();
    // 3. lvalue в xvalue
    std::vector<int> v0{1, 2, 3};
    std::vector<int> v2 = static_cast<std::vector<int>&&>(v0);
    std::cout << "3) после перемещения, v0.size() = " << v0.size() << '\n';
    // 4. выражение с отбрасываемым значением
    static_cast<void>(v2.size());
    // 5. инициализирующее преобразование
    int n = static_cast<int>(3.14);
    std::cout << "5) n = " << n << '\n';
    std::vector<int> v = static_cast<std::vector<int>>(10);
    std::cout << "5) v.size() = " << v.size() << '\n';
    // 6. обратное неявному преобразованию
    void* nv = &n;
    int* ni = static_cast<int*>(nv);
    std::cout << "6) *ni = " << *ni << '\n';
    // 7a. scoped enum в int
    E e = E::TWO;
    int two = static_cast<int>(e);
    std::cout << "7a) " << two << '\n';
    // 7b. int в enum, enum в другой enum
    E e2 = static_cast<E>(two);
    [[maybe_unused]]
    EU eu = static_cast<EU>(e2);
    // 7f. указатель на член - приведение вверх
    int D::*pm = &D::m;
    std::cout << "7f) " << br.*static_cast<int B::*>(pm) << '\n';
    // 7g. void* в любой указатель на объект
    void* voidp = &e;
    [[maybe_unused]]
    std::vector<int>* p = static_cast<std::vector<int>*>(voidp);
}

1) Hello world, this is B!
1) Hello world, this is D!
3) after move, v0.size() = 0
5) n = 3
5) v.size() = 10
6) *ni = 3
7a) 2
7f) 42

Отчеты о дефектах

Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены задним числом к ранее опубликованным стандартам C++.

Ссылки

Смотрите также

• const_cast
• dynamic_cast
• reinterpret_cast
• явное приведение
• неявные преобразования