Number of Paths

Предполагаемое статическое количество пути

Описание

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

Рекомендуемый верхний предел для этой метрики равняется 80. Если количество путей высоко, код затрудняет в чтение и может вызвать больше оранжевых проверок. Попытайтесь ограничить значение этой метрики.

Осуществлять пределы на метриках:

В пользовательском интерфейсе Polyspace^® смотрите, Вычисляют Метрики сложности кода.
В Метрическом веб-интерфейсе Polyspace смотрите, Сравнивают Метрики С Целями Качества программного обеспечения.

Детали расчета

Количество путей вычисляется согласно этим правилам:

Если операторы в функции не повреждают поток управления, количество путей является тем.
Даже пустой оператор, такой как ; или пустой блок, такой как {} количества как один путь.
Количество путей для оператора управления вычисляется можно следующим образом:
- if-else if-else: Количество путей является суммой путей, вычисленных в if блокируйтесь, каждый else if блокируйтесь, и заключительный else блок. Когда заключительный else блок не использован, количество пути увеличено на 1.
  Например, оператор if(..) {} else if(..) {} else {} количества как три пути. Оператор if() {} количества как два пути, один для if блокируйтесь и один для не использованного else блок.
- switch-case: Каждый case с break оператор добавляет тот в количество пути. default оператор рассчитывает как один путь, даже если это не использовано.
  Например, оператор switch (var) { case 1: .. break; case 2: .. break; default: .. } количества как три пути.
- forв то время как, и do-while: Количество путей равно количеству путей в теле цикла + 1.
  Например, оператор while(0) {;} количества как два пути.
- Тернарные операторы: оператор с тернарным оператором такой как
```
result = a > b ? a : b;
```
  считается как один оператор, который не повреждает поток управления. Количество путей рассматривается как один.
Если больше чем один оператор управления присутствует в последовательности, количество путей является продуктом счета пути для каждого оператора управления.
Например, если функция имеет три for циклы и два if-else операторы, количество путей является 2 × 2 × 2 × 2 × 2 = 32.
Если много операторов управления присутствуют в функции, количество путей может быть большим. Вложенные операторы управления сокращают количество путей за счет увеличения глубины вложения. Для примера смотрите Функцию с Вложенными Операторами управления.
Программное обеспечение отображает определенные значения в случаях, где метрика не вычисляется:
- Если goto операторы присутствуют в теле функции, Polyspace не может вычислить количество путей. Программное обеспечение отображает метрическое значение-1.
- Если количество путей достигает внутреннего предела, остановок вычисления. Программное обеспечение отображает этот предел как метрическое значение. Предел равняется 9223372036854775807 (указание на шестнадцатеричный номер 0x7fffffffffffffff).

Примеры

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

Функция с одним путем

void func(int ch) {
    switch (ch)
    {
    case 1:
    case 2:
    case 3:
    case 4:
    default:
    }
}

В этом примере, func имеет один путь.

Функция с оператором управления, вызывающим разнообразные пути

void func(int ch) {
    switch (ch)
    {
    case 1:
        break;
    case 2:
        break;
    case 3:
        break;
    case 4:
        break;
    default:
    }
}

В этом примере, func имеет пять путей. Кроме пути, который проходит cases и default, каждый break вызывает создание нового пути.

Функция с вложенными операторами управления

void func()
{
    int i = 0, j = 0, k = 0;
    for (i=0; i<10; i++)
    {
        for (j=0; j<10; j++)
        {
            for (k=0; k<10; k++)
            {
                if (i < 2 )
                    ;
                else
                {
                    if (i > 5)
                        ;
                    else
                        ;
                }
            }
        }
    }
}

В этом примере, func имеет шесть путей. Номер вычисляется можно следующим образом:

Самый внутренний if-else блокируйте количества как два пути.
Внешний if-else блокируйте количества как три пути, один путь для if блокируйтесь и предыдущие два пути для else блок.
Самый внутренний for цикл рассчитывает как четыре пути, один путь для цикла и предыдущие три пути для if-else блоки.
Следующие два внешних цикла добавляют один путь каждый.

Поэтому количество путей в func шесть.

Метрическая информация

Группа: Функция

Акроним: PATH

Метрика HIS: да

Документация