exponenta event banner

CERT C++: EXP59-CPP

Использовать offsetof () для допустимых типов и элементов

Описание

Определение правила

Используйте offsetof () для допустимых типов и элементов. [ 1]

Внедрение Polyspace

Эта проверка проверяет неправильное использование смещения в C++.

Примеры

развернуть все

Проблема

Этот дефект возникает при передаче аргументов offsetof для которого поведение макроса не определено.

offsetof макро:

offsetof(classType, aMember)
возвращает смещение элемента данных в байтах aMember с начала объекта типа classType. Для использования в offsetof, classType и aMember имеют определенные ограничения:

  • classType должен быть стандартным классом макета.

    Например, он не должен иметь virtual функции-члены. Для получения дополнительной информации о требованиях к классу стандартного макета см. именованные требования C++ StandardLayoutType.

  • aMember не должен быть статичным.

  • aMember не должна быть функцией-членом.

Флаги проверки используют offsetof где аргументы нарушают одно или несколько из этих ограничений.

Риск

Нарушение ограничений по аргументам offsetof макрос приводит к неопределенному поведению.

Зафиксировать

Используйте offsetof макрос только на нестатических элементах данных класса стандартного макета.

Результат содержит сведения о состоянии, которое ограничивает offsetof нарушен макрос. Устраните нарушение.

Пример - Использование offsetof Макрос с нестандартным классом макета
#include <cstddef>

class myClass {
     int privateData;
  public:
     int publicData;
};

void func() {
  size_t off = offsetof(myClass, publicData);
  // ...
}

В этом примере класс myClass имеет два элемента данных с различным управлением доступом, один закрытый, а другой открытый. Поэтому класс не удовлетворяет требованиям класса стандартной формы и не может использоваться с offsetof макро.

Исправление - использование единого управления доступом для всех элементов данных

Если использование offsetof является важным для приложения, убедитесь, что первым аргументом является класс со стандартной компоновкой. Например, проверьте, можно ли обойти потребность в общедоступном члене данных.

#include <cstddef>
  
class myClass {
     int member1;
     int member2;
  public:
     int getMember2(void) { return member2;}
     friend void func(void);
};
  
void func() {
  size_t off = offsetof(myClass, member2);
  // ...
}

Проверить информацию

Группа: 02. Выражения (EXP)
Представлен в R2019a

[1] Данное программное обеспечение было создано компанией MathWorks и включает в себя следующие компоненты: «Веб-сайт SEI CERT-C», © 2017 Университет Карнеги-Меллон, веб-сайт SEI CERT-C + + © 2017 Университет Карнеги-Меллон, "Стандарт кодирования SEI CERT C - Правила разработки безопасных, Надежные и безопасные системы - 2016 Edition ", © 2016 Университет Карнеги-Меллон, и "Стандарт кодирования SEI CERT C++ - Правила разработки безопасных, Надежные и безопасные системы в C++ - 2016 Edition "© 2016 Университет Карнеги-Меллон, со специальным разрешением от его Института программного обеспечения.

ЛЮБОЙ МАТЕРИАЛ УНИВЕРСИТЕТА КАРНЕГИ МЕЛЛОНА И/ИЛИ ЕГО ПРОГРАММНОГО ИНЖЕНЕРНОГО ИНСТИТУТА, СОДЕРЖАЩИЙСЯ В НАСТОЯЩЕМ ДОКУМЕНТЕ, ПОСТАВЛЯЕТСЯ КАК ЕСТЬ. УНИВЕРСИТЕТ КАРНЕГИ МЕЛЛОН НЕ ДАЕТ НИКАКИХ ГАРАНТИЙ, ВЫРАЖЕННЫХ ИЛИ ПОДРАЗУМЕВАЕМЫХ, В ОТНОШЕНИИ ЛЮБЫХ ВОПРОСОВ, ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИВАЯСЬ, ГАРАНТИИ ПРИГОДНОСТИ ДЛЯ ЦЕЛЕЙ ИЛИ ТОВАРНОЙ ПРИГОДНОСТИ, ИСКЛЮЧИТЕЛЬНОСТИ ИЛИ РЕЗУЛЬТАТОВ, ПОЛУЧЕННЫХ ОТ ИСПОЛЬЗОВАНИЯ УНИВЕРСИТЕТ КАРНЕГИ МЕЛЛОН НЕ ДАЕТ НИКАКИХ ГАРАНТИЙ В ОТНОШЕНИИ СВОБОДЫ ОТ ПАТЕНТА, ТОВАРНОГО ЗНАКА ИЛИ НАРУШЕНИЯ АВТОРСКИХ ПРАВ.

Данное программное обеспечение и связанная с ним документация не были рассмотрены и не одобрены Университетом Карнеги-Меллона или его Институтом разработки программного обеспечения.