Function IConsoleHistoryAdd

src/console_gui.cpp:453–470

* Add the entered line into the history so you can look it back * scroll, etc. Put it to the beginning as it is the latest text * @param cmd Text to be entered into the 'history' * @return the command to execute */

 * @return the command to execute
 */
static std::optional<std::string_view> IConsoleHistoryAdd(std::string_view cmd)
{
	/* Strip all spaces at the begin */
	while (!cmd.empty() && IsWhitespace(cmd[0])) cmd.remove_prefix(1);

	/* Do not put empty command in history */
	if (cmd.empty()) return std::nullopt;

	/* Do not put in history if command is same as previous */
	if (_iconsole_history.empty() || _iconsole_history.front() != cmd) {
		_iconsole_history.emplace_front(cmd);
		while (_iconsole_history.size() > ICON_HISTORY_SIZE) _iconsole_history.pop_back();
	}

	/* Reset the history position */
	IConsoleResetHistoryPos();
	return _iconsole_history.front();
}

/**
 * Navigate Up/Down in the history of typed commands