Осуществляет поиск строки таблицы по значению.
Синтаксис
Метод Найти() имеет следующий синтаксис:
СтрокаТаблицыЗначений Найти(Значение, [Колонки=""])
А также альтернативный англоязычный синтаксис:
ValueTableString Find(Value, [Columns=""])
Параметры
Описание параметров метода Найти():
| Имя параметра* | Тип | Описание |
|---|---|---|
| Значение | Произвольный | Искомое значение. |
| Колонки | Строка | Список имен колонок, разделенных запятыми, по которым производится поиск. Значение по умолчанию: пустая строка |
| *Жирным шрифтом выделены обязательные параметры | ||
Возвращаемое значение
СтрокаТаблицыЗначений |
— строка, в которой содержится искомое значение |
Неопределено |
— если значение не найдено |
Описание
Метод Найти() осуществляет поиск строки таблицы значений, содержащей искомое значение. По умолчанию, поиск осуществляется по всей таблице значений. Если указать параметр Колонки, поиск будет осуществляется только в указанных колонках таблицы значений.
Внимание! Метод находит только первую строку с указанным значением. Чтобы найти все строки, воспользуйтесь методом ТаблицаЗначений.НайтиСтроки()
Доступность
| Версия | Поддержка |
|---|---|
| 8.1 | Сервер, Клиент, Внешнее соединение |
| 8.2 | Сервер, Толстый клиент, Внешнее соединение |
| 8.3 | Сервер, Толстый клиент, Внешнее соединение, Мобильный автономный сервер, Мобильное приложение |
Пример использования
Пример кода с использованием метода Найти():
//создаем таблицу товаров тз = Новый ТаблицаЗначений; тз.Колонки.Добавить("Код"); тз.Колонки.Добавить("Наименование"); тз.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число")); тз.Колонки.Добавить("Цена" , Новый ОписаниеТипов("Число")); тз.Колонки.Добавить("Сумма" , Новый ОписаниеТипов("Число")); //добавляем товары и цены НоваяСтрока = тз.Добавить(); НоваяСтрока.Код = "001"; НоваяСтрока.Наименование = "Стул деревянный"; НоваяСтрока.Количество = 2; НоваяСтрока.Цена = 2000; НоваяСтрока.Сумма = НоваяСтрока.Количество * НоваяСтрока.Цена; НоваяСтрока = тз.Добавить(); НоваяСтрока.Код = "001"; НоваяСтрока.Наименование = "Стол деревянный"; НоваяСтрока.Количество = 1; НоваяСтрока.Цена = 8000; НоваяСтрока.Сумма = НоваяСтрока.Количество * НоваяСтрока.Цена; //выводим итоговую информацию найдСтрока = тз.Найти("Стол деревянный", "Наименование"); Если НЕ найдСтрока = Неопределено Тогда Сообщить("Найден товар: " + найдСтрока.Наименование + " на сумму " + найдСтрока.Сумма); КонецЕсли
Читайте также:
Программная работа с таблицей значений