System::String класс

String class

String class used across the library. Is a substitute for C# System.String when translating code. For optimization reasons, isn’t considered an Object subclass. This type should be allocated on stack and passed to functions by value or by reference. Never use System::SmartPtr class to manage objects of this type.

class String

Методы

Метод	Описание
begin() const	Возвращает указатель на начало фактического буфера строки. Никогда ничего не переаллочирует. Не гарантирует, что буфер будет нуль-терминирован.
Clone() const	Создаёт копию текущей строки.
static Compare(const String&, int, const String&, int, int, bool)	Less-equal-greater-compares два подстрока.
static Compare(const String&, int, const String&, int, int, bool, const SharedPtr<System::Globalization::CultureInfo>&)	Less-equal-greater-compares два подстрока.
static Compare(const String&, const String&, System::StringComparison)	Less-equal-greater-compares два строки.
static Compare(const String&, int, const String&, int, int, System::StringComparison)	Less-equal-greater-compares два строки.
static Compare(const String&, const String&, bool)	Less-equal-greater-compares два строки.
static Compare(const String&, const String&, bool, const SharedPtr<System::Globalization::CultureInfo>&)	Less-equal-greater-compares два строки.
static CompareOrdinal(const String&, const String&)	Less-equal-greater-compares два строки с использованием ординального режима.
static CompareOrdinal(const String&, int, const String&, int, int)	Less-equal-greater-compares два строки с использованием ординального режима.
CompareTo(const String&) const	Сравнивает два строки в стиле ’less-equals-more’. Использует текущую культуру.
static Concat(const ArrayPtr<String>&)	Конкатенирует строки.
static Concat(const String&, const String&)	Конкатенирует строки.
static Concat(const String&, const String&, const String&)	Конкатенирует строки.
static Concat(const String&, const String&, const String&, const String&)	Конкатенирует строки.
Contains(const String&) const	Проверяет, является ли str подстрокой текущей строки.
Contains(char16_t) const	Проверяет, содержит ли строка заданный символ.
static Copy(const String&)	Создаёт копию строки.
CopyTo(int, const ArrayPtr<char_t>&, int, int) const	Копирует символы строки в существующие элементы массива. Изменение размера не производится.
end() const	Возвращает указатель на конец фактического буфера строки. Никогда ничего не переаллочирует. Не гарантирует, что буфер будет нуль-терминирован.
EndsWith(const String&) const	Проверяет, заканчивается ли строка указанной подстрокой.
EndsWith(const String&, System::StringComparison) const	Проверяет, заканчивается ли строка указанной подстрокой.
EndsWith(const String&, bool, const SharedPtr<System::Globalization::CultureInfo>&) const	Проверяет, заканчивается ли строка указанной подстрокой.
Equals(const String&, System::StringComparison) const	String сравнение на равенство. Поддерживаются несколько режимов, предоставляемых перечислением StringComparison.
Equals(const String&) const	String сравнение на равенство. Использует режим сравнения System::StringComparison::Ordinal.
static Equals(const String&, const String&)	Сравнивает два строки на равенство, используя режим сравнения Ordial.
static Equals(const String&, const String&, System::StringComparison)	Сравнивает два строки на равенство.
FastToAscii(char, int) const	Пытается преобразовать String в ASCII‑строку.
static Format(const SharedPtr<IFormatProvider>&, const String&, const Args&…)	Форматирует строку в стиле C#.
static Format(std::nullptr_t, const String&, const Args&…)	Форматирует строку в стиле C#.
static Format(std::nullptr_t, const char16_t(&), const Args&…)	Форматирует строку в стиле C#.
static Format(const String&, const Args&…)	Форматирует строку в стиле C#.
static Format(const String&, const System::ArrayPtr<T>&)	Форматирует строку в стиле C#.
static FromAscii(const char *)	Создаёт String из ASCII‑строки.
static FromAscii(const char *, int)	Создаёт String из ASCII‑строки.
static FromAscii(const std::string&)	Создаёт String из ASCII‑строки.
static FromUtf16(const std::u16string&)	Создаёт String из строки utf16.
static FromUtf32(const uint32_t *, int32_t)	Создаёт String из строки utf32.
static FromUtf8(const char *)	Создаёт String из строки utf8.
static FromUtf8(const char *, int)	Создаёт String из строки utf8.
static FromUtf8(const uint8_t *)	Создаёт String из строки utf8.
static FromUtf8(const std::string&)	Создаёт String из строки utf8.
static FromWCS(const std::wstring&)	Создаёт String из widestring.
get_Length() const	Получает длину строки.
GetHashCode() const	Вычисляет хеш содержащейся строки. Реализовано в ICU, не совпадает с хешами в C#.
IndexOf(const String&, System::StringComparison) const	Прямой поиск подстроки.
IndexOf(char_t, int) const	Прямой поиск символа.
IndexOf(char_t, int, int) const	Прямой поиск символа в подстроке.
IndexOf(const String&, int) const	Прямой поиск подстроки.
IndexOf(const String&, int, System::StringComparison) const	Прямой поиск подстроки.
IndexOf(const String&, int, int, System::StringComparison) const	Прямой поиск подстроки.
IndexOf(const String&, int, int) const	Прямой поиск подстроки.
IndexOfAny(char_t, int) const	Прямой поиск символа.
IndexOfAny(const String&, int) const	Соответственно ищет все символы строки str в данном объекте. Если найден первый символ, возвращается его позиция, иначе ищется второй и так далее.
IndexOfAny(const ArrayPtr<char_t>&) const	Ищет любой из переданных символов во всей строке. Сравнивает первый символ строки со всеми символами в anyOf, затем сравнивает второй и так далее. Возвращает индекс первого символа, совпавшего с любым из целевых символов.
IndexOfAny(const ArrayPtr<char_t>&, int32_t) const	Ищет любой из переданных символов в подстроке. Сравнивает первый символ строки со всеми символами в anyOf, затем сравнивает второй и так далее. Возвращает индекс первого символа, совпавшего с любым из целевых символов.
IndexOfAny(const ArrayPtr<char_t>&, int32_t, int32_t) const	Ищет любой из переданных символов в подстроке. Сравнивает первый символ строки со всеми символами в anyOf, затем сравнивает второй и так далее. Возвращает индекс первого символа, совпавшего с любым из целевых символов.
Insert(int, const String&) const	Вставляет подстроку в указанную позицию.
Is(const System::TypeInfo&) const	Проверяет, является ли объект строки типом, указанным в переданном TypeInfo.
IsAsciiString() const	Указывает, содержит ли String только ASCII‑символы.
IsEmpty() const	Проверяет, что строка не null и пуста.
IsNormalized(System::Text::NormalizationForm) const	Проверяет, нормализована ли Unicode‑строка с использованием указанной формы нормализации.
IsNull() const	Проверяет, считается ли строка null. String считается null только если она создана через конструктор String(), перемещена, скопирована или присвоена из null‑строки, либо был вызван метод reset().
IsNullOrEmpty() const	Проверяет, пустая ли строка или считается ли она null.
static IsNullOrEmpty(const String&)	Проверяет, является ли переданная строка null или пустой.
static IsNullOrWhiteSpace(const String&)	Указывает, является ли указанная строка null, пустой или состоит только из пробельных символов.
static Join(const String&, const ArrayPtr<String>&, int, int)	Объединяет массив, используя строку в качестве разделителя.
static Join(const String&, const System::Details::ArrayView<String>&, int, int)	Объединяет массив, используя строку в качестве разделителя.
static Join(const String&, const SharedPtr<System::Collections::Generic::IEnumerable<String>>&)	Объединяет массив, используя строку в качестве разделителя.
static Join(const String&, const ArrayPtr<SharedPtr<Object>>&)	Объединяет массив, используя строку в качестве разделителя.
LastIndexOf(const String&, int) const	Обратный поиск подстроки.
LastIndexOf(const String&, System::StringComparison) const	Обратный поиск подстроки.
LastIndexOf(const String&, int, System::StringComparison) const	Обратный поиск подстроки.
LastIndexOf(const String&, int, int, StringComparison) const	Обратный поиск подстроки.
LastIndexOf(char_t) const	Обратный поиск символа.
LastIndexOf(char_t, int32_t) const	Обратный поиск символа.
LastIndexOf(char_t, int32_t, int32_t) const	Обратный поиск символа.
LastIndexOfAny(const ArrayPtr<char_t>&) const	Ищет любой из переданных символов по всей строке в обратном порядке. Сравнивает последний символ строки со всеми символами в anyOf, затем сравнивает предыдущий и так далее. Возвращает индекс первого найденного совпадения.
LastIndexOfAny(const ArrayPtr<char_t>&, int32_t) const	Ищет любой из переданных символов в подстроке в обратном порядке. Сравнивает последний символ строки со всеми символами в anyOf, затем сравнивает предыдущий и так далее. Возвращает индекс первого найденного совпадения.
LastIndexOfAny(const ArrayPtr<char_t>&, int32_t, int32_t) const	Ищет любой из переданных символов в подстроке в обратном порядке. Сравнивает последний символ строки со всеми символами в anyOf, затем сравнивает предыдущий и так далее. Возвращает индекс первого найденного совпадения.
Normalize(System::Text::NormalizationForm) const	Нормализует Unicode-строку, используя указанную форму нормализации.
operator ReadOnlySpan< char16_t >() const	Преобразует строку в неизменяемый span.
operator!=(const String&) const	Оператор сравнения на неравенство.
operator!=(std::nullptr_t) const	Проверяет, что строка не null. Применяет ту же логику, что и вызов IsNull().
operator+(const String&) const	String оператор конкатенации.
operator+(const T&) const	String конкатенация со строковым литералом или указателем на строку символов.
operator+(char_t) const	Добавляет символ в конец строки.
operator+(int) const	Добавляет строковое представление целочисленного значения в конец строки.
operator+(uint32_t) const	Добавляет строковое представление беззнакового целого значения в конец строки.
operator+(double) const	Добавляет строковое представление числа с плавающей точкой в конец строки.
operator+(int64_t) const	Добавляет строковое представление целочисленного значения в конец строки.
operator+(const T&) const	Добавляет строковое представление объекта ссылочного типа в конец строки.
operator+(const T&) const	Добавляет строковое представление объекта ссылочного типа в конец строки.
operator+(T) const	Добавляет строковое представление логического значения в конец строки.
operator+=(char_t)	Оператор присваивания с конкатенацией.
operator+=(const String&)	Оператор присваивания с конкатенацией.
operator+=(double)	Оператор присваивания с конкатенацией.
operator+=(uint8_t)	Оператор присваивания с конкатенацией.
operator+=(int16_t)	Оператор присваивания с конкатенацией.
operator+=(uint16_t)	Оператор присваивания с конкатенацией.
operator+=(int32_t)	Оператор присваивания с конкатенацией.
operator+=(uint32_t)	Оператор присваивания с конкатенацией.
operator+=(int64_t)	Оператор присваивания с конкатенацией.
operator+=(uint64_t)	Оператор присваивания с конкатенацией.
operator+=(T)	Оператор присваивания с конкатенацией.
operator<(const String&) const	Сравнивает строки по порядку.
operator=(const String&)	Оператор присваивания.
operator=(String&&)	Оператор перемещающего присваивания.
operator==(const String&) const	Оператор сравнения на равенство.
operator==(std::nullptr_t) const	Проверяет, является ли строка null. Применяет ту же логику, что и вызов IsNull().
operator>(const String&) const	Сравнивает строки по порядку.
operator[](int) const	Получает символ в указанной позиции.
PadLeft(int, char_t) const	Добавляет заполнение слева от исходной строки.
PadRight(int, char_t) const	Добавляет заполнение справа от исходной строки.
rbegin() const	Возвращает обратный итератор к последнему символу (если он есть) фактического буфера строки.
Remove(int32_t, int32_t) const	Извлекает всё, кроме подстроки, из текущей строки.
rend() const	Возвращает обратный итератор к позиции перед первым символом (если он есть) фактического буфера строки.
Replace(char_t, char_t) const	Заменяет все вхождения символа в строке.
Replace(const String&, const String&) const	Заменяет все вхождения lookup в этой строке.
reset()	Устанавливает строку в null. Аналогично выражению ‘string_variable_name = null’ в C#.
SetCharAt(int, char_t)	Устанавливает символ в указанной позиции.
Split(char_t, StringSplitOptions) const	Разбивает строку по символу.
Split(char_t, int32_t, StringSplitOptions) const	Разбивает строку по символу.
Split(char_t, char_t, StringSplitOptions) const	Разбивает строку по одному из двух символов.
Split(const ArrayPtr<char_t>&, StringSplitOptions) const	Разбивает строку по одному из указанных символов.
Split(const ArrayPtr<char_t>&, int32_t, StringSplitOptions) const	Разбивает строку по одному из указанных символов.
Split(const String&, StringSplitOptions) const	Разбивает строку по подстроке.
Split(const String&, int, StringSplitOptions) const	Разбивает строку по подстроке.
Split(const ArrayPtr<String>&, StringSplitOptions) const	Разбивает строку по подстроке.
Split(const ArrayPtr<String>&, int, StringSplitOptions) const	Разбивает строку по подстроке. В настоящее время поддерживает массив разделителей из нуля или одного элемента.
StartsWith(const String&) const	Проверяет, начинается ли строка с указанной подстроки.
StartsWith(const String&, System::StringComparison) const	Проверяет, начинается ли строка с указанной подстроки.
StartsWith(const String&, bool, const SharedPtr<System::Globalization::CultureInfo>&) const	Проверяет, начинается ли строка с указанной подстроки.
String()	Конструктор по умолчанию. Создаёт объект строки, который считается null.
String(T&, typename std::enable_if<IsStringLiteral<T, char16_t>::value>::type *)	Создаёт строку на основе строкового литерала. Считает литерал нуль-терминированной строкой, вычисляет длину целевой строки на основе размера литерала.
String(const T&, typename std::enable_if<IsStringPointer<T, char16_t>::value>::type *)	Создаёт строку на основе указателя на строку символов. Рассматривает указываемую строку как нуль-терминированную, вычисляет длину целевой строки на основе нулевого символа.
explicit String(T&, typename std::enable_if<IsStringLiteral<T, char>::value>::type *)	Создаёт строку на основе строкового литерала. Считает литерал нуль-терминированной строкой в UTF8, вычисляет длину целевой строки на основе размера литерала.
explicit String(const T&, typename std::enable_if<IsStringPointer<T, char>::value>::type *)	Создаёт строку на основе указателя на строку символов. Рассматривает указываемую строку как нуль-терминированную в UTF8, вычисляет длину целевой строки на основе нулевого символа.
String(const char16_t *, int)	Создаёт строку из указателя на строку символов и явной длины.
String(const ReadOnlySpan<char16_t>&)	Инициализирует новый экземпляр класса System.String Unicode‑символами, указанными в заданном только для чтения span.
String(const char *, int)	Создаёт строку из указателя на строку символов и явной длины.
String(const char16_t *, int, int)	Создаёт строку из указателя на строку символов, начиная с позиции, используя длину.
explicit String(const char16_t, int)	Заполняющий конструктор.
String(const T&, typename std::enable_if<std::is_same<T, std::nullptr_t>::value>::type *)	Конструктор nullptr. Объявлен как шаблон для разрешения приоритетов с другими шаблонными конструкторами.
explicit String(T&, typename std::enable_if<IsStringLiteral<T, wchar_t>::value>::type *)	Создаёт строку на основе литерала широких строк. Считает литерал нуль-терминированной строкой, вычисляет длину целевой строки на основе размера литерала. Преобразование из wchar_t занимает много времени на некоторых платформах, поэтому не допускаются неявные преобразования.
explicit String(const T&, typename std::enable_if<IsStringPointer<T, wchar_t>::value>::type *)	Создаёт строку на основе указателя на строку широких символов. Рассматривает указанную строку как нуль-терминированную, вычисляет длину целевой строки на основе нулевого символа. Преобразование из wchar_t занимает много времени на некоторых платформах, поэтому не допускаются неявные преобразования.
explicit String(const wchar_t *, int)	Создаёт строку из указателя на строку широких символов и явной длины. Преобразование из wchar_t занимает много времени на некоторых платформах, поэтому не допускаются неявные преобразования.
explicit String(const wchar_t, int)	Заполняющий конструктор. Преобразование из wchar_t занимает много времени на некоторых платформах, поэтому не допускаются неявные преобразования.
String(const String&)	Конструктор копирования.
String(String&&)	Конструктор перемещения.
String(const ArrayPtr<char16_t>&)	Преобразует весь массив символов в строку.
String(const ArrayPtr<char16_t>&, int, int)	Преобразует поддиапазон массива символов в строку. Если параметры выходят за границы массива, создаётся пустая строка.
explicit String(const codeporting_icu::UnicodeString&)	Оборачивает UnicodeString в String.
explicit String(codeporting_icu::UnicodeString&&)	Конструктор перемещения.
explicit String(const std::wstring&)	Создаёт String из widestring.
explicit String(const std::u16string&)	Создаёт String из строки utf16.
explicit String(const std::string&)	Создаёт String из строки std::string, представленной в формате UTF-8.
explicit String(const std::u32string&)	Создаёт String из строки std::u32string.
Substring(int32_t) const	Извлекает подстроку.
Substring(int32_t, int32_t) const	Извлекает подстроку.
ToAsciiString() const	Преобразует строку в std::string. Использует кодировку ASCII.
ToByteArray(int32_t, int32_t, bool) const	Преобразует строку или подстроку в массив байтов.
ToCharArray(int32_t, int32_t) const	Преобразует строку или подстроку в массив символов.
ToLower() const	Преобразует все символы строки в нижний регистр.
ToLower(const SharedPtr<System::Globalization::CultureInfo>&) const	Преобразует все символы строки в нижний регистр, используя конкретную культуру.
ToLowerInvariant() const	Преобразует все символы строки в нижний регистр, используя инвариантную культуру.
ToString() const	Обёртка для работы с классом String в контекстах, где вызывается ToString() у объектов значимых типов.
ToString(const SharedPtr<IFormatProvider>&) const	Обёртка для работы с классом String в контекстах, где вызывается ToString() у объектов значимых типов.
ToU16Str() const	Преобразует строку в std::u16string.
ToU32Str() const	Преобразует строку в std::u32string.
ToUpper() const	Преобразует все символы строки в верхний регистр.
ToUpper(const SharedPtr<System::Globalization::CultureInfo>&) const	Преобразует все символы строки в верхний регистр, используя конкретную культуру.
ToUpperInvariant() const	Преобразует все символы строки в верхний регистр, используя инвариантную культуру.
ToUtf8String() const	Преобразует строку в std::string. Использует кодировку UTF-8.
ToWCS() const	Преобразует строку в std::wstring.
Trim() const	Удаляет все пробельные символы как в начале, так и в конце строки.
Trim(char_t) const	Удаляет все вхождения переданного символа как в начале, так и в конце строки.
Trim(const String&) const	Удаляет все вхождения переданных символов как в начале, так и в конце строки.
Trim(const ArrayPtr<char_t>&) const	Удаляет все вхождения переданных символов как в начале, так и в конце строки.
TrimEnd() const	Удаляет все пробельные символы с конца строки.
TrimEnd(char_t) const	Удаляет все вхождения переданного символа с конца строки.
TrimEnd(const String&) const	Удаляет все вхождения переданных символов с конца строки.
TrimEnd(const ArrayPtr<char_t>&) const	Удаляет все вхождения переданных символов с конца строки.
TrimStart() const	Удаляет все пробельные символы с начала строки.
TrimStart(char_t) const	Удаляет все вхождения переданного символа с начала строки.
TrimStart(const String&) const	Удаляет все вхождения переданных символов с начала строки.
TrimStart(const ArrayPtr<char_t>&) const	Удаляет все вхождения переданных символов с начала строки.
u_str() const	Возвращает буфер, завершающийся нулём, в стиле ICU. Может переаллочировать строку.
~String()	Деструктор.

