Те саме, що clearRowsByConditional, але по стовпцях: вміст зникає, стовпці лишаються, тому літери наступних стовпців не змінюються.
Аркуш читається один раз, очищення групується в суміжні блоки.
Аркуш означає весь його діапазон даних; діапазон — лише свої клітинки, решта аркуша не читається й не чіпається. В обох випадках предикат отримує позицію на аркуші, тож стовпець зберігає свій справжній номер.
Аркуш, з яким працюємо, або діапазон, усередині якого працюємо: читаються лише його клітинки, і очищаються лише вони.
predicate
ColumnPredicate
Отримує комірки стовпця, його позицію від одиниці та — якщо задано headerColumn — стовпець із ключами за іменами рядків. Поверніть true для стовпців, з якими треба щось зробити.
options(необов'язковий)= {}
ColumnConditionalOptions \| null \| undefined
headerColumn вказує стовпець з іменами рядків і виводить цей стовпець з числа кандидатів.
Повертає
number — скількох це торкнулося.
Винятки
Виняток
Умова
InvalidSheetException
перший аргумент не є ні аркушем, ні діапазоном.
IllegalArgumentException
предикат не функція або позиція заголовка не додатне ціле.
const sheet = SpreadsheetApp.getActiveSheet();
// Only B2:Z100 is read, and only those cells are cleared.
clearColumnsByConditional(sheet.getRange("B2:Z100"), (values) =>
values.every((cell) => cell === "")
);