Skip to main content

Метод Table::find

Метод выполняет поиск ячеек, соответствующих заданному запросу.

Внимание

Библиотеки Document API по умолчанию работают с документами используя английскую локализацию. Поэтому, при взаимодействии с документом через API, значения могут отличаться от отображаемых в интерфейсе редактора. Раздел Локализация документов содержит информацию о том, как работать с локализованными значениями.

Вызов​


 std::shared_ptr<Enumerator<Cell>> find(std::string string, TableSearchSettings settings)

Параметры​

  • string: поисковый запрос, тип string.

  • settings: (необязательный) параметры поиска, тип TableSearchSettings.

Возвращает​

  • список ячеек, соответствующих поисковому запросу.

Пример​


 Table sheet = document.getBlocks().getTable(0).get();

 TableSearchSettings searchProps = TableSearchSettings();
 searchProps.caseSensitive = CaseSensitive::No;
 searchProps.matchBehaviour = TableSearchSettings::MatchBehaviour::Glob;
 searchProps.searchIn = TableSearchSettings::SearchProperty::Value;
 searchProps.wholeWords = true;

 auto results = sheet.find("*eye", searchProps);
 while (results->isValid()) 
 {
    Cell cell = results->getCurrent();
    std::printf("%s", cell.getFormattedValue().c_str()); // Steeleye Stout
    results->goToNext();
 }