The Battle for Wesnoth  1.19.0-dev
Namespaces | Classes | Typedefs | Enumerations | Functions | Variables
utils Namespace Reference

Namespaces

 config_filters
 Utility functions for implementing [filter], [filter_ability], [filter_weapon], etc.
 
 detail
 

Classes

class  string_map_variable_set
 
struct  hash_error
 
class  hash_base
 
class  hash_digest
 
class  md5
 
class  bcrypt
 
struct  res_compare
 
class  back_edge_detector
 A helper for boost::depth_first_search (DFS) usage with the purpose of detecting cycles. More...
 
struct  const_clone
 Helper struct to clone the constness of one type to another. More...
 
class  guard_value
 Data-based RAII scope guard. More...
 
class  irdya_date
 Calendar for handling and comparing dates using the common epoches of the storyline. More...
 
struct  optimer
 Reports time elapsed at the end of an object scope. More...
 
class  optional_reference
 A simple wrapper class for optional reference types. More...
 
class  scope_exit
 
struct  scope_exit_syntax_support
 
class  shared_reference
 
struct  wesnoth_epoch_defines
 Reference points for the dates that define the storyline's calendar. More...
 

Typedefs

using byte_string_view = std::basic_string_view< uint8_t >
 
using string_map = std::map< std::string, t_string >
 
using string_map_res = std::map< std::string, t_string, res_compare >
 
template<typename D , typename S >
using const_clone_t = typename const_clone< D, S >::type
 
template<typename D , typename S >
using const_clone_ref = typename const_clone< D, S >::reference
 
template<typename D , typename S >
using const_clone_ptr = typename const_clone< D, S >::pointer
 
using ms_optimer = optimer< std::chrono::milliseconds >
 Time elapsed with millisecond resolution. More...
 
using wesnoth_epoch = string_enums::enum_base< wesnoth_epoch_defines >
 

Enumerations

enum  { REMOVE_EMPTY = 0x01 , STRIP_SPACES = 0x02 }
 

Functions

std::vector< std::string > split (const config_attribute_value &val)
 
std::string format_time_summary (std::time_t t)
 
std::string interpolate_variables_into_string (const std::string &str, const string_map *const symbols)
 Function which will interpolate variables, starting with '$' in the string 'str' with the equivalent symbols in the given symbol table. More...
 
std::string interpolate_variables_into_string (const std::string &str, const std::map< std::string, std::string > *const symbols)
 
std::string interpolate_variables_into_string (const std::string &str, const variable_set &variables)
 
t_string interpolate_variables_into_tstring (const t_string &str, const variable_set &variables)
 Function that does the same as the above, for t_stringS. More...
 
std::string format_conjunct_list (const t_string &empty, const std::vector< t_string > &elems)
 Format a conjunctive list. More...
 
std::string format_disjunct_list (const t_string &empty, const std::vector< t_string > &elems)
 Format a disjunctive list. More...
 
std::string format_timespan (std::time_t time, bool detailed=false)
 Formats a timespan into human-readable text for player authentication functions. More...
 
bool might_contain_variables (const std::string &str)
 Determines if a string might contain variables to interpolate. More...
 
std::string interpolate_variables_into_string (const std::string &str, const std::map< std::string, t_string > *const symbols)
 Function which will interpolate variables, starting with '$' in the string 'str' with the equivalent symbols in the given symbol table. More...
 
bool isnewline (const char c)
 
bool portable_isspace (const char c)
 
bool notspace (const char c)
 
void trim (std::string_view &s)
 
std::vector< std::string > split (std::string_view s, const char sep, const int flags)
 Splits a (comma-)separated string into a vector of pieces. More...
 
std::set< std::string > split_set (std::string_view s, char sep, const int flags)
 
std::vector< std::string_view > split_view (std::string_view s, const char sep, const int flags)
 
std::vector< std::string > square_parenthetical_split (const std::string &val, const char separator=',', const std::string &left="([", const std::string &right=")]", const int flags=REMOVE_EMPTY|STRIP_SPACES)
 Similar to parenthetical_split, but also expands embedded square brackets. More...
 
std::map< std::string, std::string > map_split (const std::string &val, char major=',', char minor=':', int flags=REMOVE_EMPTY|STRIP_SPACES, const std::string &default_value="")
 Splits a string based on two separators into a map. More...
 
std::vector< std::string > parenthetical_split (std::string_view val, const char separator=0, std::string_view left="(", std::string_view right=")", const int flags=REMOVE_EMPTY|STRIP_SPACES)
 Splits a string based either on a separator, except then the text appears within specified parenthesis. More...
 
int apply_modifier (const int number, const std::string &amount, const int minimum)
 
std::string escape (const std::string &str, const char *special_chars)
 Prepends a configurable set of characters with a backslash. More...
 
static void si_string_impl_stream_write (std::stringstream &ss, double input)
 
static bool is_username_char (char c)
 
static bool is_wildcard_char (char c)
 
static bool is_word_boundary (char c)
 
std::string indent (const std::string &string, std::size_t indent_size=4)
 Indent a block of text. More...
 
