xtd - Reference Guide  0.1.2
Modern c++17/20 framework to create console, GUI and unit test applications on Windows, macOS, Linux, iOS and android.
Loading...
Searching...
No Matches
ustring.h
Go to the documentation of this file.
1
3#pragma once
4
6#define __XTD_CORE_INTERNAL__
7#include "internal/__generic_stream_output.h"
8#include "internal/__format_information.h"
9#include "internal/__format_stringer.h"
10#include "internal/__sprintf.h"
11#undef __XTD_CORE_INTERNAL__
13
14#include <string>
15#include "string_comparison.h"
16#include "string_split_options.h"
17#include "types.h"
18#include "object.h"
19#include "parse.h"
20#include "to_string.h"
21
22#if !defined(_WIN32)
23#include <cxxabi.h>
24#endif
25
27namespace xtd {
28 class ustring;
29}
30template<typename ...args_t>
31void __ustring_extract_format_arg(xtd::ustring& fmt, std::vector<__format_information<char>>& format, args_t&&... args);
32void __throw_ustring_format_exception();
33void __throw_ustring_format_exception_close_bracket();
34void __throw_ustring_format_exception_open_bracket();
35void __throw_ustring_format_exception_start_colon();
37
38namespace xtd {
48 class ustring : public object, public std::basic_string<char> {
49 public:
51 ustring() noexcept;
54 explicit ustring(const allocator_type& allocator) noexcept;
55
60 ustring(size_t count, value_type character);
66 ustring(size_t count, value_type character, const allocator_type& allocator);
71 ustring(size_t count, char8_t character);
77 ustring(size_t count, char8_t character, const allocator_type& allocator);
82 ustring(size_t count, char16_t character);
88 ustring(size_t count, char16_t character, const allocator_type& allocator);
93 ustring(size_t count, char32_t character);
99 ustring(size_t count, char32_t character, const allocator_type& allocator);
104 ustring(size_t count, wchar_t character);
110 ustring(size_t count, wchar_t character, const allocator_type& allocator);
111
116 ustring(const ustring& str, size_t index, size_t count);
122 ustring(const ustring& str, size_t index, size_t count, const allocator_type& allocator);
126 ustring(const ustring& str, size_t index);
131 ustring(const ustring& str, size_t index, const allocator_type& allocator);
132
135 ustring(const value_type* str, size_t count);
140 ustring(const value_type* str, size_t count, const allocator_type& allocator);
141
143 ustring(const value_type* str);
147 ustring(const value_type* str, const allocator_type& allocator);
148
150 ustring(value_type* str);
154 ustring(value_type* str, const allocator_type& allocator);
155
158 ustring(const ustring& str) noexcept;
162 ustring(const ustring& str, const allocator_type& allocator) noexcept;
163
166 ustring(const std::string& str) noexcept;
170 ustring(const std::string& str, const allocator_type& allocator) noexcept;
171
174 ustring(const std::u8string& str) noexcept;
178 ustring(const std::u8string& str, const allocator_type& allocator) noexcept;
179
181 ustring(const char8_t* str);
185 ustring(const char8_t* str, const allocator_type& allocator);
186
188 ustring(char8_t* str);
192 ustring(char8_t* str, const allocator_type& allocator);
193
196 ustring(const std::u16string& str) noexcept;
200 ustring(const std::u16string& str, const allocator_type& allocator) noexcept;
201
203 ustring(const char16_t* str);
207 ustring(const char16_t* str, const allocator_type& allocator);
208
210 ustring(char16_t* str);
214 ustring(char16_t* str, const allocator_type& allocator);
215
218 ustring(const std::u32string& str) noexcept;
222 ustring(const std::u32string& str, const allocator_type& allocator) noexcept;
223
225 ustring(const char32_t* str);
229 ustring(const char32_t* str, const allocator_type& allocator);
230
232 ustring(char32_t* str);
236 ustring(char32_t* str, const allocator_type& allocator);
237
240 ustring(const std::wstring& str) noexcept;
244 ustring(const std::wstring& str, const allocator_type& allocator) noexcept;
245
247 ustring(const wchar_t* str);
251 ustring(const wchar_t* str, const allocator_type& allocator);
252
254 ustring(wchar_t* str);
258 ustring(wchar_t* str, const allocator_type& allocator);
259
262 ustring(ustring&& str) noexcept;
266 ustring(ustring&& str, const allocator_type& allocator) noexcept;
267
271 template<typename input_iterator_t>
272 ustring(input_iterator_t first, input_iterator_t last) : std::basic_string<value_type>(first, last) {}
277 template<typename input_iterator_t>
278 ustring(input_iterator_t first, input_iterator_t last, const allocator_type& allocator) : std::basic_string<value_type>(first, last, allocator) {}
279
282 ustring(std::initializer_list<value_type> il);
286 ustring(std::initializer_list<value_type> il, const allocator_type& allocator);
287
290 ustring(std::initializer_list<char8_t> il);
294 ustring(std::initializer_list<char8_t> il, const allocator_type& allocator);
295
298 ustring(std::initializer_list<char16_t> il);
302 ustring(std::initializer_list<char16_t> il, const allocator_type& allocator);
303
306 ustring(std::initializer_list<char32_t> il);
310 ustring(std::initializer_list<char32_t> il, const allocator_type& allocator);
311
314 ustring(std::initializer_list<wchar_t> il);
318 ustring(std::initializer_list<wchar_t> il, const allocator_type& allocator);
319
321 /*
322 template<typename type_t>
323 ustring(const type_t& object) : std::basic_string<value_type>(object) {}
324 template<typename type_t>
325 ustring(const type_t& object, const allocator_type& allocator) : std::basic_string<value_type>(object, allocator) {}
326 template<typename type_t>
327 ustring(const type_t& object, size_t index, size_t count) : std::basic_string<value_type>(object, index, count) {}
328 template<typename type_t>
329 ustring(const type_t& object, size_t index, size_t count, const allocator_type& allocator) : std::basic_string<value_type>(object, index, count, allocator) {}
330 template<typename type_t>
331 ustring(const type_t& object, size_t count) : std::basic_string<value_type>(object, 0, count) {}
332 template<typename type_t>
333 ustring(const type_t& object, size_t count, const allocator_type& allocator) : std::basic_string<value_type>(object, 0, count, allocator) {}
334 */
335
336 ustring& operator=(const ustring& str);
337 ustring& operator=(const std::string& str);
338 ustring& operator=(const value_type* str);
339 ustring& operator=(const std::u8string& str);
340 ustring& operator=(const char8_t* str);
341 ustring& operator=(const std::u16string& str);
342 ustring& operator=(const char16_t* str);
343 ustring& operator=(const std::u32string& str);
344 ustring& operator=(const char32_t* str);
345 ustring& operator=(const std::wstring& str);
346 ustring& operator=(const wchar_t* str);
347 ustring& operator=(ustring&& str) noexcept;
348
349 ustring& operator=(value_type character);
350 ustring& operator=(char8_t character);
351 ustring& operator=(char16_t character);
352 ustring& operator=(char32_t character);
353 ustring& operator=(wchar_t character);
354 ustring& operator=(const std::initializer_list<value_type>& il);
355 ustring& operator=(const std::initializer_list<char8_t>& il);
356 ustring& operator=(const std::initializer_list<char16_t>& il);
357 ustring& operator=(const std::initializer_list<char32_t>& il);
358 ustring& operator=(const std::initializer_list<wchar_t>& il);
359 //template<typename type_t>
360 //ustring& operator=(const type_t& object) {return std::basic_string<value_type>::assign(object);}
361
362 template<typename type_t>
363 ustring operator+(const type_t& object) const {
364 ustring result(*this);
365 result.append(object);
366 return result;
367 }
368
369 ustring& operator+=(const ustring& str);
370 ustring& operator+=(const std::string& str);
371 ustring& operator+=(const value_type* str);
372 ustring& operator+=(const std::u8string& str);
373 ustring& operator+=(const char8_t* str);
374 ustring& operator+=(const std::u16string& str);
375 ustring& operator+=(const char16_t* str);
376 ustring& operator+=(const std::u32string& str);
377 ustring& operator+=(const char32_t* str);
378 ustring& operator+=(const std::wstring& str);
379 ustring& operator+=(const wchar_t* str);
380 ustring& operator+=(value_type character);
381 ustring& operator+=(char8_t character);
382 ustring& operator+=(char16_t character);
383 ustring& operator+=(char32_t character);
384 ustring& operator+=(wchar_t character);
385 ustring& operator+=(const std::initializer_list<value_type>& il);
386 ustring& operator+=(const std::initializer_list<char8_t>& il);
387 ustring& operator+=(const std::initializer_list<char16_t>& il);
388 ustring& operator+=(const std::initializer_list<char32_t>& il);
389 ustring& operator+=(const std::initializer_list<wchar_t>& il);
390 template<typename type_t>
391 ustring& operator+=(const type_t& object) {
392 *this = *this + ustring(object);
393 return *this;
394 }
395
396 bool operator==(const ustring& other) const;
397 bool operator!=(const ustring& other) const;
398 bool operator==(const std::string other) const;
399 bool operator!=(const std::string other) const;
400 bool operator==(const value_type* other) const;
401 bool operator!=(const value_type* other) const;
402 bool operator==(const std::u8string other) const;
403 bool operator!=(const std::u8string other) const;
404 bool operator==(const char8_t* other) const;
405 bool operator!=(const char8_t* other) const;
406 bool operator==(const std::u16string other) const;
407 bool operator!=(const std::u16string other) const;
408 bool operator==(const char16_t* other) const;
409 bool operator!=(const char16_t* other) const;
410 bool operator==(const std::u32string other) const;
411 bool operator!=(const std::u32string other) const;
412 bool operator==(const char32_t* other) const;
413 bool operator!=(const char32_t* other) const;
414 bool operator==(const std::wstring other) const;
415 bool operator!=(const std::wstring other) const;
416 bool operator==(const wchar_t* other) const;
417 bool operator!=(const wchar_t* other) const;
418 const value_type& operator[](size_t index);
419 const value_type& operator[](size_t index) const;
420 ustring substr(size_type index = 0, size_type count = npos) const;
422
426 template<typename object_t>
427 static ustring full_class_name() {return demangle(typeid(object_t).name());}
428
432 template<typename object_t>
433 static ustring full_class_name(const object_t& object) {return demangle(typeid(object).name());}
434
438 static ustring full_class_name(const std::type_info& info) {return demangle(info.name());}
439
443 template<typename object_t>
444 static ustring class_name() {return get_class_name(full_class_name<object_t>());}
445
449 template<typename object_t>
450 static ustring class_name(const object_t& object) {return get_class_name(full_class_name(object));}
451
455 static ustring class_name(const std::type_info& info) {return get_class_name(full_class_name(info));}
456
457 using std::basic_string<value_type>::compare;
467 static int compare(const ustring& str_a, const ustring& str_b) noexcept;
478 static int compare(const ustring& str_a, const ustring& str_b, bool ignore_case) noexcept;
479
490 static int compare(const ustring& str_a, const ustring& str_b, xtd::string_comparison comparison_type) noexcept;
503 static int compare(const ustring& str_a, size_t index_a, const ustring& str_b, size_t index_b, size_t length) noexcept;
517 static int compare(const ustring& str_a, size_t index_a, const ustring& str_b, size_t index_b, size_t length, bool ignore_case) noexcept;
531 static int compare(const ustring& str_a, size_t index_a, const ustring& str_b, size_t index_b, size_t length, xtd::string_comparison comparison_type) noexcept;
532
539 static ustring concat(const ustring& str_a, const ustring& str_b, const ustring& str_c, const ustring& str_d) noexcept;
540
547 template<typename object_a_t, typename object_b_t, typename object_c_t, typename object_d_t>
548 static ustring concat(object_a_t obj_a, object_b_t obj_b, object_c_t obj_c, object_d_t obj_d) noexcept {
549 return format("{}{}{}{}", obj_a, obj_b, obj_c, obj_d);
550 }
551
557 static ustring concat(const ustring& str_a, const ustring& str_b, const ustring& str_c) noexcept;
558
564 template<typename object_a_t, typename object_b_t, typename object_c_t>
565 static ustring concat(object_a_t obj_a, object_b_t obj_b, object_c_t obj_c) noexcept {
566 return format("{}{}{}", obj_a, obj_b, obj_c);
567 }
568
573 static ustring concat(const ustring& str_a, const ustring& str_b) noexcept;
574
579 template<typename object_a_t, typename object_b_t>
580 static ustring concat(object_a_t obj_a, object_b_t obj_b) noexcept {
581 return format("{}{}", obj_a, obj_b);
582 }
583
587 static ustring concat(const std::vector<ustring>& values) noexcept;
588
590 static ustring concat(const std::vector<const value_type*>& values) noexcept;
591 static ustring concat(const std::vector<const char8_t*>& values) noexcept;
592 static ustring concat(const std::initializer_list<ustring>& values) noexcept;
593 static ustring concat(const std::initializer_list<const value_type*>& values) noexcept;
594 static ustring concat(const std::initializer_list<const char8_t*>& values) noexcept;
596
600 template<typename object_t>
601 static ustring concat(const std::vector<object_t>& args) noexcept {
602 ustring result;
603 for (const auto& arg : args)
604 result += format("{}", arg);
605 return result;
606 }
607
609 template<typename object_t>
610 static ustring concat(const std::initializer_list<object_t>& args) noexcept {
611 ustring result;
612 for (const auto& arg : args)
613 result += format("{}", arg);
614 return result;
615 }
617
621 template<typename value_t>
622 static ustring concat(value_t value) noexcept {
623 return format("{}", value);
624 }
625
628 static ustring demangle(const ustring& name) {
629#if defined(_WIN32)
630 ustring result = name;
631 for (auto& item : {"enum ", "class ", "union ", "struct "})
632 result = result.replace(item, "");
633 return result;
634#else
635 class auto_delete_char_pointer {
636 public:
637 auto_delete_char_pointer(char* value) : value_(value) {}
638 ~auto_delete_char_pointer() {free(value_);}
639 char* operator()() const {return value_;}
640 private:
641 char* value_;
642 };
643 int32_t status = 0;
644 return auto_delete_char_pointer(abi::__cxa_demangle(name.c_str(), 0, 0, &status))();
645#endif
646 }
647
651 bool contains(const ustring& value) const noexcept;
652
655 static ustring empty_string() noexcept;
656
660 bool ends_with(value_type value) const noexcept;
661
665 bool ends_with(char8_t value) const noexcept;
666
670 bool ends_with(const ustring& value) const noexcept;
671
675 bool ends_with(const ustring& value, bool ignore_case) const noexcept;
676
680 bool ends_with(const ustring& value, xtd::string_comparison comparison_type) const noexcept;
681
688 template<typename ...args_t>
689 static ustring format(const ustring& fmt, args_t&&... args) {
690 ustring result;
691 size_t index = 0;
692 std::vector<__format_information<char>> formats;
693 typename ustring::const_iterator begin_format_iterator = fmt.cend();
694 typename ustring::const_iterator end_format_iterator = fmt.cend();
695 for (typename ustring::const_iterator iterator = fmt.cbegin(); iterator != fmt.cend(); ++iterator) {
696 if (*iterator == '{') {
697 ++iterator;
698 if (*iterator == '{')
699 result += *iterator;
700 else {
701 begin_format_iterator = iterator;
702 while (*iterator != '}' && iterator != fmt.end()) ++iterator;
703 if (iterator == fmt.end())
704 __throw_ustring_format_exception_open_bracket();
705 end_format_iterator = iterator;
706 __format_information<char> fi;
707 fi.location = result.size();
708 std::string format {begin_format_iterator, end_format_iterator};
709 if (format.size() == 0)
710 fi.index = index++;
711 else {
712 size_t index_alignment_separator = ustring(format).index_of(',');
713 size_t index_format_separator = ustring(format).index_of(u8':');
714
715 if (index_alignment_separator != std::string::npos && index_format_separator != std::string::npos && index_alignment_separator > index_format_separator)
716 index_alignment_separator = std::string::npos;
717
718 if (index_alignment_separator != std::string::npos)
719 fi.alignment = format.substr(index_alignment_separator + 1, index_format_separator != std::string::npos ? index_format_separator - index_alignment_separator - 1 : std::string::npos);
720
721 if (index_format_separator != std::string::npos)
722 fi.format = format.substr(index_format_separator + 1);
723
724 if (index_alignment_separator == 0 || index_format_separator == 0)
725 fi.index = index++;
726 else {
727 std::string index_str;
728 if (index_alignment_separator != std::string::npos)
729 index_str = format.substr(0, index_alignment_separator);
730 else if (index_format_separator != std::string::npos)
731 index_str = format.substr(0, index_format_separator);
732 else
733 index_str = format;
734 try {
735 for (auto c : index_str)
736 if (!std::isdigit(c)) __throw_ustring_format_exception_start_colon();
737 fi.index = std::stoi(index_str);
738 } catch(...) {
739 __throw_ustring_format_exception_start_colon();
740 }
741 }
742 }
743 formats.push_back(fi);
744 }
745 } else if (*iterator == '}') {
746 if (++iterator == fmt.cend())
747 __throw_ustring_format_exception_close_bracket();
748 if (*iterator != '}')
749 __throw_ustring_format_exception_close_bracket();
750 result += *iterator;
751 } else
752 result += *iterator;
753 }
754
755 __ustring_extract_format_arg(result, formats, std::forward<args_t>(args)...);
756 return result.c_str();
757 }
758
761 size_t get_hash_code() const noexcept override;
762
766 size_t index_of(value_type value) const noexcept;
767
771 size_t index_of(const ustring& value) const noexcept;
772
777 size_t index_of(value_type value, size_t start_index) const noexcept;
778
783 size_t index_of(const ustring& value, size_t start_index) const noexcept;
784
790 size_t index_of(value_type value, size_t start_index, size_t count) const noexcept;
791
797 size_t index_of(const ustring& value, size_t start_index, size_t count) const noexcept;
798
802 size_t index_of_any(const std::vector<value_type>& values) const noexcept;
803
808 size_t index_of_any(const std::vector<value_type>& values, size_t start_index) const noexcept;
809
815 size_t index_of_any(const std::vector<value_type>& values, size_t start_index, size_t count) const noexcept;
816
818 size_t index_of_any(const std::initializer_list<value_type>& values) const noexcept;
819 size_t index_of_any(const std::initializer_list<value_type>& values, size_t start_index) const noexcept;
820 size_t index_of_any(const std::initializer_list<value_type>& values, size_t start_index, size_t count) const noexcept;
822
829 ustring insert(size_t start_index, const ustring& value) const noexcept;
830
833 bool is_empty() const noexcept;
834
841 template<typename collection_t>
842 static ustring join(const ustring separator, const collection_t& values) noexcept {return join(separator, values, 0, values.size());}
843
851 template<typename collection_t>
852 static ustring join(const ustring& separator, const collection_t& values, size_t index) noexcept {return join(separator, values, index, values.size()-index);}
853
862 template<typename collection_t>
863 static ustring join(const ustring& separator, const collection_t& values, size_t index, size_t count) noexcept {
864 size_t i = 0;
865 ustring result;
866 for (const auto& item : values) {
867 if (i >= index) {
868 if (i != index) result += separator;
869 result += format("{}", item);
870 }
871 if (++i >= index + count) break;
872 }
873 return result;
874 }
875
877 template<typename value_t>
878 static ustring join(const ustring& separator, const std::initializer_list<value_t>& values) noexcept {return join(separator, std::vector<value_t>(values));}
879 template<typename value_t>
880 static ustring join(const ustring& separator, const std::initializer_list<value_t>& values, size_t index) noexcept {return join(separator, std::vector<value_t>(values), index);}
881 template<typename value_t>
882 static ustring join(const ustring& separator, const std::initializer_list<value_t>& values, size_t index, size_t count) noexcept {return join(separator, std::vector<value_t>(values), index, count);}
884
888 size_t last_index_of(value_type value) const noexcept;
889
893 size_t last_index_of(const ustring& value) const noexcept;
894
899 size_t last_index_of(value_type value, size_t start_index) const noexcept;
900
905 size_t last_index_of(const ustring& value, size_t start_index) const noexcept;
906
913 size_t last_index_of(value_type value, size_t start_index, size_t count) const noexcept;
914
920 size_t last_index_of(const ustring& value, size_t start_index, size_t count) const noexcept;
921
925 size_t last_index_of_any(const std::vector<value_type>& values) const noexcept;
926
931 size_t last_index_of_any(const std::vector<value_type>& values, size_t start_index) const noexcept;
932
938 size_t last_index_of_any(const std::vector<value_type>& values, size_t start_index, size_t count) const noexcept;
939
941 size_t last_index_of_any(const std::initializer_list<value_type>& values) const noexcept;
942 size_t last_index_of_any(const std::initializer_list<value_type>& values, size_t start_index) const noexcept;
943 size_t last_index_of_any(const std::initializer_list<value_type>& values, size_t start_index, size_t count) const noexcept;
945
951 ustring pad_left(size_t total_width) const noexcept;
952
959 ustring pad_left(size_t total_width, value_type padding_char) const noexcept;
960
966 ustring pad_right(size_t total_width) const noexcept;
967
974 ustring pad_right(size_t total_width, value_type padding_char) const noexcept;
975
979 ustring remove(size_t start_index) const noexcept;
980
985 ustring remove(size_t start_index, size_t count) const noexcept;
986
991 ustring replace(value_type old_char, value_type new_char) const noexcept;
992
998 ustring replace(const ustring& old_string, const ustring& new_string) const noexcept;
999
1011 std::vector<ustring> split(const std::vector<value_type>& separators, size_t count, string_split_options options) const noexcept;
1012
1017 std::vector<ustring> split() const noexcept;
1018
1024 std::vector<ustring> split(const std::vector<value_type>& separators) const noexcept;
1025
1042 std::vector<ustring> split(const std::vector<value_type>& separators, string_split_options options) const noexcept;
1043
1052 std::vector<ustring> split(const std::vector<value_type>& separators, size_t count) const noexcept;
1053
1113 template<typename ... args_t>
1114 static ustring sprintf(const ustring& fmt, args_t&& ... args) noexcept {return __sprintf(fmt.c_str(), convert_param(std::forward<args_t>(args)) ...);}
1115
1120 bool starts_with(value_type value) const noexcept;
1121
1127 bool starts_with(value_type value, bool ignore_case) const noexcept;
1128
1133 bool starts_with(const ustring& value) const noexcept;
1134
1140 bool starts_with(const ustring& value, bool ignore_case) const noexcept;
1141
1146 ustring substring(size_t start_index) const noexcept;
1147
1152 ustring substring(size_t start_index, size_t length) const noexcept;
1153
1156 std::vector<value_type> to_array() const noexcept;
1157
1161 std::vector<value_type> to_array(size_t start_index) const noexcept;
1162
1167 std::vector<value_type> to_array(size_t start_index, size_t length) const noexcept;
1168
1171 ustring to_lower() const noexcept;
1172
1173 //ustring to_string() const noexcept override;
1174 ustring to_string() const noexcept override;
1175
1178 ustring to_upper() const noexcept;
1179
1184 ustring trim() const noexcept;
1185
1190 ustring trim(value_type trim_char) const noexcept;
1191
1196 ustring trim(const std::vector<value_type>& trim_chars) const noexcept;
1197
1202 ustring trim_end() const noexcept;
1203
1208 ustring trim_end(value_type trim_char) const noexcept;
1209
1214 ustring trim_end(const std::vector<value_type>& trim_chars) const noexcept;
1215
1220 ustring trim_start() const noexcept;
1221
1226 ustring trim_start(value_type trim_char) const noexcept;
1227
1232 ustring trim_start(const std::vector<value_type>& trim_chars) const noexcept;
1233
1234 template<typename value_t>
1235 static value_t parse(const ustring& str) {
1236 return xtd::parse<value_t>(str);
1237 }
1238
1239 template<typename value_t>
1240 static bool try_parse(const ustring& str, value_t& value) {
1241 try {
1242 value = parse<value_t>(str);
1243 return true;
1244 } catch(...) {
1245 return false;
1246 }
1247 }
1248
1250 friend std::ostream& operator<<(std::ostream& stream, const ustring& str) {return stream << str.c_str();}
1251 friend std::istream& operator>>(std::istream& stream, ustring& str) {
1252 std::string s;
1253 stream >> s;
1254 str = s;
1255 return stream;
1256 }
1257
1258 friend ustring operator+(const ustring& str_a, const ustring& str_b) {
1259 ustring result = str_a;
1260 result.append(str_b);
1261 return result;
1262 }
1263
1264 friend ustring operator+(const ustring& str_a, const std::string& str_b) {
1265 ustring result = str_a;
1266 result.append(ustring(str_b));
1267 return result;
1268 }
1269
1270 friend ustring operator+(const ustring& str_a, const value_type* str_b) {
1271 ustring result = str_a;
1272 result.append(ustring(str_b));
1273 return result;
1274 }
1275
1276 friend ustring operator+(const ustring& str_a, const std::u8string& str_b) {
1277 ustring result = str_a;
1278 result.append(ustring(str_b));
1279 return result;
1280 }
1281
1282 friend ustring operator+(const ustring& str_a, const char8_t* str_b) {
1283 ustring result = str_a;
1284 result.append(ustring(str_b));
1285 return result;
1286 }
1287
1288 friend ustring operator+(const ustring& str_a, const std::u16string& str_b) {
1289 ustring result = str_a;
1290 result.append(ustring(str_b));
1291 return result;
1292 }
1293
1294 friend ustring operator+(const ustring& str_a, const char16_t* str_b) {
1295 ustring result = str_a;
1296 result.append(ustring(str_b));
1297 return result;
1298 }
1299
1300 friend ustring operator+(const ustring& str_a, const std::u32string& str_b) {
1301 ustring result = str_a;
1302 result.append(ustring(str_b));
1303 return result;
1304 }
1305
1306 friend ustring operator+(const ustring& str_a, const char32_t* str_b) {
1307 ustring result = str_a;
1308 result.append(ustring(str_b));
1309 return result;
1310 }
1311
1312 friend ustring operator+(const ustring& str_a, const std::wstring& str_b) {
1313 ustring result = str_a;
1314 result.append(ustring(str_b));
1315 return result;
1316 }
1317
1318 friend ustring operator+(const ustring& str_a, const wchar_t* str_b) {
1319 ustring result = str_a;
1320 result.append(ustring(str_b));
1321 return result;
1322 }
1323
1324 friend ustring operator+(const ustring& str_a, value_type character) {
1325 ustring result = str_a;
1326 result.append(ustring(1, character));
1327 return result;
1328 }
1329
1330 friend ustring operator+(const ustring& str_a, char8_t character) {
1331 ustring result = str_a;
1332 result.append(ustring(1, character));
1333 return result;
1334 }
1335
1336 friend ustring operator+(const ustring& str_a, char16_t character) {
1337 ustring result = str_a;
1338 result.append(ustring(1, character));
1339 return result;
1340 }
1341
1342 friend ustring operator+(const ustring& str_a, char32_t character) {
1343 ustring result = str_a;
1344 result.append(ustring(1, character));
1345 return result;
1346 }
1347
1348 friend ustring operator+(const ustring& str_a, wchar_t character) {
1349 ustring result = str_a;
1350 result.append(ustring(1, character));
1351 return result;
1352 }
1353
1354 friend ustring operator+(const ustring& str_a, const std::initializer_list<value_type>& il) {
1355 ustring result = str_a;
1356 result.append(ustring(il));
1357 return result;
1358 }
1359
1360 friend ustring operator+(const ustring& str_a, const std::initializer_list<char8_t>& il) {
1361 ustring result = str_a;
1362 result.append(ustring(il));
1363 return result;
1364 }
1365
1366 friend ustring operator+(const ustring& str_a, const std::initializer_list<char16_t>& il) {
1367 ustring result = str_a;
1368 result.append(ustring(il));
1369 return result;
1370 }
1371
1372 friend ustring operator+(const ustring& str_a, const std::initializer_list<char32_t>& il) {
1373 ustring result = str_a;
1374 result.append(ustring(il));
1375 return result;
1376 }
1377
1378 friend ustring operator+(const ustring& str_a, const std::initializer_list<wchar_t>& il) {
1379 ustring result = str_a;
1380 result.append(ustring(il));
1381 return result;
1382 }
1383
1384 friend ustring operator+(const std::string& str_a, const ustring& str_b) {
1385 ustring result(str_a);
1386 result.append(str_b);
1387 return result;
1388 }
1389
1390 friend ustring operator+(const value_type* str_a, const ustring& str_b) {
1391 ustring result(str_a);
1392 result.append(str_b);
1393 return result;
1394 }
1395
1396 friend ustring operator+(const std::u8string& str_a, const ustring& str_b) {
1397 ustring result(str_a);
1398 result.append(str_b);
1399 return result;
1400 }
1401
1402 friend ustring operator+(const char8_t* str_a, const ustring& str_b) {
1403 ustring result(str_a);
1404 result.append(str_b);
1405 return result;
1406 }
1407
1408 friend ustring operator+(const std::u16string& str_a, const ustring& str_b) {
1409 ustring result(str_a);
1410 result.append(str_b);
1411 return result;
1412 }
1413
1414 friend ustring operator+(const char16_t* str_a, const ustring& str_b) {
1415 ustring result(str_a);
1416 result.append(str_b);
1417 return result;
1418 }
1419
1420 friend ustring operator+(const std::u32string& str_a, const ustring& str_b) {
1421 ustring result(str_a);
1422 result.append(str_b);
1423 return result;
1424 }
1425
1426 friend ustring operator+(const char32_t* str_a, const ustring& str_b) {
1427 ustring result(str_a);
1428 result.append(str_b);
1429 return result;
1430 }
1431
1432 friend ustring operator+(const std::wstring& str_a, const ustring& str_b) {
1433 ustring result(str_a);
1434 result.append(str_b);
1435 return result;
1436 }
1437
1438 friend ustring operator+(const wchar_t* str_a, const ustring& str_b) {
1439 ustring result(str_a);
1440 result.append(str_b);
1441 return result;
1442 }
1443
1444 friend ustring operator+(value_type character, const ustring& str_b) {
1445 ustring result(1, character);
1446 result.append(str_b);
1447 return result;
1448 }
1449
1450 friend ustring operator+(char8_t character, const ustring& str_b) {
1451 ustring result(1, character);
1452 result.append(str_b);
1453 return result;
1454 }
1455
1456 friend ustring operator+(char16_t character, const ustring& str_b) {
1457 ustring result(1, character);
1458 result.append(str_b);
1459 return result;
1460 }
1461
1462 friend ustring operator+(char32_t character, const ustring& str_b) {
1463 ustring result(1, character);
1464 result.append(str_b);
1465 return result;
1466 }
1467
1468 friend ustring operator+(wchar_t character, const ustring& str_b) {
1469 ustring result(1, character);
1470 result.append(str_b);
1471 return result;
1472 }
1473
1474 friend ustring operator+(const std::initializer_list<value_type>& il, const ustring& str_b) {
1475 ustring result(il);
1476 result.append(str_b);
1477 return result;
1478 }
1479
1480 friend ustring operator+(const std::initializer_list<char8_t>& il, const ustring& str_b) {
1481 ustring result(il);
1482 result.append(str_b);
1483 return result;
1484 }
1485
1486 friend ustring operator+(const std::initializer_list<char16_t>& il, const ustring& str_b) {
1487 ustring result(il);
1488 result.append(str_b);
1489 return result;
1490 }
1491
1492 friend ustring operator+(const std::initializer_list<char32_t>& il, const ustring& str_b) {
1493 ustring result(il);
1494 result.append(str_b);
1495 return result;
1496 }
1497
1498 friend ustring operator+(const std::initializer_list<wchar_t>& il, const ustring& str_b) {
1499 ustring result(il);
1500 result.append(str_b);
1501 return result;
1502 }
1504
1505 private:
1506 template<typename arg_t>
1507 static auto convert_param(arg_t&& arg) noexcept {
1508 if constexpr (std::is_same<std::remove_cv_t<std::remove_reference_t<arg_t>>, std::string>::value) return std::forward<arg_t>(arg).c_str();
1509 else if constexpr (std::is_same<std::remove_cv_t<std::remove_reference_t<arg_t>>, std::wstring>::value) return std::forward<arg_t>(arg).c_str();
1510 else return std::forward<arg_t>(arg);
1511 }
1512
1513 static ustring get_class_name(const ustring& full_name);
1514
1515 using std::basic_string<value_type>::assign;
1516 using std::basic_string<value_type>::reserve;
1517 using std::basic_string<value_type>::shrink_to_fit;
1518 using std::basic_string<value_type>::clear;
1519 using std::basic_string<value_type>::erase;
1520 using std::basic_string<value_type>::push_back;
1521 using std::basic_string<value_type>::pop_back;
1522 using std::basic_string<value_type>::append;
1523 using std::basic_string<value_type>::replace;
1524 using std::basic_string<value_type>::resize;
1525 };
1526
1530 ustring to_ustring(int val);
1534 ustring to_ustring(unsigned val);
1538 ustring to_ustring(long val);
1542 ustring to_ustring(unsigned long val);
1546 ustring to_ustring(long long val);
1550 ustring to_ustring(unsigned long long val);
1554 ustring to_ustring(float val);
1558 ustring to_ustring(double val);
1562 ustring to_ustring(long double val);
1566 template <typename type_t>
1567 ustring to_ustring(type_t val) {
1568 return ustring::format("{}", val);
1569 }
1570}
1571
1573template<typename arg_t>
1574void __ustring_extract_format_arg(std::string& fmt, size_t& index, std::vector<__format_information<char>>& formats, arg_t&& arg) {
1575 size_t offset = 0;
1576 for (auto& format : formats) {
1577 format.location += offset;
1578 if (format.index == index) {
1579 xtd::ustring arg_str = format.format.empty() ? __format_stringer<char, arg_t>(arg) : xtd::to_string(arg, format.format);
1580
1581 if (!format.alignment.empty()) {
1582 int alignment = 0;
1583 try {
1584 alignment = std::stoi(format.alignment);
1585 } catch(...) {
1586 __throw_ustring_format_exception();
1587 }
1588 if (alignment > 0) arg_str = arg_str.pad_left(alignment);
1589 else if (alignment < 0) arg_str = arg_str.pad_right(-alignment);
1590 }
1591 fmt.insert(format.location, arg_str);
1592 offset += arg_str.size();
1593 }
1594 }
1595 ++index;
1596}
1597
1598template <typename ...args_t>
1599void __xtd_ustrings_unused(args_t&& ... args) {}
1600
1601template<typename ...args_t>
1602void __ustring_extract_format_arg(xtd::ustring& fmt, std::vector<__format_information<char>>& formats, args_t&&... args) {
1603 size_t index = 0;
1604 (__ustring_extract_format_arg(fmt, index, formats, args),...);
1605 __xtd_ustrings_unused(index); // workaround to mute gcc warning: unused-but-set-variable
1606}
xtd::object
Supports all classes in the xtd class hierarchy and provides low-level services to derived classes....
Definition object.h:26
xtd::ustring
Represents text as a sequence of UTF-8 code units.
Definition ustring.h:48
xtd::ustring::ustring
ustring(std::initializer_list< value_type > il, const allocator_type &allocator)
Initializes a new instance of xtd::ustring with specified initializer list and allocator.
xtd::ustring::remove
ustring remove(size_t start_index, size_t count) const noexcept
Deletes all the characters from this string beginning at a specified position and continuing through ...
xtd::ustring::concat
static ustring concat(object_a_t obj_a, object_b_t obj_b, object_c_t obj_c) noexcept
Concatenates three specified instances of object.
Definition ustring.h:565
xtd::ustring::last_index_of_any
size_t last_index_of_any(const std::vector< value_type > &values) const noexcept
Reports the index of the last occurrence in this instance of any character in a specified array of ch...
xtd::ustring::last_index_of
size_t last_index_of(const ustring &value, size_t start_index) const noexcept
Reports the index of the last occurrence of the specified character in this string....
xtd::ustring::last_index_of
size_t last_index_of(const ustring &value, size_t start_index, size_t count) const noexcept
Reports the index of the last occurrence of the specified character in this string....
xtd::ustring::ustring
ustring(std::initializer_list< char32_t > il, const allocator_type &allocator)
Initializes a new instance of xtd::ustring with specified initializer list and allocator.
xtd::ustring::ustring
ustring(std::initializer_list< char32_t > il)
Initializes a new instance of xtd::ustring with specified initializer list.
xtd::ustring::last_index_of
size_t last_index_of(value_type value) const noexcept
Reports the index of the last occurrence of the specified character in this tring.
xtd::ustring::ustring
ustring(std::initializer_list< wchar_t > il)
Initializes a new instance of xtd::ustring with specified initializer list.
xtd::ustring::is_empty
bool is_empty() const noexcept
Indicates whether this string is an empty string ("").
xtd::ustring::ustring
ustring(input_iterator_t first, input_iterator_t last, const allocator_type &allocator)
Initializes a new instance of xtd::ustring with specified first and last iterators of substring and a...
Definition ustring.h:278
xtd::ustring::demangle
static ustring demangle(const ustring &name)
Gets demangled string of name,.
Definition ustring.h:628
xtd::ustring::compare
static int compare(const ustring &str_a, size_t index_a, const ustring &str_b, size_t index_b, size_t length, xtd::string_comparison comparison_type) noexcept
Compares substrings of two specified string objects using the specified rules, and returns an integer...
xtd::ustring::ustring
ustring(std::initializer_list< char8_t > il)
Initializes a new instance of xtd::ustring with specified initializer list.
xtd::ustring::ustring
ustring(std::initializer_list< value_type > il)
Initializes a new instance of xtd::ustring with specified initializer list.
xtd::ustring::last_index_of
size_t last_index_of(value_type value, size_t start_index) const noexcept
Reports the index of the last occurrence of the specified character in this string....
xtd::ustring::substring
ustring substring(size_t start_index, size_t length) const noexcept
Retrieves a substring from this instance. The substring starts at a specified character position and ...
xtd::ustring::concat
static ustring concat(value_t value) noexcept
Creates the string representation of a specified object.
Definition ustring.h:622
xtd::ustring::replace
ustring replace(const ustring &old_string, const ustring &new_string) const noexcept
Replaces all occurrences of a specified string in this string with another specified string.
xtd::ustring::pad_left
ustring pad_left(size_t total_width, value_type padding_char) const noexcept
Right-aligns the characters in this string, padding with spaces on the left for a specified total len...
xtd::ustring::to_upper
ustring to_upper() const noexcept
Returns a copy of the current string converted to uppercase.
xtd::ustring::compare
static int compare(const ustring &str_a, const ustring &str_b, bool ignore_case) noexcept
Compares two specified string objects, ignoring or honoring their case, and returns an integer that i...
xtd::ustring::pad_right
ustring pad_right(size_t total_width, value_type padding_char) const noexcept
Left-aligns the characters in this string, padding with spaces on the right for a specified total len...
xtd::ustring::insert
ustring insert(size_t start_index, const ustring &value) const noexcept
Inserts a specified instance of string at a specified index position in this instance.
xtd::ustring::join
static ustring join(const ustring &separator, const collection_t &values, size_t index, size_t count) noexcept
Concatenates a specified separator string between each element of a specified Object array,...
Definition ustring.h:863
xtd::ustring::index_of_any
size_t index_of_any(const std::vector< value_type > &values) const noexcept
Reports the index of the first occurrence in this instance of any character in a specified array of c...
xtd::ustring::to_array
std::vector< value_type > to_array() const noexcept
Copies the characters in this instance to a Unicode character array.
xtd::ustring::ustring
ustring(std::initializer_list< char16_t > il)
Initializes a new instance of xtd::ustring with specified initializer list.
xtd::ustring::class_name
static ustring class_name(const object_t &object)
Gets the class name of the specified object.
Definition ustring.h:450
xtd::ustring::trim
ustring trim() const noexcept
Removes all leading and trailing occurrences of white-space characters from the specified String.
xtd::ustring::split
std::vector< ustring > split(const std::vector< value_type > &separators, size_t count, string_split_options options) const noexcept
Splits this string into a maximum number of substrings based on the characters in an array.
xtd::ustring::split
std::vector< ustring > split() const noexcept
Splits this string into substrings that are based on the default white-space characters....
xtd::ustring::trim_end
ustring trim_end() const noexcept
Removes all trailing occurrences of white-space characters from the specified String.
xtd::ustring::concat
static ustring concat(object_a_t obj_a, object_b_t obj_b, object_c_t obj_c, object_d_t obj_d) noexcept
Concatenates four specified instances of object.
Definition ustring.h:548
xtd::ustring::index_of
size_t index_of(value_type value) const noexcept
Reports the index of the first occurrence of the specified character in this string.
xtd::ustring::pad_right
ustring pad_right(size_t total_width) const noexcept
Left-aligns the characters in this string, padding with spaces on the right for a specified total len...
xtd::ustring::starts_with
bool starts_with(value_type value, bool ignore_case) const noexcept
Determines whether the beginning of this instance of String matches a specified String,...
xtd::ustring::class_name
static ustring class_name(const std::type_info &info)
Gets the class name of the specified object.
Definition ustring.h:455
xtd::ustring::concat
static ustring concat(const std::vector< object_t > &args) noexcept
Concatenates the string representations of the elements in a specified object array.
Definition ustring.h:601
xtd::ustring::full_class_name
static ustring full_class_name(const object_t &object)
Gets the fully qualified class name of the specified object, including the namespace of the specified...
Definition ustring.h:433
xtd::ustring::ustring
ustring(std::initializer_list< char16_t > il, const allocator_type &allocator)
Initializes a new instance of xtd::ustring with specified initializer list and allocator.
xtd::ustring::trim_start
ustring trim_start() const noexcept
Removes all leading occurrences of white-space characters from the specified String.
xtd::ustring::last_index_of
size_t last_index_of(const ustring &value) const noexcept
Reports the index of the last occurrence of the specified string in this string.
xtd::ustring::replace
ustring replace(value_type old_char, value_type new_char) const noexcept
Replaces all occurrences of a specified char_t in this string with another specified char_t.
xtd::ustring::compare
static int compare(const ustring &str_a, size_t index_a, const ustring &str_b, size_t index_b, size_t length, bool ignore_case) noexcept
Compares substrings of two specified string objects, ignoring or honoring their case,...
xtd::ustring::empty_string
static ustring empty_string() noexcept
Represents the empty string.
xtd::ustring::last_index_of_any
size_t last_index_of_any(const std::vector< value_type > &values, size_t start_index, size_t count) const noexcept
Reports the index of the last occurrence in this instance of any character in a specified array of ch...
xtd::ustring::join
static ustring join(const ustring separator, const collection_t &values) noexcept
Concatenates a specified separator string between each element of a specified object array,...
Definition ustring.h:842
xtd::ustring::concat
static ustring concat(const ustring &str_a, const ustring &str_b, const ustring &str_c, const ustring &str_d) noexcept
Concatenates four specified instances of string.
xtd::ustring::full_class_name
static ustring full_class_name()
Gets the fully qualified class name of the objec_t, including the namespace of the objec_t.
Definition ustring.h:427
xtd::ustring::concat
static ustring concat(object_a_t obj_a, object_b_t obj_b) noexcept
Concatenates two specified instances of object.
Definition ustring.h:580
xtd::ustring::compare
static int compare(const ustring &str_a, const ustring &str_b, xtd::string_comparison comparison_type) noexcept
Compares two specified string objects using the specified rules, and returns an integer that indicate...
xtd::ustring::compare
static int compare(const ustring &str_a, const ustring &str_b) noexcept
Compares two specified string objects and returns an integer that indicates their relative position i...
xtd::ustring::pad_left
ustring pad_left(size_t total_width) const noexcept
Right-aligns the characters in this string, padding with spaces on the left for a specified total len...
xtd::ustring::class_name
static ustring class_name()
Gets the class name of the object_t.
Definition ustring.h:444
xtd::ustring::last_index_of
size_t last_index_of(value_type value, size_t start_index, size_t count) const noexcept
Reports the index of the last occurrence of the specified character in this string....
xtd::ustring::ends_with
bool ends_with(value_type value) const noexcept
Determines whether the end of this string matches the specified character.
xtd::ustring::get_hash_code
size_t get_hash_code() const noexcept override
Returns the hash code for this string.
xtd::ustring::starts_with
bool starts_with(const ustring &value) const noexcept
Determines whether the beginning of this instance of String matches a specified String.
xtd::ustring::ustring
ustring(std::initializer_list< wchar_t > il, const allocator_type &allocator)
Initializes a new instance of xtd::ustring with specified initializer list and allocator.
xtd::ustring::remove
ustring remove(size_t start_index) const noexcept
Deletes all the characters from this string beginning at a specified position and continuing through ...
xtd::ustring::concat
static ustring concat(const std::vector< ustring > &values) noexcept
Concatenates the elements of a specified string array.
xtd::ustring::concat
static ustring concat(const ustring &str_a, const ustring &str_b, const ustring &str_c) noexcept
Concatenates three specified instances of string.
xtd::ustring::substring
ustring substring(size_t start_index) const noexcept
Retrieves a substring from this instance. The substring starts at a specified character position and ...
xtd::ustring::ustring
ustring() noexcept
Initializes a new instance of xtd::ustring.
xtd::ustring::starts_with
bool starts_with(value_type value) const noexcept
Determines whether the beginning of this instance of String matches a specified String.
xtd::ustring::to_string
ustring to_string() const noexcept override
Returns a std::string that represents the current object.
xtd::ustring::ustring
ustring(std::initializer_list< char8_t > il, const allocator_type &allocator)
Initializes a new instance of xtd::ustring with specified initializer list and allocator.
xtd::ustring::join
static ustring join(const ustring &separator, const collection_t &values, size_t index) noexcept
Concatenates a specified separator string between each element of a specified object array,...
Definition ustring.h:852
xtd::ustring::concat
static ustring concat(const ustring &str_a, const ustring &str_b) noexcept
Concatenates two specified instances of string.
xtd::ustring::contains
bool contains(const ustring &value) const noexcept
Returns a value indicating whether a specified substring occurs within this string.
xtd::ustring::last_index_of_any
size_t last_index_of_any(const std::vector< value_type > &values, size_t start_index) const noexcept
Reports the index of the last occurrence in this instance of any character in a specified array of ch...
xtd::ustring::to_lower
ustring to_lower() const noexcept
Returns a copy of the current string converted to lowercase.
xtd::ustring::compare
static int compare(const ustring &str_a, size_t index_a, const ustring &str_b, size_t index_b, size_t length) noexcept
Compares substrings of two specified string objects and returns an integer that indicates their relat...
xtd::ustring::starts_with
bool starts_with(const ustring &value, bool ignore_case) const noexcept
Determines whether the beginning of this instance of String matches a specified String,...
xtd::ustring::full_class_name
static ustring full_class_name(const std::type_info &info)
Gets the fully qualified class name of the specified object, including the namespace of the specified...
Definition ustring.h:438
xtd::ustring::sprintf
static ustring sprintf(const ustring &fmt, args_t &&... args) noexcept
Writes the text representation of the specified arguments list, to string using the specified format ...
Definition ustring.h:1114
xtd::ustring::format
static ustring format(const ustring &fmt, args_t &&... args)
Writes the text representation of the specified arguments list, to string using the specified format ...
Definition ustring.h:689
xtd::string_comparison
string_comparison
Specifies the culture, case, and sort rules to be used by certain overloads of the xtd::ustring::comp...
Definition string_comparison.h:17
xtd::string_split_options
string_split_options
Specifies whether applicable xtd::ustring::split method overloads include or omit empty substrings fr...
Definition string_split_options.h:17
xtd::to_string
std::string to_string(const value_t &value, const std::string &fmt, const std::locale &loc)
Convert a specified value into a string with specified format and locale.
Definition to_string.h:37
xtd::console_key::clear
@ clear
The CLEAR key.
xtd::console_key::s
@ s
The S key.
xtd::console_key::c
@ c
The C key.
xtd::console_key::i
@ i
The I key.
xtd::console_key::separator
@ separator
The Separator key.
xtd::console_key::insert
@ insert
The INS (INSERT) key.
xtd::net::sockets::socket_type::stream
@ stream
Supports reliable, two-way, connection-based byte streams without the duplication of data and without...
xtd
The xtd namespace contains all fundamental classes to access Hardware, Os, System,...
Definition system_report.h:17
xtd::to_ustring
ustring to_ustring(int val)
Converts a signed integer to xtd::ustring.
object.h
Contains xtd::object class.
parse.h
Contains xtd::parse methods.
string_comparison.h
Contains xtd::string_comparison enum class.
string_split_options.h
Contains xtd::string_split_options enum class.
to_string.h
Contains xtd::to_string methods.
types.h
Contains xtd fundamental types.
Generated on Tue Mar 12 2024 16:25:08 for xtd - Reference Guide by Gammasoft. All rights reserved.