Удаляет существующий объект из таблицы (по итератору).
- Аргументы
-
| itr | — итератор на удаляемый объект |
- Предусловие
- itr указывает на существующий элемент
- Постусловие
- Объект удалён из таблицы, связанное хранение освобождено.
-
Обновлены вторичные индексы таблицы.
-
Прежнему плательщику за хранение возвращается стоимость таблицы и вторичных индексов для удалённого объекта; при удалении таблицы и индексов — также накладные расходы.
- Возвращает
- Для сигнатуры с
const_iterator — итератор на объект, следующий за удалённым.
Исключения: Удаляемого объекта нет в таблице. Действие не уполномочено изменять таблицу. Недопустимый итератор.
Пример:
void myaction() {
auto itr = addresses.find("dan"_n);
eosio::check(itr != addresses.end(),
"Address for account not found");
addresses.erase( itr );
eosio::check(itr != addresses.end(),
"Everting lock arf, Address not erased properly");
}
}
EOSIO_ABI( addressbook, (myaction) )
См. определение в файле multi_index.hpp строка 1894