std::vector< std::string > quoted_split (const std::string &val, char c=',', int flags=REMOVE_EMPTY|STRIP_SPACES, char quote='\\')
 This function is identical to split(), except it does not split when it otherwise would if the previous character was identical to the parameter 'quote' (i.e. More...
 
std::pair< int, int > parse_range (const std::string &str)
 Recognises the following patterns, and returns a {min, max} pair. More...
 
std::pair< double, double > parse_range_real (const std::string &str)
 Recognises similar patterns to parse_range, and returns a {min, max} pair. More...
 
std::vector< std::pair< int, int > > parse_ranges_unsigned (const std::string &str)
 Handles a comma-separated list of inputs to parse_range, in a context that does not expect negative values. More...
 
std::vector< std::pair< double, double > > parse_ranges_real (const std::string &str)
 
std::vector< std::pair< int, int > > parse_ranges_int (const std::string &str)
 Handles a comma-separated list of inputs to parse_range. More...
 
template<typename F >
void split_foreach_impl (std::string_view s, char sep, const F &f)
 
template<typename F >
void split_foreach (std::string_view s, char sep, const int flags, const F &f)
 
template<typename T >
std::string join (const T &v, const std::string &s=",")
 Generates a new string joining container items in a list. More...
 
template<typename T >
std::string join_map (const T &v, const std::string &major=",", const std::string &minor=":")
 
template<typename T >
std::string bullet_list (const T &v, std::size_t indent=4, const std::string &bullet=font::unicode_bullet)
 Generates a new string containing a bullet list. More...
 
std::string print_modifier (const std::string &mod)
 Add a "+" or replace the "-" par Unicode minus. More...
 
template<typename T >
std::optional< T > from_chars (std::string_view str, int base=10)
 
std::string get_unknown_exception_type ()
 Utility function for finding the type of thing caught with catch(...). More...
 
bool chars_equal_insensitive (char a, char b)
 
bool chars_less_insensitive (char a, char b)
 
template<typename Container , typename Value >
bool contains (const Container &container, const Value &value)
 Returns true iff value is found in container. More...
 
template<typename Container , typename Predicate >
void erase_if (Container &container, const Predicate &predicate)
 Convenience wrapper for using std::remove_if on a container. More...
 
template<typename Container , typename Predicate >
void sort_if (Container &container, const Predicate &predicate)
 Convenience wrapper for using std::sort on a container. More...
 
bool operator< (const irdya_date &a, const irdya_date &b)
 
bool operator<= (const irdya_date &a, const irdya_date &b)
 
bool operator> (const irdya_date &a, const irdya_date &b)
 
bool operator>= (const irdya_date &a, const irdya_date &b)
 
bool operator== (const irdya_date &a, const irdya_date &b)
 
bool operator!= (const irdya_date &a, const irdya_date &b)
 
std::ostream & operator<< (std::ostream &s, const irdya_date &d)
 
template<typename... OpTimerArgs>
std::ostream & operator<< (std::ostream &o, const optimer< OpTimerArgs... > &tm)
 Formats time elapsed for writing to a stream. More...
 
template<typename T >
auto reversed_view (T &container)
 
template<typename T , typename... Types>
shared_reference< T > make_shared_reference (Types &&...args)
 
template<typename... Types>
std::size_t variant_index (const variant< Types... > &var)
 
std::string unescape (const std::string &str)
 Remove all escape characters (backslash) More...
 
std::string urlencode (const std::string &str)
 Percent-escape characters in a UTF-8 string intended to be part of a URL. More...
 
bool string_bool (const std::string &str, bool def=false)
 Convert no, false, off, 0, 0.0 to false, empty to def, and others to true. More...
 
std::string bool_string (const bool value)
 Converts a bool value to 'true' or 'false'. More...
 
std::string signed_value (int val)
 Convert into a signed value (using the Unicode "−" and +0 convention. More...
 
std::string half_signed_value (int val)
 Sign with Unicode "−" if negative. More...
 
std::string si_string (double input, bool base2, const std::string &unit)
 Convert into a string with an SI-postfix. More...
 
bool isvalid_username (const std::string &login)
 Check if the username contains only valid characters. More...
 
bool isvalid_wildcard (const std::string &login)
 Check if the username pattern contains only valid characters. More...
 
bool word_completion (std::string &text, std::vector< std::string > &wordlist)
 Try to complete the last word of 'text' with the 'wordlist'. More...
 
bool word_match (const std::string &message, const std::string &word)
 Check if a message contains a word. More...
 
bool wildcard_string_match (const std::string &str, const std::string &match)
 Match using '*' as any number of characters (including none), '+' as one or more characters, and '?' as any one character. More...
 
void to_sql_wildcards (std::string &str, bool underscores=true)
 Converts '*' to '' and optionally escapes '_'. More...
 
void ellipsis_truncate (std::string &str, const std::size_t size)
 Truncates a string to a given utf-8 character count and then appends an ellipsis. More...
 
std::string escape (const std::string &str)
 Prepend all special characters with a backslash. More...
 
std::string quote (const std::string &str)
 Surround the string 'str' with double quotes. More...
 
std::string signed_percent (int val)
 Convert into a percentage (using the Unicode "−" and +0% convention. More...
 

Variables

const std::vector< std::string > res_order = {"blade", "pierce", "impact", "fire", "cold", "arcane"}
 
template<typename T1 , typename T2 >
constexpr bool decayed_is_same = std::is_same_v<std::decay_t<T1>, std::decay_t<T2>>
 Equivalent to as std::is_same_v except both types are passed through std::decay first. More...
 
template<typename >
constexpr bool dependent_false_v = false
 Workaround for the fact that static_assert(false) is invalid. More...
 

Typedef Documentation

◆ byte_string_view

using utils::byte_string_view = typedef std::basic_string_view<uint8_t>

Definition at line 24 of file base64.hpp.

◆ const_clone_ptr

template<typename D , typename S >
using utils::const_clone_ptr = typedef typename const_clone<D, S>::pointer

Definition at line 66 of file const_clone.hpp.

◆ const_clone_ref

template<typename D , typename S >
using utils::const_clone_ref = typedef typename const_clone<D, S>::reference

Definition at line 63 of file const_clone.hpp.

◆ const_clone_t

template<typename D , typename S >
using utils::const_clone_t = typedef typename const_clone<D, S>::type

Definition at line 60 of file const_clone.hpp.

◆ ms_optimer

using utils::ms_optimer = typedef optimer<std::chrono::milliseconds>

Time elapsed with millisecond resolution.

Definition at line 105 of file optimer.hpp.

◆ string_map

using utils::string_map = typedef std::map<std::string, t_string>

Definition at line 35 of file string_utils.hpp.

◆ string_map_res

using utils::string_map_res = typedef std::map<std::string, t_string, res_compare>

Definition at line 52 of file string_utils.hpp.

◆ wesnoth_epoch

using utils::wesnoth_epoch = typedef string_enums::enum_base<wesnoth_epoch_defines>

Definition at line 34 of file wesnoth_epoch.hpp.

Enumeration Type Documentation

◆ anonymous enum

anonymous enum
Enumerator
REMOVE_EMPTY 
STRIP_SPACES 

REMOVE_EMPTY: remove empty elements.

Definition at line 58 of file string_utils.hpp.

Function Documentation

◆ apply_modifier()

int utils::apply_modifier ( const int  number,
const std::string &  amount,
const int  minimum 
)

Definition at line 400 of file string_utils.cpp.

References div100rounded().

Referenced by unit::apply_builtin_effect(), attack_type::apply_modification(), and tod_manager::modify_turns().

◆ bool_string()

std::string utils::bool_string ( const bool  value)

Converts a bool value to 'true' or 'false'.

Definition at line 486 of file string_utils.cpp.

Referenced by frame_parsed_parameters::debug_strings(), team_builder::init(), ai::lua_aspect_visitor::operator()(), gui2::dialogs::drop_down_menu::pre_show(), and gui2::dialogs::stuff_list_adder::widget().

◆ bullet_list()

template<typename T >
std::string utils::bullet_list ( const T &  v,
std::size_t  indent = 4,
const std::string &  bullet = font::unicode_bullet 
)

Generates a new string containing a bullet list.

List items are preceded by the indentation blanks, a bullet string and another blank; all but the last item are followed by a newline.

Parameters
vA container with elements.
indentNumber of indentation blanks.
bulletThe leading bullet string.

Definition at line 247 of file string_utils.hpp.

References i, and indent().

Referenced by addons_client::do_check_before_overwriting_addon(), and addons_client::do_resolve_addon_dependencies().

◆ chars_equal_insensitive()

bool utils::chars_equal_insensitive ( char  a,
char  b 
)
inline

Definition at line 23 of file general.hpp.

References a, and b.

Referenced by events::menu_handler::do_search(), gui2::dialogs::game_load::filter_text_changed(), mp::game_info::match_string_filter(), and word_completion().

◆ chars_less_insensitive()

bool utils::chars_less_insensitive ( char  a,
char  b 
)
inline

Definition at line 24 of file general.hpp.

References a, and b.

◆ contains()

template<typename Container , typename Value >
bool utils::contains ( const Container &  container,
const Value &  value 
)
inline

Returns true iff value is found in container.

This should work whenever Container "looks like" an STL container of Values. Normally this uses std::find(), but a simulated partial template specialization exists when Value is Container::key_type. In this case, Container is assumed an associative container, and the member function find() is used.

Definition at line 83 of file general.hpp.

References utils::detail::contains_impl< Container, Value >::eval().

Referenced by ai::readonly_context_impl::applies_to_leader(), unit_type::apply_scenario_fix(), BOOST_AUTO_TEST_CASE(), events::menu_handler::can_recruit(), ng::depcheck::manager::change_era(), ng::depcheck::manager::change_modifications(), ng::depcheck::manager::change_scenario(), play_controller::check_next_scenario_is_known(), actions::check_recruit_location(), ng::depcheck::manager::does_conflict(), ng::depcheck::manager::does_require(), gui2::dialogs::addon_manager::get_lang_filter_visibility(), ng::depcheck::manager::get_required_not_enabled(), gui2::dialogs::addon_manager::get_tag_filter_visibility(), gui::scrollarea::handle_event(), editor::palette_manager::handle_event(), controller_base::handle_scroll(), impl_sndsrc_get(), controller_base::long_touch_callback(), display::minimap_location_on(), gui2::dialogs::drop_down_menu::mouse_up_callback(), events::mouse_handler_base::mouse_wheel(), arrow::path_contains(), and events::mouse_handler::touch_motion().

◆ ellipsis_truncate()

void utils::ellipsis_truncate ( std::string &  str,
const std::size_t  size 
)

Truncates a string to a given utf-8 character count and then appends an ellipsis.

Definition at line 952 of file string_utils.cpp.

References font::ellipsis, utf8::size(), and utf8::truncate().

Referenced by windows_tray_notification::adjust_length(), gui2::dialogs::game_load::populate_game_list(), and gui2::dialogs::file_dialog::push_fileview_row().

◆ erase_if()

template<typename Container , typename Predicate >
void utils::erase_if ( Container &  container,
const Predicate &  predicate 
)

Convenience wrapper for using std::remove_if on a container.

todoc++20 use C++20's std::erase_if instead. The C++20 function returns the number of elements removed; this one could do that but it seems unnecessary to add it unless something is using it.

Definition at line 103 of file general.hpp.

Referenced by unit::get_abilities_weapons(), attack_type::get_specials_and_abilities(), attack_type::overwrite_special_overwriter(), unit::resistance_against(), and unit::resistance_value().

◆ escape() [1/2]

std::string utils::escape ( const std::string &  str)
inline

Prepend all special characters with a backslash.

Special characters are: #}+-,*=

Definition at line 330 of file string_utils.hpp.

References escape().

◆ escape() [2/2]

std::string utils::escape ( const std::string &  str,
const char *  special_chars 
)

Prepends a configurable set of characters with a backslash.

Definition at line 415 of file string_utils.cpp.

Referenced by help::escape(), escape(), and get_file_code().

◆ format_conjunct_list()

std::string utils::format_conjunct_list ( const t_string &  empty,
const std::vector< t_string > &  elems 
)

Format a conjunctive list.

Parameters
emptyThe string to return for an empty list
elemsThe list of entries in the list
Returns
The elements of the list joined by "and".

Definition at line 260 of file string_utils.cpp.

References i, and VGETTEXT.

Referenced by unit::describe_builtin_effect(), attack_type::describe_modification(), format_timespan(), lua_stringx::intf_format_list(), events::menu_handler::recruit(), and gui2::multimenu_button::update_label().

◆ format_disjunct_list()

std::string utils::format_disjunct_list ( const t_string &  empty,
const std::vector< t_string > &  elems 
)

Format a disjunctive list.

Parameters
emptyThe string to return for an empty list
elemsThe list of entries in the list
Returns
The elements of the list joined or "and".

Definition at line 278 of file string_utils.cpp.

References i, and VGETTEXT.

Referenced by lua_stringx::intf_format_list().

◆ format_time_summary()

std::string utils::format_time_summary ( std::time_t  t)

Definition at line 24 of file format_time_summary.cpp.

References _(), translation::strftime(), t, and preferences::use_twelve_hour_clock_format().

Referenced by savegame::save_info::format_time_summary().

◆ format_timespan()

std::string utils::format_timespan ( std::time_t  time,
bool  detailed = false 
)

Formats a timespan into human-readable text for player authentication functions.

This is intentionally not a very thorough representation of time intervals. See https://github.com/wesnoth/wesnoth/issues/6036 for more information.

Parameters
timeThe timespan in seconds.
detailedWhether to display more specific values such as "3 months, 2 days, 30 minutes, and 1 second". If not specified or set to false, the return value will ONLY include most significant time unit (e.g. "3 months").
Returns
A human-readable timespan description.
Note
The implementation is not very precise because not all months in the Gregorian calendar have 30 days. Furthermore, it doesn't take into account leap years or leap seconds. If you need to account for those, you are better off importing a new library and providing it with more specific information about the start and end times of the interval; otherwise your next best option is to hire a fortune teller to manually service your requests every time instead of this function.

Definition at line 296 of file string_utils.cpp.

References _(), format_conjunct_list(), N_n, and VNGETTEXT.

Referenced by BOOST_AUTO_TEST_CASE().

◆ from_chars()

template<typename T >
std::optional<T> utils::from_chars ( std::string_view  str,
int  base = 10 
)

Definition at line 22 of file from_chars.hpp.

References _().

◆ get_unknown_exception_type()

std::string utils::get_unknown_exception_type ( )

Utility function for finding the type of thing caught with catch(...).

Not implemented for other compilers at this time.

Returns
For the GCC/clang compilers, the unmangled name of an unknown exception that was caught.

Definition at line 23 of file general.cpp.

Referenced by BOOST_AUTO_TEST_CASE(), events::menu_handler::do_ai_formula(), simple_wml::document::document(), draw_manager::expose(), main(), playsingle_controller::play_ai_turn(), play_controller::play_controller(), playmp_controller::play_human_turn(), playmp_controller::play_idle_loop(), playturn_network_adapter::read_from_network(), wfl::variant::serialize_from_string(), gui2::window::show(), wesnothd_connection::wesnothd_connection(), wesnothd::ban_manager::~ban_manager(), wesnothd::game::~game(), game_display::~game_display(), game_launcher::~game_launcher(), temporary_unit_mover::~temporary_unit_mover(), temporary_unit_placer::~temporary_unit_placer(), temporary_unit_remover::~temporary_unit_remover(), unit::~unit(), and unit_movement_resetter::~unit_movement_resetter().

◆ half_signed_value()

std::string utils::half_signed_value ( int  val)

Sign with Unicode "−" if negative.

Definition at line 501 of file string_utils.cpp.

References font::unicode_minus.

Referenced by carryover_show_gold(), frame_parsed_parameters::debug_strings(), gui2::dialogs::game_stats::pre_show(), and REPORT_GENERATOR().

◆ indent()

std::string utils::indent ( const std::string &  string,
std::size_t  indent_size = 4 
)

Indent a block of text.

Only lines with content are changed; empty lines are left intact. However, if string is an empty string itself, the indentation unit with the specified indent_size will be returned instead.

Parameters
stringText to indent.
indent_sizeNumber of indentation units to use.

Definition at line 759 of file string_utils.cpp.

References draw::line(), and split().

Referenced by bullet_list(), and gui2::dialogs::wml_error::wml_error().

◆ interpolate_variables_into_string() [1/4]

std::string utils::interpolate_variables_into_string ( const std::string &  str,
const std::map< std::string, std::string > *const  symbols 
)

Definition at line 238 of file string_utils.cpp.

References do_interpolation(), and cursor::set().

◆ interpolate_variables_into_string() [2/4]

std::string utils::interpolate_variables_into_string ( const std::string &  str,
const std::map< std::string, t_string > *const  symbols 
)

Function which will interpolate variables, starting with '$' in the string 'str' with the equivalent symbols in the given symbol table.

If 'symbols' is nullptr, then game event variables will be used instead.

Definition at line 232 of file string_utils.cpp.

References do_interpolation(), and cursor::set().

Referenced by play_controller::check_next_scenario_is_known(), savegame::loadgame::check_version_compatibility(), gui2::dialogs::describe_status_verbose(), name_generator::generate(), interpolate_variables_into_tstring(), lua_stringx::intf_format(), map_location::map_location(), game_events::event_handler::names(), campaign_controller::play_game(), terrain_label::read(), play_controller::show_objectives(), playsingle_controller::show_turn_dialog(), gui2::styled_widget::signal_handler_show_tooltip(), vgettext_impl(), and vngettext_impl().

◆ interpolate_variables_into_string() [3/4]

std::string utils::interpolate_variables_into_string ( const std::string &  str,
const std::map< std::string, t_string > *const  symbols 
)

Function which will interpolate variables, starting with '$' in the string 'str' with the equivalent symbols in the given symbol table.

If 'symbols' is nullptr, then game event variables will be used instead.

Definition at line 232 of file string_utils.cpp.

References do_interpolation(), and cursor::set().

Referenced by play_controller::check_next_scenario_is_known(), savegame::loadgame::check_version_compatibility(), gui2::dialogs::describe_status_verbose(), name_generator::generate(), interpolate_variables_into_tstring(), lua_stringx::intf_format(), map_location::map_location(), game_events::event_handler::names(), campaign_controller::play_game(), terrain_label::read(), play_controller::show_objectives(), playsingle_controller::show_turn_dialog(), gui2::styled_widget::signal_handler_show_tooltip(), vgettext_impl(), and vngettext_impl().

◆ interpolate_variables_into_string() [4/4]

std::string utils::interpolate_variables_into_string ( const std::string &  str,
const variable_set &  variables 
)

Definition at line 244 of file string_utils.cpp.

References do_interpolation().

◆ interpolate_variables_into_tstring()

t_string utils::interpolate_variables_into_tstring ( const t_string &  str,
const variable_set &  variables 
)

Function that does the same as the above, for t_stringS.

If a change was made, then the t_string's translation is done in this function, rather than at use. This limitation is due to the use of create-time interpolation, rather than use-time.

Definition at line 249 of file string_utils.cpp.

References interpolate_variables_into_string(), and t_string::str().

Referenced by lua_stringx::intf_format(), and terrain_label::read().

◆ is_username_char()

static bool utils::is_username_char ( char  c)
static

Definition at line 606 of file string_utils.cpp.

References c.

Referenced by isvalid_username(), and isvalid_wildcard().

◆ is_wildcard_char()

static bool utils::is_wildcard_char ( char  c)
static

Definition at line 610 of file string_utils.cpp.

References c.

Referenced by isvalid_wildcard().

◆ is_word_boundary()

static bool utils::is_word_boundary ( char  c)
static

Definition at line 688 of file string_utils.cpp.

References c.

Referenced by word_match().

◆ isnewline()

bool utils::isnewline ( const char  c)

Definition at line 41 of file string_utils.cpp.

References c.

Referenced by gui::textbox::append_text(), gui::textbox::handle_key_down(), portable_isspace(), t_translation::read_builder_map(), and t_translation::read_game_map().

◆ isvalid_username()

bool utils::isvalid_username ( const std::string &  login)

Check if the username contains only valid characters.

(all alpha-numeric characters plus underscore and hyphen)

Definition at line 614 of file string_utils.cpp.

References is_username_char().

Referenced by wesnothd::server::is_login_allowed(), and wesnothd::server::status_handler().

◆ isvalid_wildcard()

bool utils::isvalid_wildcard ( const std::string &  login)

Check if the username pattern contains only valid characters.

(all alpha-numeric characters plus underscore, hyphen, question mark and asterisk)

Definition at line 626 of file string_utils.cpp.

References is_username_char(), and is_wildcard_char().

Referenced by preferences::add_acquaintance().

◆ join()

template<typename T >
std::string utils::join ( const T &  v,
const std::string &  s = "," 
)

Generates a new string joining container items in a list.

Parameters
vA container with elements.
sList delimiter.

Definition at line 204 of file string_utils.hpp.

References i, and s.

Referenced by schema_validation::schema_validator::active_tag_path(), mp::add_multiplayer_classification(), gui2::dialogs::add_unit_entry(), aes_decrypt(), aes_encrypt(), team::allied_human_teams(), attack_info(), BOOST_AUTO_TEST_CASE(), ng::depcheck::manager::change_era(), ng::depcheck::manager::change_scenario(), gui2::chatbox::chat_input_keypress_callback(), addons_client::connect(), gui2::dialogs::editor_edit_pbl::create_cfg(), schema_validation::schema_self_validator::current_path(), gui2::dialogs::depcheck_confirm_change::depcheck_confirm_change(), saved_game::expand_mp_events(), campaignd::control_line::full(), ai::holder::get_ai_overview(), preferences::get_ignored_delim(), hotkey::get_names(), carryover::get_recruits(), wesnothd::server::handle_join_game(), wesnothd::server::handle_player_in_game(), wesnothd::server::handle_player_in_lobby(), campaignd::server::handle_server_id(), events::map_command_handler< Worker >::help_command(), impl_mp_settings_get(), impl_namedtuple_tostring(), impl_source_set(), game_lua_kernel::intf_add_tile_overlay(), lua_stringx::intf_str_join(), terrain_type_data::lazy_initialization(), game_config_manager::load_addons_cfg(), game_config_manager::load_game_config(), gui2::dialogs::editor_edit_unit::load_unit_type(), wesnothd::server::login_client(), gui2::dialogs::faction_select::on_faction_select(), ai::leader_aspects_visitor::operator()(), gui2::dialogs::end_credits::pre_show(), gui2::dialogs::terrain_layers::pre_show(), gui2::dialogs::unit_list::pre_show(), read_event_name(), gui2::unit_preview_pane::set_displayed_unit(), preferences::set_modifications(), gui::floating_textbox::tab(), schema_validation::schema_self_validator::tag_path_exists(), editor::map_context::to_config(), ai::default_recruitment::recruit_job::to_config(), ai::default_recruitment::recruit_limit::to_config(), game_classification::to_config(), carryover::transfer_all_recruits_to(), unit_helper::unit_level_tooltip(), gui2::dialogs::end_credits::update(), gui2::dialogs::mp_match_history::update_display(), addons_client::upload_addon(), gui2::dialogs::editor_edit_pbl::validate(), campaignd::server::validate_addon(), ai::config_value_translator< std::vector< std::string > >::value_to_cfg(), addon_info::write(), team::team_info::write(), unit::write(), game_events::manager::write_events(), addon_info::write_minimal(), game_data::write_snapshot(), statistics_record::write_str_int_map(), and preferences::manager::~manager().

◆ join_map()

template<typename T >
std::string utils::join_map ( const T &  v,
const std::string &  major = ",",
const std::string &  minor = ":" 
)

Definition at line 219 of file string_utils.hpp.

References i.

Referenced by impl_mp_settings_get(), lua_stringx::intf_str_join_map(), ng::connect_engine::save_reserved_sides_information(), and mp_game_settings::to_config().

◆ make_shared_reference()

template<typename T , typename... Types>
shared_reference<T> utils::make_shared_reference ( Types &&...  args)

Definition at line 84 of file shared_reference.hpp.

◆ map_split()

std::map< std::string, std::string > utils::map_split ( const std::string &  val,
char  major = ',',
char  minor = ':',
int  flags = REMOVE_EMPTY|STRIP_SPACES,
const std::string &  default_value = "" 
)

Splits a string based on two separators into a map.

Major: the separator between elements of the map Minor: the separator between keys and values in one element

For example, the string 'a:b,c:d,e:f' would be parsed into: a => b c => d e => f

Definition at line 279 of file string_utils.cpp.

References i, and split().

Referenced by BOOST_AUTO_TEST_CASE(), lua_stringx::intf_str_map_split(), ng::connect_engine::load_previous_sides_users(), and ng::connect_engine::save_reserved_sides_information().

◆ might_contain_variables()

bool utils::might_contain_variables ( const std::string &  str)
inline

Determines if a string might contain variables to interpolate.

This can allow one to skip future interpolations (plural – if there is only one interpolation, the savings are not worth this check). In this spirit, precision is sacrificed in the name of efficiency; the check is quick and allows false positives, but there are no false negatives. (A false negative would lead to incorrect behavior, whereas a false positive leads to merely inefficient behavior.) In practice, false positives should be uncommon enough to not worry about.

Definition at line 45 of file string_utils.hpp.

Referenced by game_events::event_handlers::finish_adding_event_handler(), and game_events::event_handler::names().

◆ notspace()

bool utils::notspace ( const char  c)

Definition at line 58 of file string_utils.cpp.

References c, and portable_isspace().

◆ operator!=()

bool utils::operator!= ( const irdya_date &  a,
const irdya_date &  b 
)

Definition at line 121 of file irdya_datetime.cpp.

References a, and b.

◆ operator<()

bool utils::operator< ( const irdya_date &  a,
const irdya_date &  b 
)

Definition at line 75 of file irdya_datetime.cpp.

References a, and b.

◆ operator<<() [1/2]

template<typename... OpTimerArgs>
std::ostream& utils::operator<< ( std::ostream &  o,
const optimer< OpTimerArgs... > &  tm 
)
inline

Formats time elapsed for writing to a stream.

Note
The resulting output does not include a time unit suffix.

Definition at line 96 of file optimer.hpp.

References utils::optimer< ResolutionType, ClockType >::elapsed(), and preferences::resolution().

◆ operator<<() [2/2]

std::ostream & utils::operator<< ( std::ostream &  s,
const irdya_date &  d 
)

Definition at line 126 of file irdya_datetime.cpp.

References d, and s.

◆ operator<=()

bool utils::operator<= ( const irdya_date &  a,
const irdya_date &  b 
)

Definition at line 106 of file irdya_datetime.cpp.

References a, and b.

◆ operator==()

bool utils::operator== ( const irdya_date &  a,
const irdya_date &  b 
)

Definition at line 116 of file irdya_datetime.cpp.

References a, and b.

◆ operator>()

bool utils::operator> ( const irdya_date &  a,
const irdya_date &  b 
)

Definition at line 101 of file irdya_datetime.cpp.

References a, and b.

◆ operator>=()

bool utils::operator>= ( const irdya_date &  a,
const irdya_date &  b 
)

Definition at line 111 of file irdya_datetime.cpp.

References a, and b.

◆ parenthetical_split()

std::vector< std::string > utils::parenthetical_split ( std::string_view  val,
const char  separator = 0,
std::string_view  left = "(",
std::string_view  right = ")",
const int  flags = REMOVE_EMPTY|STRIP_SPACES 
)

Splits a string based either on a separator, except then the text appears within specified parenthesis.

If the separator is "0" (default), it splits a string into an odd number of parts:

  • The part before the first '(',
  • the part between the first '('
  • and the matching right ')', etc ... and the remainder of the string.

Note that one can use the same character for both the left and right parenthesis, which usually makes the most sense for this function.

Note that this will find the first matching char in the left string and match against the corresponding char in the right string. A correctly processed string should return a vector with an odd number of elements. Empty elements are never removed as they are placeholders, hence REMOVE EMPTY only works for the separator split.

INPUT: ("a(b)c{d}e(f{g})h", 0, "({", ")}") RETURNS: {"a", "b", "c", "d", "e", "f{g}", "h"}

Definition at line 310 of file string_utils.cpp.

References ERR_GENERAL, i, portable_isspace(), REMOVE_EMPTY, STRIP_SPACES, and trim().

Referenced by unit::apply_builtin_effect(), BOOST_AUTO_TEST_CASE(), image::modification::decode(), wfl::string_callable::get_value(), unit::init(), ai::manager::internal_evaluate_command(), intf_name_generator(), lua_stringx::intf_str_paren_split(), lua_stringx::intf_str_split(), and image::load_image_sub_file().

◆ parse_range()

std::pair< int, int > utils::parse_range ( const std::string &  str)

Recognises the following patterns, and returns a {min, max} pair.

  • "1" returns {1, 1}
  • "1-3" returns {1, 3}
  • "1-infinity" returns {1, maximum int}
  • "-1" returns {-1, -1}
  • "-3--1" returns {-3, -1}

Note that:

  • "3-1" returns {3, 3} and does not log an error
  • "-1--3" returns {-1, -1} and does not log an error
  • Although "-infinity--1", "2-infinity" and "-infinity-infinity" are all supported,
  • ranges that can't match a reasonable number, e.g. "-infinity" or "infinity..infinity", may be treated as errors.

Definition at line 859 of file string_utils.cpp.

References a, b, and ERR_GENERAL.

Referenced by lua_stringx::intf_parse_range(), ai::readonly_context_impl::is_active(), map_location::matches_range(), gamemap_base::parse_location_range(), and parse_ranges_int().

◆ parse_range_real()

std::pair< double, double > utils::parse_range_real ( const std::string &  str)

Recognises similar patterns to parse_range, and returns a {min, max} pair.

For this function, "infinity" results in std::numeric_limits<double>::infinity.

Definition at line 889 of file string_utils.cpp.

References a, b, and ERR_GENERAL.

Referenced by lua_stringx::intf_parse_range(), and parse_ranges_real().

◆ parse_ranges_int()

std::vector< std::pair< int, int > > utils::parse_ranges_int ( const std::string &  str)

Handles a comma-separated list of inputs to parse_range.

Definition at line 942 of file string_utils.cpp.

References parse_range(), and split().

Referenced by utils::config_filters::int_matches_if_present(), utils::config_filters::int_matches_if_present_or_negative(), matches_simple_filter(), and parse_ranges_unsigned().

◆ parse_ranges_real()

std::vector< std::pair< double, double > > utils::parse_ranges_real ( const std::string &  str)

Definition at line 932 of file string_utils.cpp.

References parse_range_real(), and split().

Referenced by utils::config_filters::double_matches_if_present().

◆ parse_ranges_unsigned()

std::vector< std::pair< int, int > > utils::parse_ranges_unsigned ( const std::string &  str)

Handles a comma-separated list of inputs to parse_range, in a context that does not expect negative values.

Will return an empty list if any of the ranges have a minimum that's below zero.

Definition at line 921 of file string_utils.cpp.

References ERR_GENERAL, and parse_ranges_int().

Referenced by unit::ability_active(), check_side_number(), game_events::builtin_conditions::have_location(), game_events::builtin_conditions::have_unit(), terrain_filter::match_internal(), matches_simple_filter(), attack_type::special_active_impl(), and utils::config_filters::unsigned_matches_if_present().

◆ portable_isspace()

bool utils::portable_isspace ( const char  c)

Definition at line 48 of file string_utils.cpp.

References c, and isnewline().

Referenced by preprocessor_data::get_chunk(), notspace(), parenthetical_split(), preprocessor_data::read_word(), and square_parenthetical_split().

◆ print_modifier()

std::string utils::print_modifier ( const std::string &  mod)
inline

Add a "+" or replace the "-" par Unicode minus.

Definition at line 316 of file string_utils.hpp.

References font::unicode_minus.

Referenced by unit::describe_builtin_effect(), and attack_type::describe_modification().

◆ quote()

std::string utils::quote ( const std::string &  str)
inline

Surround the string 'str' with double quotes.

Definition at line 342 of file string_utils.hpp.

Referenced by quoted_split().

◆ quoted_split()

std::vector< std::string > utils::quoted_split ( const std::string &  val,
char  c = ',',
int  flags = REMOVE_EMPTY|STRIP_SPACES,
char  quote = '\\' 
)

This function is identical to split(), except it does not split when it otherwise would if the previous character was identical to the parameter 'quote' (i.e.

it does not split quoted commas). This method was added to make it possible to quote user input, particularly so commas in user input would not cause visual problems in menus.

Todo:
Why not change split()? That would change the methods post condition.

Definition at line 792 of file string_utils.cpp.

References c, quote(), REMOVE_EMPTY, STRIP_SPACES, and trim().

Referenced by BOOST_AUTO_TEST_CASE(), help::generate_contents_links(), preprocessor_data::get_chunk(), preprocessor_streambuf::get_current_file(), get_location(), lua_stringx::intf_str_split(), lineno_string(), help::parse_config_internal(), help::section_is_referenced(), and help::topic_is_referenced().

◆ reversed_view()

template<typename T >
auto utils::reversed_view ( T &  container)
inline

Definition at line 28 of file ranges.hpp.

Referenced by game_data::activate_scope_variable(), gui2::event::implementation::fire_event(), events::sdl_handler::join_same(), gui2::event::sdl_event_handler::keyboard_dispatcher(), events::sdl_handler::leave(), gui2::event::sdl_event_handler::mouse(), events::sdl_handler::operator=(), wb::mapbuilder::post_visit_team(), quit_confirmation::quit(), ai::composite_aspect< T >::recalculate(), wb::mapbuilder::restore_normal_map(), events::sdl_handler::sdl_handler(), wb::highlighter::set_mouseover_hex(), gui2::event::sdl_event_handler::touch_down(), gui2::event::sdl_event_handler::touch_motion(), gui2::event::sdl_event_handler::touch_multi_gesture(), and gui2::event::sdl_event_handler::touch_up().

◆ si_string()

std::string utils::si_string ( double  input,
bool  base2,
const std::string &  unit 
)

Convert into a string with an SI-postfix.

If the unit is to be translatable, a t_string should be passed as the third argument. _("unit_byte^B") is suggested as standard.

There are no default values because they would not be translatable.

Definition at line 539 of file string_utils.cpp.

References _(), si_string_impl_stream_write(), and font::unicode_minus.

Referenced by gui2::dialogs::network_transmission::pump_monitor::process(), gui2::dialogs::screenshot_notification::save_screenshot(), size_display_string(), and gui2::dialogs::game_cache_options::update_cache_size_display().

◆ si_string_impl_stream_write()

static void utils::si_string_impl_stream_write ( std::stringstream &  ss,
double  input 
)
static

Definition at line 510 of file string_utils.cpp.

Referenced by si_string().

◆ signed_percent()

std::string utils::signed_percent ( int  val)
inline

Convert into a percentage (using the Unicode "−" and +0% convention.

Definition at line 360 of file string_utils.hpp.

References signed_value().

Referenced by attack_type::accuracy_parry_description(), attack_info(), gui2::get_hp_tooltip(), gui2::dialogs::attack_predictions::set_data(), time_of_day_at(), unit_alignment(), unit_box_at(), and unit_hp().

◆ signed_value()

std::string utils::signed_value ( int  val)

Convert into a signed value (using the Unicode "−" and +0 convention.

Definition at line 494 of file string_utils.cpp.

References font::unicode_minus.

Referenced by attack_info(), gui2::dialogs::game_stats::pre_show(), and signed_percent().

◆ sort_if()

template<typename Container , typename Predicate >
void utils::sort_if ( Container &  container,
const Predicate &  predicate 
)

Convenience wrapper for using std::sort on a container.

Definition at line 113 of file general.hpp.

Referenced by attack_type::overwrite_special_overwriter().

◆ split() [1/2]

std::vector< std::string > utils::split ( const config_attribute_value &  val)

Definition at line 448 of file config_attribute_value.cpp.

References config_attribute_value::str().

Referenced by preferences::achievement(), halo::halo_impl::add(), unit_animation::add_anims(), game_config::add_color_info(), terrain_builder::add_images_from_config(), name_generator_factory::add_name_generator_from_config(), terrain_builder::add_rotated_rules(), schema_validation::wml_tag::add_switch(), ng::flg_manager::append_leaders_from_faction(), unit::apply_builtin_effect(), attack_type::apply_modification(), unit_type::apply_scenario_fix(), BOOST_AUTO_TEST_CASE(), unit_type::build_created(), unit_type::build_help_index(), team::calculate_is_enemy(), ai::config_value_translator< utils::variant< bool, std::vector< std::string > > >::cfg_to_value(), ai::config_value_translator< std::vector< std::string > >::cfg_to_value(), schema_validation::schema_self_validator::check_for_duplicates(), game_events::event_handlers::clean_up_expired_handlers(), game_config::color_info(), campaignd::command_line::command_line(), commandline_options::commandline_options(), addons_client::connect(), savegame::convert_old_saves_1_13_1(), ai::default_recruitment::recruitment_aspect::create_job(), ai::default_recruitment::recruitment_aspect::create_limit(), events::menu_handler::custom_command(), default_map_generator_job::default_generate_map(), events::menu_handler::do_search(), events::console_handler::do_unit(), ng::depcheck::manager::does_conflict(), ng::depcheck::manager::does_require(), display::draw_hex(), gui2::dialogs::game_load::evaluate_summary_string(), schema_validation::wml_tag::expand(), combatant::fight(), unit_filter_impl::unit_filter_compound::fill(), terrain_filterimpl::filter_special_loc(), gui2::dialogs::campaign_selection::filter_text_changed(), gui2::dialogs::game_load::filter_text_changed(), gui2::dialogs::log_settings::filter_text_changed(), gui2::dialogs::unit_create::filter_text_changed(), gui2::dialogs::unit_recall::filter_text_changed(), gui2::dialogs::unit_recruit::filter_text_changed(), unit_creator::find_location(), ng::flg_manager::find_suitable_faction(), color_t::from_rgb_string(), color_t::from_rgba_string(), gui2::dialogs::mp_lobby::game_filter_init(), cave_map_generator::cave_map_generator_job::generate_chambers(), help::generate_faction_topics(), help::generate_sections(), help::generate_topic_text(), help::generate_topics(), unit::generate_traits(), ai::unit_advancements_aspect::get_advancements(), preprocessor_data::get_chunk(), filesystem::get_localized_path(), terrain_filter::get_locs_impl(), unit::get_modification_advances(), gui2::dialogs::addon_manager::get_name_filter_visibility(), ai::default_recruitment::recruitment::get_random_pattern_type_if_exists(), ng::depcheck::manager::get_required(), wfl::string_callable::get_value(), get_variations(), wesnothd::server::handle_create_game(), campaignd::server::handle_read_from_fifo(), campaignd::server::handle_upload(), gui2::dialogs::preferences_dialog::hotkey_filter_callback(), game_lua_kernel::impl_game_config_get(), game_lua_kernel::impl_scenario_get(), impl_source_get(), indent(), unit::init(), display::init_flags_for_side_internal(), game_lua_kernel::intf_clear_menu_item(), intf_name_generator(), lua_stringx::intf_str_split(), ai::readonly_context_impl::is_active(), terrain_type_data::lazy_initialization(), ai::default_recruitment::recruitment::leader_matches_job(), ai::default_recruitment::recruitment::limit_ok(), campaignd::server::load_config(), wesnothd::server::load_config(), game_config::load_config(), preferences::load_credentials(), preferences::load_game_prefs(), terrain_builder::load_images(), map_split(), terrain_filter::match_internal(), side_filter::match_internal(), matches_ability_filter(), map_location::matches_range(), matches_simple_filter(), theme::menu::menu(), theme::object::modify_location(), unit_type::musthave_status(), schema_validation::schema_self_validator::name_matches(), game_events::event_handler::names(), ai::formula_ai::on_create(), gui2::dialogs::faction_select::on_faction_select(), help::unit_topic_generator::operator()(), terrain_builder::parse_config(), map_location::parse_directions(), wesnothd::parse_ip(), gamemap_base::parse_location_range(), commandline_options::parse_log_domains_(), parse_ranges_int(), parse_ranges_real(), commandline_options::parse_resolution_(), campaignd::blacklist::parse_str_to_globlist(), commandline_options::parse_to_uint_string_string_tuples_(), commandline_options::parse_to_uint_string_tuples_(), gui2::dialogs::addon_auth::pre_show(), gui2::dialogs::editor_edit_pbl::pre_show(), gui2::dialogs::end_credits::pre_show(), ng::create_engine::prepare_for_campaign(), team_builder::previous_recruits(), playmp_controller::process_oos(), progressive_pair< T >::progressive_pair(), progressive_single< T >::progressive_single(), addon_info::read(), team::team_info::read(), gui2::implementation::read_flags(), unit_type_data::read_hide_help(), read_locations(), read_rect(), game_events::manager::read_scenario(), statistics_record::read_str_int_map(), ai::default_recruitment::recruitment::recruit_matches_job(), unit_type::remove_scenario_fixes(), unit_type::resistance_filter_matches(), unit::resistance_filter_matches(), sound::music_track::resolve(), ng::flg_manager::resolve_random(), tod_manager::resolve_random(), resolve_rect(), terrain_builder::rule_image_variant::rule_image_variant(), game_lua_kernel::run_filter(), preferences::set_achievement(), gui::button::set_label(), preferences::set_sub_achievement(), editor::terrain_palette::setup(), show_deprecated_warnings(), square_parenthetical_split(), utils::config_filters::string_matches_if_present(), preferences::sub_achievement(), SYNCED_COMMAND_HANDLER_FUNCTION(), schema_validation::schema_self_validator::tag_path_exists(), game_config::tc_info(), unit_animation::unit_animation(), gui2::dialogs::mp_match_history::update_display(), schema_validation::schema_validator::validate(), campaignd::server::validate_addon(), schema_validation::schema_validator::validate_key(), schema_validation::schema_self_validator::validate_key(), version_info::version_info(), and game_events::WML_HANDLER_FUNCTION().

◆ split() [2/2]

std::vector< std::string > utils::split ( std::string_view  s,
const char  sep,
const int  flags 
)

Splits a (comma-)separated string into a vector of pieces.

Parameters
[in]sA (comma-)separated string.
[in]sepThe separator character (usually a comma).
[in]flagsFlags controlling how the split is done. This is a bit field with two settings (both on by default): REMOVE_EMPTY causes empty pieces to be skipped/removed. STRIP_SPACES causes the leading and trailing spaces of each piece to be ignored/stripped.

Definition at line 83 of file string_utils.cpp.

References s, and split_foreach().

◆ split_foreach()

template<typename F >
void utils::split_foreach ( std::string_view  s,
char  sep,
const int  flags,
const F &  f 
)

Definition at line 84 of file string_utils.hpp.

References f, REMOVE_EMPTY, s, split_foreach_impl(), STRIP_SPACES, and trim().

Referenced by register_widget_attribute(), split(), split_set(), and split_view().

◆ split_foreach_impl()

template<typename F >
void utils::split_foreach_impl ( std::string_view  s,
char  sep,
const F &  f 
)

Definition at line 66 of file string_utils.hpp.

References f, and s.

Referenced by split_foreach().

◆ split_set()

std::set< std::string > utils::split_set ( std::string_view  s,
char  sep,
const int  flags 
)

Definition at line 92 of file string_utils.cpp.

References s, and split_foreach().

Referenced by utils::config_filters::bool_or_empty(), preferences::load_game_prefs(), editor::map_context::load_scenario(), matches_simple_filter(), and editor::map_context::set_side_setup().

◆ split_view()

std::vector< std::string_view > utils::split_view ( std::string_view  s,
const char  sep,
const int  flags 
)

Definition at line 101 of file string_utils.cpp.

References s, and split_foreach().

◆ square_parenthetical_split()

std::vector< std::string > utils::square_parenthetical_split ( const std::string &  val,
const char  separator = ',',
const std::string &  left = "([",
const std::string &  right = ")]",
const int  flags = REMOVE_EMPTY|STRIP_SPACES 
)

Similar to parenthetical_split, but also expands embedded square brackets.

Notes:

  • The Separator must be specified and number of entries in each square bracket must match in each section.
  • Leading zeros are preserved if specified between square brackets.
  • An asterisk as in [a*n] indicates to expand 'a' n times

This is useful for expanding animation WML code.

Examples:

INPUT: ("a[1~3](1,[5,6,7]),b[8,9]", ",") RETURNS: {"a1(1,5)", "a2(1,6)", "a3(1,7)", "b8", "b9"}

INPUT: ("abc[07~10]") RETURNS: {"abc07", "abc08", "abc09", "abc10"}

INPUT: ("a[1,2]b[3~4]:c[5,6]") RETURNS: {"a1b3:c5", "a2b4:c6"}

INPUT: ("abc[3~1].png") RETURNS: {"abc3.png", "abc2.png", "abc1.png"}

INPUT: ("abc[3,1].png") RETURNS: {"abc3.png", "abc1.png"}

INPUT: ("abc[de,xyz]") RETURNS: {"abcde", "abcxyz"}

INPUT: ("abc[1*3]") RETURNS: {"abc1", "abc1", "abc1"}

Definition at line 110 of file string_utils.cpp.

References ERR_GENERAL, i, p, portable_isspace(), REMOVE_EMPTY, split(), STRIP_SPACES, and trim().

Referenced by halo::halo_impl::add(), terrain_builder::add_constraints(), BOOST_AUTO_TEST_CASE(), display::init_flags_for_side_internal(), lua_stringx::intf_str_split(), terrain_builder::load_images(), pick_one(), and progressive_single< T >::progressive_single().

◆ string_bool()

bool utils::string_bool ( const std::string &  str,
bool  def 
)

Convert no, false, off, 0, 0.0 to false, empty to def, and others to true.

Definition at line 474 of file string_utils.cpp.

Referenced by gui2::typed_formula< T >::convert(), campaignd::server::handle_read_from_fifo(), tod_manager::is_start_ToD(), and gui2::styled_widget::set_members().

◆ to_sql_wildcards()

void utils::to_sql_wildcards ( std::string &  str,
bool  underscores = true 
)

Converts '*' to '' and optionally escapes '_'.

Parameters
strThe original string.
underscoresWhether to escape underscore characters as well.

Definition at line 745 of file string_utils.cpp.

References n.

Referenced by wesnothd::server::searchlog_handler().

◆ trim()

void utils::trim ( std::string_view &  s)

Definition at line 63 of file string_utils.cpp.

References s.

Referenced by append_special_note(), wesnothd::server::ban_handler(), wesnothd::server::bans_handler(), context_free_grammar_generator::context_free_grammar_generator(), game_config::dist_channel_id(), display::draw_hex(), wesnothd::server::gban_handler(), events::cmd_arg_parser::get_data(), editor::get_map_location(), lua_stringx::intf_str_trim(), wesnothd::server::kickban_handler(), parenthetical_split(), preferences::password(), wesnothd::server::pm_handler(), wesnothd::server::process_command(), quoted_split(), read_ignore_patterns(), preferences::set_login(), preferences::set_password(), split_foreach(), square_parenthetical_split(), game_events::event_handlers::standardize_name(), t_translation::string_to_number_(), and version_info::version_info().

◆ unescape()

std::string utils::unescape ( const std::string &  str)

Remove all escape characters (backslash)

Definition at line 430 of file string_utils.cpp.

◆ urlencode()

std::string utils::urlencode ( const std::string &  str)

Percent-escape characters in a UTF-8 string intended to be part of a URL.

Definition at line 445 of file string_utils.cpp.

References c.

Referenced by campaignd::format_addon_feedback_url().

◆ variant_index()

template<typename... Types>
std::size_t utils::variant_index ( const variant< Types... > &  var)

Definition at line 80 of file variant.hpp.

◆ wildcard_string_match()

bool utils::wildcard_string_match ( const std::string &  str,
const std::string &  match 
)

Match using '*' as any number of characters (including none), '+' as one or more characters, and '?' as any one character.

Definition at line 704 of file string_utils.cpp.

References i.

Referenced by wesnothd::server::ban_handler(), BOOST_AUTO_TEST_CASE(), game_config::config_cache::delete_cache_files(), schema_validation::wml_tag::find_key(), schema_validation::wml_tag::find_tag(), wesnothd::server::gban_handler(), campaignd::server::ignore_address_stats(), campaignd::blacklist::ip_matches(), campaignd::blacklist::is_in_globlist(), wesnothd::server::is_login_allowed(), wesnothd::server::kick_handler(), wesnothd::server::kickban_handler(), wesnothd::server::login_client(), filesystem::looks_like_pbl(), filesystem::blacklist_pattern_list::match_dir(), filesystem::blacklist_pattern_list::match_file(), config::matches(), schema_validation::schema_self_validator::name_matches(), wesnothd::server::searchlog_handler(), and wesnothd::server::status_handler().

◆ word_completion()

bool utils::word_completion ( std::string &  text,
std::vector< std::string > &  wordlist 
)

Try to complete the last word of 'text' with the 'wordlist'.

Parameters
[in,out]textThe parameter's usage is:
  • Input: Text where we try to complete the last word of.
  • Output: Text with completed last word.
[in,out]wordlistThe parameter's usage is:
  • Inout: A vector of strings to complete against.
  • Output: A vector of strings that matched 'text'.
Return values
trueiff text is just one word (no spaces)

Definition at line 641 of file string_utils.cpp.

References chars_equal_insensitive().

Referenced by gui2::chatbox::chat_input_keypress_callback(), gui2::dialogs::lua_interpreter::controller::tab(), and gui::floating_textbox::tab().

◆ word_match()

bool utils::word_match ( const std::string &  message,
const std::string &  word 
)

Check if a message contains a word.

Definition at line 692 of file string_utils.cpp.

References is_word_boundary().

Referenced by display_chat_manager::add_chat_message(), and gui2::chatbox::add_chat_room_message_received().

Variable Documentation

◆ decayed_is_same

template<typename T1 , typename T2 >
constexpr bool utils::decayed_is_same = std::is_same_v<std::decay_t<T1>, std::decay_t<T2>>
inlineconstexpr

Equivalent to as std::is_same_v except both types are passed through std::decay first.

Template Parameters
T1The first type to compare.
T2The second type to compare.

Definition at line 33 of file general.hpp.

Referenced by advance_unit(), ai::readonly_context_impl::applies_to_leader(), wesnothd::server::disconnect_player(), ai::lua_object< T >::from_type(), log_address(), and server_base::serve().

◆ dependent_false_v

template<typename >
constexpr bool utils::dependent_false_v = false
inlineconstexpr

Workaround for the fact that static_assert(false) is invalid.

See https://devblogs.microsoft.com/oldnewthing/20200311-00/?p=103553

Definition at line 40 of file general.hpp.

Referenced by gui2::event::dispatcher::get_signal_queue().

◆ res_order

const std::vector<std::string> utils::res_order = {"blade", "pierce", "impact", "fire", "cold", "arcane"}

Definition at line 37 of file string_utils.hpp.

Referenced by utils::res_compare::operator()().

Generated by doxygen 1.9.1