Поля

Поле	Описание
static Empty	Пустая строка.
static Null	Нулевая строка.

Typedefs

Типовое определение	Описание
reverse_iterator	Тип обратного итератора.

Примечания

#include "system/string.h"
#include <iostream>

int main()
{
  // Создайте строку из массива символов и выведите её.
  const auto chars = {u'h', u'e', u'l', u'l', u'o'};
  const System::String string1(chars);
  std::cout << string1 << std::endl;

  // Создайте строку из массива байтов и выведите её.
  const uint8_t bytes[] = {0x77, 0x6f, 0x72, 0x6c, 0x64, 0x0};
  const auto string2 = System::String::FromUtf8(bytes);
  std::cout << string2 << std::endl;

  // Обрежьте строку ниже и выведите её.
  const System::String string3(u"   This string contains whitespaces in the beginning and at the end.   ");
  std::cout << '"' << string3.Trim() << '"' << std::endl;

  // Выведите количество слов в .
  std::cout << "Number of words: " << string3.Trim().Split(' ')->get_Length() << std::endl;

  return 0;
}
/*
This code example produces the following output:
hello
world
"This string contains whitespaces in the beginning and at the end."
Number of words: 11
*/

См. также

Namespace System
Library Aspose.PDF for C++

System::Span класс System::StringComparer class