Functions for converting Unicode wide-char strings to UTF-8 encoded strings, back and forth. More...
Classes | |
class | invalid_utf8_exception |
Thrown by operations encountering invalid UTF-8 data. More... | |
Typedefs | |
typedef ucs4::iterator_base< std::string, ucs4_convert_impl::convert_impl< char >::type > | iterator |
Functions | |
static int | byte_size_from_utf8_first (const unsigned char ch) |
std::string | lowercase (const std::string &s) |
Returns a lowercased version of the string. More... | |
std::size_t | index (const std::string &str, const std::size_t index) |
Codepoint index corresponding to the nth character in a UTF-8 string. More... | |
std::size_t | size (const std::string &str) |
Length in characters of a UTF-8 string. More... | |
std::string & | insert (std::string &str, const std::size_t pos, const std::string &insert) |
Insert a UTF-8 string at the specified position. More... | |
std::string & | erase (std::string &str, const std::size_t start, const std::size_t len=std::string::npos) |
Erases a portion of a UTF-8 string. More... | |
std::string & | truncate (std::string &str, const std::size_t size) |
Truncates a UTF-8 string to the specified number of characters. More... | |
void | truncate_as_ucs4 (std::string &str, const std::size_t size) |
Truncates a UTF-8 string to the specified number of characters. More... | |
Functions for converting Unicode wide-char strings to UTF-8 encoded strings, back and forth.
typedef ucs4::iterator_base<std::string, ucs4_convert_impl::convert_impl<char>::type> utf8::iterator |
Definition at line 42 of file unicode.hpp.
|
static |
Definition at line 37 of file unicode.cpp.
References count_leading_ones().
std::string & utf8::erase | ( | std::string & | str, |
const std::size_t | start, | ||
const std::size_t | len = std::string::npos |
||
) |
Erases a portion of a UTF-8 string.
str | UTF-8 encoded string. |
start | Start position. |
len | Number of characters to erase. |
Definition at line 105 of file unicode.cpp.
References index(), and size().
Referenced by gui2::password_box::delete_selection(), gui2::text_box::delete_selection(), and truncate().
std::size_t utf8::index | ( | const std::string & | str, |
const std::size_t | index | ||
) |
Codepoint index corresponding to the nth character in a UTF-8 string.
index
characters. Definition at line 72 of file unicode.cpp.
References byte_size_from_utf8_first(), ERR_GENERAL, and i.
Referenced by pathfind::a_star_search(), unit::ability_active(), display::action_pressed(), actions::actor_sighted(), gui2::tree_view_node::add_child(), simple_wml::node::add_child_at(), config::add_child_at(), config::add_child_at_total(), gui2::tree_view_node::add_child_impl(), gui2::tree_view_node::add_sibling(), simple_wml::node::apply_diff(), config::apply_diff(), simple_wml::node::attr(), BOOST_AUTO_TEST_CASE(), team::calculate_enemies(), team::calculate_is_enemy(), editor::editor_controller::can_execute_command(), play_controller::hotkey_handler::can_execute_command(), ai::cfun_ai_get_suitable_keep(), config::child(), wesnothd::server::cleanup_game(), config::clear_diff_track(), persist_file_context::clear_var(), gui2::chatbox::close_window_button_callback(), ng::connect_engine::connect_engine(), gui2::text_box_base::copy_selection(), gui2::generator< minimum_selection, maximum_selection, my_placement, select_action >::create_item(), gui2::dialogs::unit_attack::damage_calc_callback(), gui2::dialogs::game_load::delete_button_callback(), gui2::generator< minimum_selection, maximum_selection, my_placement, select_action >::delete_item(), gui2::dialogs::unit_recall::dismiss_unit(), events::map_command_handler< chat_command_handler >::dispatch(), editor::editor_controller::do_execute_command(), play_controller::hotkey_handler::do_execute_command(), erase(), gui::menu::erase_item(), gui2::dialogs::game_load::execute(), gui2::dialogs::mp_join_game::fetch_game_config(), pathfind::find_routes(), ng::flg_manager::find_suitable_faction(), mapgen_gamemap::for_each_loc(), t_translation::ter_map::get(), play_controller::hotkey_handler::get_action_image(), editor::editor_controller::get_action_state(), hotkey::command_executor::get_action_state(), tod_manager::get_area_by_index(), gui2::styled_widget::get_canvas(), gui2::tree_view_node::get_child_at(), font::pango_text::get_column_line(), tod_manager::get_current_area_time(), image::cache_type< T >::get_element(), gui2::generator< minimum_selection, maximum_selection, my_placement, select_action >::get_item_shown(), wb::side_actions::get_numbers(), gui2::generator< minimum_selection, maximum_selection, my_placement, select_action >::get_ordered_index(), gui2::tree_view::get_root_node(), team::get_side_color_id(), team::get_side_color_range(), tod_manager::get_time_of_day(), font::pango_text::get_token(), gui2::dialogs::addon_manager::get_type_filter_visibility(), editor::context_manager::gui(), hotkey::command_executor::handle_keyup(), editor::common_palette::handler_members(), gui2::generator< minimum_selection, maximum_selection, my_placement, select_action >::impl_create_items(), gui2::generator< minimum_selection, maximum_selection, my_placement, select_action >::impl_draw_children(), insert(), replay_recorder_base::insert_command(), spirit_po::catalog< hashmap_type, pf_compiler >::insert_message(), font::pango_text::insert_text(), game_lua_kernel::intf_get_sides(), intf_music_add(), replay_recorder_base::is_ancestor(), ng::create_engine::is_campaign(), team::is_enemy(), gui2::generator< minimum_selection, maximum_selection, my_placement, select_action >::item(), gui2::generator< minimum_selection, maximum_selection, my_placement, select_action >::item_ordered(), team::knows_about_team(), luaW_getglobal(), wesnothd::make_add_diff(), wesnothd::make_change_diff(), wesnothd::make_delete_diff(), terrain_filter::match_internal(), display::menu_pressed(), team::merge_shroud_map_data(), gui2::dialogs::addon_manager::on_order_changed(), variable_info_implementation::replace_range_h::operator()(), variable_info_implementation::merge_range_h::operator()(), recall_list_manager::operator[](), cave_map_generator::cave_map_generator_job::place_chamber(), gui2::pane::place_children(), gui2::pane::place_or_set_origin_children(), ai::readonly_context_impl::power_projection(), gui2::dialogs::mp_create_game::pre_show(), gui2::dialogs::addon_manager::pre_show(), turn_info::process_network_data(), wesnothd::game::process_turn(), ai::push_move_map(), metrics::record_sample(), simple_wml::node::remove_child(), config::remove_child(), config::remove_children(), replay_recorder_base::remove_command(), ai::ai_default_rca::candidate_action_evaluation_loop::remove_completed_cas(), wesnothd::server::remove_player(), gui2::dialogs::unit_recall::rename_unit(), play_controller::hotkey_handler::replay_skip_animation(), playsingle_controller::hotkey_handler::reset_replay(), editor::editor_controller::save_map(), gui2::generator< minimum_selection, maximum_selection, my_placement, select_action >::select_item(), editor::map_context::set_active_area(), ng::create_engine::set_current_era_index(), ng::flg_manager::set_current_faction(), ng::flg_manager::set_current_gender(), ng::flg_manager::set_current_leader(), gui2::dialogs::editor_resize_map::set_direction_icon(), editor::editor_palette< overlay >::set_group(), ng::side_engine::set_index(), gui2::generator< minimum_selection, maximum_selection, my_placement, select_action >::set_item_selected(), gui2::generator< minimum_selection, maximum_selection, my_placement, select_action >::set_item_shown(), gui2::pane::set_origin_children(), gui2::dialogs::theme_list::set_selected_index(), gui2::dialogs::simple_item_selector::set_selected_index(), editor::location_palette::set_start_item(), editor::editor_palette< overlay >::set_start_item(), replay_controller::should_stop(), attack_type::special_active_impl(), editor::editor_palette< overlay >::start_num(), replay_recorder_base::swap(), editor::context_manager::switch_context(), tod_manager::times(), theme::action::title(), gui2::generator_base::toggle_item(), theme::action::tooltip(), gui2::dialogs::mp_create_game::update_games_list(), and game_events::WML_HANDLER_FUNCTION().
std::string & utf8::insert | ( | std::string & | str, |
const std::size_t | pos, | ||
const std::string & | insert | ||
) |
Insert a UTF-8 string at the specified position.
Definition at line 100 of file unicode.cpp.
References index().
Referenced by wfl::builtins::DEFINE_WFL_FUNCTION(), game_config::dist_channel_id(), gui2::text_box_base::handle_editing(), pathfind::paths::dest_vect::insert(), gui2::password_box::insert_char(), font::pango_text::insert_text(), wesnothd::make_add_diff(), and wesnothd::make_change_diff().
std::string utf8::lowercase | ( | const std::string & | s | ) |
Returns a lowercased version of the string.
Definition at line 52 of file unicode.cpp.
References ucs4::iterator_base< string_type, update_implementation >::end(), s, ucs4::iterator_base< string_type, update_implementation >::substr(), and unicode_cast().
Referenced by addon_filename_legal(), wesnothd::server::bans_handler(), BOOST_AUTO_TEST_CASE(), wesnothd::server::dul_handler(), campaignd::blacklist::is_in_globlist(), wesnothd::server::is_login_allowed(), filesystem::looks_like_pbl(), wesnothd::ban_manager::parse_time(), wesnothd::server::process_command(), wesnothd::server::searchlog_handler(), wesnothd::server::status_handler(), gui2::dialogs::chat_log::model::stream_log(), and campaignd::server::validate_addon().
std::size_t utf8::size | ( | const std::string & | str | ) |
Length in characters of a UTF-8 string.
Definition at line 87 of file unicode.cpp.
References byte_size_from_utf8_first(), ERR_GENERAL, and i.
Referenced by wb::action::action(), gui2::gui_definition::activate(), addon_info::addon_info(), gui2::scrollbar_base::all_items_visible(), gui2::slider_base::at_end(), wb::attack::attack(), battle_context::battle_context(), BF_decode(), BF_encode(), BOOST_AUTO_TEST_CASE(), gui2::implementation::builder_drawing::build(), gui2::spacer::calculate_best_size(), gui2::size_lock::calculate_best_size(), gui2::matrix::calculate_best_size(), gui2::grid::calculate_best_size(), team::calculate_enemies(), font::pango_text::calculate_size(), editor::editor_controller::can_execute_command(), gui2::grid::can_mouse_focus(), gui2::widget::can_mouse_focus(), ai::cfun_ai_get_recruitment_pattern(), battle_context::choose_defender_weapon(), shroud_map::clear(), gui2::text_box::clear(), gui2::grid_implementation::column_request_reduce_width(), gui2::scrollbar_container::content_resize_request(), server_base::coro_receive_doc(), server_base::coro_send_doc(), coro_send_file_userspace(), gui2::dialogs::chat_log::model::count_of_pages(), gui2::policy::placement::independent::create_item(), play_controller::current_team(), cut_surface(), wfl::builtins::DEFINE_WFL_FUNCTION(), wfl::gamestate::DEFINE_WFL_FUNCTION(), editor::editor_controller::do_execute_command(), do_replay_handle(), wb::draw_numbers(), wesnothd::server::dummy_player_updates(), erase(), combatant::fight(), filesystem::file_size(), gui2::scrollbar_container::finalize_subclass(), play_controller::find_last_visible_team(), playsingle_controller::finish_side_turn(), wfl::formula_function_expression::formula_function_expression(), game_launcher::game_launcher(), gui2::styled_widget::get_best_text_size(), wfl::function_symbol_table::get_builtins(), variable_info_implementation::get_child_range(), gui2::text_box_base::get_composition_length(), gui2::tree_view_node::get_current_size(), font::floating_label::get_draw_size(), filesystem::get_files_in_dir(), font::get_floating_label_rect(), gui2::tree_view_node::get_folded_size(), gui2::canvas::get_height(), gui2::size_lock::get_state(), get_system_username(), gui2::tree_view_node::get_unfolded_size(), gui2::text_box_base::handle_editing(), shroud_map::height(), filesystem::ifs_read(), impl_unit_attacks_len(), display::init_flags_for_side_internal(), gui2::password_box::insert_char(), gui2::text_box_base::insert_char(), font::pango_text::insert_text(), game_lua_kernel::intf_create_side(), intf_default_generate_height_map(), intf_describe_plugins(), game_lua_kernel::intf_find_cost_map(), game_lua_kernel::intf_find_path(), game_lua_kernel::intf_find_reach(), game_lua_kernel::intf_get_side(), game_lua_kernel::intf_is_enemy(), game_lua_kernel::intf_match_side(), game_lua_kernel::intf_put_recall_unit(), lua_fileops::intf_read_file(), game_lua_kernel::intf_set_floating_label(), game_lua_kernel::intf_toggle_fog(), editor::editor_display::layout(), gui2::window_implementation::layout(), gui2::window::layout(), gui2::grid::layout(), gui2::window::layout_linked_widgets(), hotkey::hotkey_keyboard::matches_helper(), filesystem::ofs_write(), font::pango_line_width(), php_crypt_blowfish_rn(), shroud_map::place(), gui2::policy::placement::table::place(), playsingle_controller::play_scenario_main_loop(), turn_info::process_network_data(), events::raise_resize_event(), ucs4_convert_impl::utf8_impl::read(), addon_info::read(), gui2::container_base::reduce_height(), gui2::grid::reduce_height(), gui2::container_base::reduce_width(), gui2::grid::reduce_width(), gui2::grid::request_placement(), gui2::container_base::request_reduce_height(), gui2::scrollbar_container::request_reduce_height(), gui2::styled_widget::request_reduce_height(), gui2::policy::placement::horizontal_list::request_reduce_height(), gui2::grid::request_reduce_height(), gui2::policy::placement::vertical_list::request_reduce_height(), gui2::container_base::request_reduce_width(), gui2::scrollbar_container::request_reduce_width(), gui2::styled_widget::request_reduce_width(), gui2::grid::request_reduce_width(), gui2::tree_view::resize_content(), gui2::listbox::resize_content(), editor::map_fragment::rotate_60_ccw(), editor::map_fragment::rotate_60_cw(), gui2::grid_implementation::row_request_reduce_height(), preferences::save_sound_buffer_size(), wb::manager::save_temp_move(), gui2::listbox::select_last_row(), server_base::send_doc_queued(), wb::manager::send_network_data(), editor::editor_display::set_help_string(), gui2::dialogs::file_dialog::set_input_text(), gui2::widget::set_layout_size(), display::set_playing_team(), display::set_team(), editor::mouse_action::set_terrain_mouse_overlay(), preferences::set_tile_size(), gui2::password_box::set_value(), help::show_with_toplevel(), utils::signed_percent(), playsingle_controller::skip_empty_sides(), draw::tiled_highres(), video::to_output(), truncate_as_ucs4(), gui2::dialogs::game_cache_options::update_cache_size_display(), gui2::listbox::update_layout(), display::update_render_textures(), gui2::dialogs::chat_log::controller::update_view_from_model(), validate_side(), shroud_map::value(), game_events::WML_HANDLER_FUNCTION(), and addon_info::write().
std::string & utf8::truncate | ( | std::string & | str, |
const std::size_t | size | ||
) |
Truncates a UTF-8 string to the specified number of characters.
str | UTF-8 encoded string. |
size | Size to truncate to. |
Definition at line 118 of file unicode.cpp.
References erase().
Referenced by BOOST_AUTO_TEST_CASE(), utils::ellipsis_truncate(), and font::pango_text::set_maximum_length().
void utf8::truncate_as_ucs4 | ( | std::string & | str, |
const std::size_t | size | ||
) |
Truncates a UTF-8 string to the specified number of characters.
If the string has more than size
UTF-8 characters it will be truncated to this size.
The output is guaranteed to be valid UTF-8.
[in,out] | str | [in] String encoded in UTF-8. [out] String encoded UTF-8 that contains at most size codepoints. |
size | The size to truncate to. |
Definition at line 123 of file unicode.cpp.
References size(), and unicode_cast().
Referenced by wesnothd::chat_message::truncate_message().