Метод first_key_value

Метод first_key_value возвращает первую пару ключ-значение из коллекции BTreeMap. Под «первой» понимается пара с наименьшим ключом, так как элементы в BTreeMap всегда упорядочены по возрастанию ключей. Метод не принимает параметров и возвращает значение типа Option: вариант Some с кортежем (&K, &V), если коллекция не пуста, и None, если она пуста.

Синтаксис

btreemap.first_key_value()

Пример

Давайте создадим BTreeMap с несколькими элементами и получим первую пару ключ-значение:

use std::collections::BTreeMap;

fn main()
{
	let mut map = BTreeMap::new();
	map.insert("b", 2);
	map.insert("a", 1);
	map.insert("c", 3);

	let res = map.first_key_value();
	println!("{:?}", res);
}

Результат выполнения кода:

Some(("a", 1))

Пример

Давайте проверим поведение метода на пустой коллекции BTreeMap:

use std::collections::BTreeMap;

fn main()
{
	let map: BTreeMap<&str, i32> = BTreeMap::new();

	let res = map.first_key_value();
	println!("{:?}", res);
}

Результат выполнения кода:

None

Пример

Давайте извлечём ключ и значение по отдельности с помощью сопоставления с образцом:

use std::collections::BTreeMap;

fn main()
{
	let mut map = BTreeMap::new();
	map.insert("abcde", 10);
	map.insert("12345", 20);

	if let Some((key, value)) = map.first_key_value()
	{
		println!("{}: {}", key, value);
	}
}

Результат выполнения кода:

"12345: 20"

Смотрите также

класс BTreeMap,
который представляет упорядоченную коллекцию пар ключ-значение
метод last_key_value,
который возвращает последнюю пару ключ-значение
метод get,
который возвращает значение по указанному ключу
метод insert,
который добавляет пару ключ-значение в коллекцию