Метод ЭЛЕКТРОННАЯ_ТАБЛИЦА. ЗНАЧ_ЯЧЕЙКИ
Метод ЗНАЧ_ЯЧЕЙКИ – основное средство считывания данных электронной таблицы. Ячейка, для которой выполняется чтение, должна быть предварительно выбрана вызовом метода УСТ_ТЕК_ПОЗ или УСТ_ТЕК_ЯЧЕЙКУ. Если текущая ячейка попадает в область, указанную при вызове метода СЧИТАТЬ_БУФЕР, то чтение значения выполняется из буфера, что радикально увеличивает скорость.
ФУНКЦИЯ ЛОГИКА: ЗНАЧ_ЯЧЕЙКИ(СТРОКА: тип; ПЕРЕМ *<СТРОКА,ЧИСЛО,ЦЕЛОЕ,ЛОГИКА,ДАТА,ВРЕМЯ,ДАТА_ВРЕМЯ>: знач)
Параметры
- тип
- Константа из набора ЭТ_...
- знач
- Выходной параметр. Переменная для получения значения. Тип переменной должен соответствовать константе, указанной в параметре тип. Для считывания формулы (ЭТ_ФОРМУЛА) необходимо предоставить строковую переменную. Чтение формул всегда выполняется в обход буфера.
Возвращаемое значение
ДА – в случае успешного считывания, НЕТ – в случае ошибки. Сообщение об ошибке может быть получено с помощью метода ПОСЛ_ОШИБКА.
Замечание
Данные ячейки могут интерпретироваться по разному в зависимости от запрошенного типа значения. Например, все варианты даты и времени могут быть запрошены как вещественное число. Также у ячейки, содержащей значение дата+время, можно запросить по отдельности значение даты и времени.
Пример
ПЕРЕМ ЭЛЕКТРОННАЯ_ТАБЛИЦА: т
//... открываем файл, выбираем лист...
ЦИКЛ ДЛЯ (стр = 1, 100)
т.УСТ_ТЕК_ЯЧЕЙКУ("A", стр) // выбираем ячейку в столбце "A"
ПЕРЕМ СТРОКА: назв
ЕСЛИ НЕ т.ЗНАЧ_ЯЧЕЙКИ(ЭТ_СТРОКА, назв) ТО
ОТЛАДКА(т.ПОСЛ_ОШИБКА)
СТОП
КОНЕЦ_ЕСЛИ
т.УСТ_ТЕК_ЯЧЕЙКУ("B", стр) // выбираем другую ячейку в столбце "B"
ПЕРЕМ ЧИСЛО: сумма
ЕСЛИ НЕ т.ЗНАЧ_ЯЧЕЙКИ(ЭТ_ЧИСЛО, сумма) ТО
ОТЛАДКА(т.ПОСЛ_ОШИБКА)
СТОП
КОНЕЦ_ЕСЛИ
ОТЛАДКА("Прочитали: " + назв + " " + СТР(сумма))
КОНЕЦ_ЦИКЛА