# V3186. The arguments violate the bounds of collection. Passing these values into the method will result in an exception.

Анализатор обнаружил подозрительный вызов метода, выполняющего операции над фрагментом коллекции. Переданные в метод аргументы некорректны: их использование предполагает взаимодействие с элементами за границей коллекции. Это приводит к выбросу исключения.

Рассмотрим пример:

    int[] arr = new int[] { 0, 1, 3, 4 };
    var indexOfOdd = Array.FindIndex(arr,
                                     startIndex: 2,
                                     count: 3,
                                     x => x % 2 == 1);

Метод 'FindIndex' принимает следующие аргументы:

- 'arr' — массив, в котором будет происходить поиск индекса элемента;
- 'startIndex: 2' — индекс элемента, с которого начнется поиск;
- 'count: 3' — количество элементов, которые будут просмотрены, начиная со стартового;
- 'x => x % 2 == 1' — предикат, содержащий условие для сопоставления элемента.

Метод возвращает либо индекс первого элемента, соответствующего предикату, либо '-1'.

Массив 'arr' состоит из четырех элементов, значит индекс последнего элемента — '3'. Здесь же разработчик пытается получить доступ к элементу с индексом '4'. В таком случае будет выброшено соответствующее исключение.

Корректная реализация поиска индекса элемента может выглядеть следующим образом:

    int[] arr = new int[] { 0, 1, 3, 4 };
    var indexOfOdd = Array.FindIndex(arr,
                                     startIndex: 2,
                                     count: 2,
                                     x => x % 2 == 1);

Или же вы можете использовать перегрузку метода, не указывающую параметр 'count'. В таком случае обход всегда будет заканчиваться на последнем элементе коллекции:

    int[] arr = new int[] { 0, 1, 3, 4 };
    var indexOfOdd = Array.FindIndex(arr,
                                     startIndex: 2,
                                     x => x % 2 == 1);

Также аргументы могут формировать секцию в обратную сторону. Например:

    int[] arr = new int[] { 0, 1, 3, 4 };
    var lastEvenInd = Array.FindLastIndex(arr,
                                          startIndex: 1,
                                          count: 3,
                                          x => x % 2 == 0);

Здесь аргументы выполняют те же самые роли, однако элементы будут просматриваться в обратном порядке. Область поиска здесь формируется из элемента с индексом '1' и двух элементов, стоящих перед ним. Таким образом, методу нужно будет обратиться по индексу '-1'. Так как такое поведение некорректно, будет выброшено исключение.

В этом случае корректная реализация поиска индекса может выглядеть так:

    int[] arr = new int[] { 0, 1, 3, 4 };
    var lastEvenInd = Array.FindLastIndex(arr,
                                          startIndex: 1,
                                          count: 2,
                                          x => x % 2 == 0);

Рассмотрим более сложный пример:

    var list = new List<int> { 2, 3, 5, 7 };
    var index = GetFirstEvenIndex(list, 1, list.Count);
    ....
    public int GetFirstEvenIndex(List<int> lst, int startIndex, int count)
    {
      return lst.FindIndex(startIndex, count, x => x % 2 == 0);
    }

Параметры метода 'GetFirstEvenIndex':

- 'lst' – коллекция, в которой происходит поиск индекса первого четного числа в указанном диапазоне;
- 'startIndex' – индекс элемента, с которого начнется диапазон поиска;
- 'count' – количество элементов в обрабатываемом диапазоне.

Здесь формируется диапазон поиска от элемента с индексом '1' до элемента с индексом 'list.Count' включительно. Таким образом, методу нужно будет обратиться по индексу, лежащему за пределами коллекции. Так как такое поведение некорректно, будет выброшено исключение.

Корректный код передачи аргументов методу может выглядеть следующим образом:

    var list = new List<int> { 2, 3, 5, 7 };
    var startIndex = 1;
    var index = GetFirstEvenIndex(list, startIndex, list.Count - startIndex);

Данная диагностика классифицируется как:

CWE-687