String Класс

Определение

Пространство имен:

Java.Lang

Сборка:

Mono.Android.dll

Класс String представляет строки символов.

[Android.Runtime.Register("java/lang/String", DoNotGenerateAcw=true)]
public sealed class String : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ISerializable, Java.Lang.ICharSequence, Java.Lang.IComparable, System.Collections.Generic.IEnumerable<char>

[<Android.Runtime.Register("java/lang/String", DoNotGenerateAcw=true)>]
type String = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ICharSequence
    interface seq<char>
    interface IEnumerable
    interface IComparable

Наследование

Object

Object

String

Атрибуты

RegisterAttribute

Реализации

IJavaObject IJavaPeerable ISerializable ICharSequence IComparable IEnumerable<Char> IEnumerable IDisposable

Комментарии

Класс String представляет строки символов. Все строковые литералы в программах Java, например "abc", реализуются как экземпляры этого класса.

Строки являются константами; Их значения нельзя изменить после их создания. Буферы строк поддерживают изменяемые строки. Поскольку объекты String являются неизменяемыми, их можно использовать совместно. Например: <blockquote>

String str = "abc";

</blockquote>

эквивалентно: <blockquote>

char data[] = {'a', 'b', 'c'};
                String str = new String(data);

</blockquote>

Вот еще несколько примеров использования строк: <blockquote>

System.out.println("abc");
                String cde = "cde";
                System.out.println("abc" + cde);
                String c = "abc".substring(2,3);
                String d = cde.substring(1, 2);

</blockquote>

Класс String включает методы для проверки отдельных символов последовательности, сравнения строк, поиска строк, извлечения подстрок и создания копии строки со всеми символами, переведенными в верхний или нижний регистр. Сопоставление регистра основано на стандартной версии Юникода, указанной классом java.lang.Character Character .

Язык Java обеспечивает специальную поддержку оператора объединения строк ( + ) и преобразования других объектов в строки. Дополнительные сведения о сцепении и преобразовании строк см. в статье Java™ Спецификация языка.

Если не указано иное, передача null аргумента конструктору или методу в этом классе вызовет NullPointerException исключение .

Представляет String строку в формате UTF-16, в которой <дополнительные символы< em>/em> представлены суррогатными парами <<em>/em> (дополнительные сведения см. в разделе Представления символов Юникода в Character классе ). Значения индекса относятся к char единицам кода, поэтому дополнительный символ использует две позиции в String.

Класс String предоставляет методы для обработки кодовых точек Юникода (т. е. символов) в дополнение к методам для работы с единицами кода Юникода (т. е. char значениями).

Если не указано иное, методы сравнения строк не учитывают языковой стандарт. Класс java.text.Collator предоставляет методы для более точного сравнения строк с учетом языкового стандарта.

Добавлено в версии 1.0.

Документация по Java для java.lang.String.

Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License Creative Commons 2.5 Attribution License.

Конструкторы

String()	Создает пустую строку.
String(Byte[])	Создает новый String , декодируя указанный массив байтов с помощью стандартного набора символов платформы.
String(Byte[], Charset)	Создает новый String , декодируя указанный массив байтов с помощью указанного java.
String(Byte[], Int32)	Устаревшие.. Выделяет новый String , содержащий символы, созданные из массива 8-разрядных целочисленных значений.
String(Byte[], Int32, Int32)	Создает новый String объект путем декодирования указанного подмножества байтов с помощью набора символов платформы по умолчанию.
String(Byte[], Int32, Int32, Charset)	Создает новый String , декодируя указанный вложенный массив байтов с помощью указанного java.
String(Byte[], Int32, Int32, Int32)	Устаревшие.. Выделяет новый String объект, созданный из подмежества массива 8-разрядных целочисленных значений.
String(Byte[], Int32, Int32, String)	Создает новый String объект путем декодирования указанного подмножества байтов с помощью указанного набора символов.
String(Byte[], String)	Создает новый String , декодируя указанный массив байтов с помощью указанного java.
String(Char[])	Инициализирует эту строку, чтобы она содержала заданные charзначения .
String(Char[], Int32, Int32)	Инициализирует эту строку, чтобы она содержала заданные charзначения .
String(Int32[], Int32, Int32)	Выделяет новый String объект , содержащий символы из подсбора аргумента массива кодовых точек Юникода.
String(String)	Создает новую строку с той же последовательностью символов, что и toCopy.
String(StringBuffer)	Выделяет новую строку, содержащую последовательность символов, содержащихся в аргументе буфера строки.
String(StringBuilder)	Выделяет новую строку, содержащую последовательность символов, содержащихся в аргументе построителя строк.

Свойства

CaseInsensitiveOrder	Компаратор, который упорядочивает String объекты как по compareToIgnoreCase.
Class	Возвращает класс среды выполнения данного объекта Object. (Унаследовано от Object)
Handle	Дескриптор базового экземпляра Android. (Унаследовано от Object)
IsBlank	Возвращает значение true , если строка пуста или содержит только Character#isWhitespace(int) white space кодовые точки; в противном случае false— значение .
IsEmpty	Возвращает true значение , если и только если #length() имеет значение 0.
JniIdentityHashCode	Класс String представляет строки символов. (Унаследовано от Object)
JniPeerMembers	Класс String представляет строки символов.
PeerReference	Класс String представляет строки символов. (Унаследовано от Object)
ThresholdClass	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. (Унаследовано от Object)
ThresholdType	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. (Унаследовано от Object)

Методы

CharAt(Int32)	Возвращает значение по char указанному индексу.
Clone()	Создает и возвращает копию этого объекта. (Унаследовано от Object)
CodePointAt(Int32)	Возвращает символ (кодовую точку Юникода) по указанному индексу.
CodePointBefore(Int32)	Возвращает символ (кодовую точку Юникода) перед указанным индексом.
CodePointCount(Int32, Int32)	Возвращает число кодовых точек Юникода в указанном текстовом диапазоне данного объекта String.
CompareTo(String)	Сравнивает две строки лексикографически.
CompareToIgnoreCase(String)	Сравнивает две строки лексикографически, игнорируя различия регистра.
Concat(String)	Объединяет указанную строку в конец этой строки.
Contains(ICharSequence)	Возвращает значение true только в том случае, если эта строка содержит указанную последовательность значений char.
Contains(String)	Возвращает значение true только в том случае, если эта строка содержит указанную последовательность значений char.
ContentEquals(ICharSequence)	Сравнивает эту строку с указанной CharSequence.
ContentEquals(String)	Сравнивает эту строку с указанной CharSequence.
ContentEquals(StringBuffer)	Сравнивает эту строку с указанной StringBuffer.
CopyValueOf(Char[])	Эквивалент #valueOf(char[]).
CopyValueOf(Char[], Int32, Int32)	Эквивалент #valueOf(char[], int, int).
Dispose()	Класс String представляет строки символов. (Унаследовано от Object)
Dispose(Boolean)	Класс String представляет строки символов. (Унаследовано от Object)
EndsWith(String)	Проверяет, заканчивается ли эта строка указанным суффиксом.
Equals(Object)	Указывает, равен ли какой-то другой объект этому объекту. (Унаследовано от Object)
EqualsIgnoreCase(String)	Сравнивает это String с другим String, игнорируя рекомендации по случаям.
Format(Locale, String, Object[])	Возвращает отформатированную строку с использованием указанной строки формата и аргументов.
Format(String, Object[])	Возвращает отформатированную строку с использованием указанной строки формата и аргументов.
Formatted(Object[])	Класс String представляет строки символов.
GetBytes()	Кодирует его String в последовательность байтов с помощью стандартного набора символов платформы, сохраняя результат в новом массиве байтов.
GetBytes(Charset)	Кодирует его String в последовательность байтов с помощью заданного java.
GetBytes(Int32, Int32, Byte[], Int32)	Устаревшие.. Копирует символы из этой строки в целевой массив байтов.
GetBytes(String)	Кодирует его String в последовательность байтов с помощью именованного набора символов, сохраняя результат в новом массиве байтов.
GetChars(Int32, Int32, Char[], Int32)	Копирует символы из этой строки в целевой массив символов.
GetEnumerator()	Класс String представляет строки символов.
GetHashCode()	Возвращает значение хэш-кода для объекта. (Унаследовано от Object)
Indent(Int32)	Корректирует отступ каждой строки этой строки на основе значения nи нормализует символы завершения строки.
IndexOf(Int32)	Возвращает индекс в этой строке первого вхождения указанного символа.
IndexOf(Int32, Int32)	Возвращает индекс в этой строке первого вхождения указанного символа, начиная поиск по указанному индексу.
IndexOf(String)	Возвращает индекс в этой строке первого вхождения указанной подстроки.
IndexOf(String, Int32)	Возвращает индекс в этой строке первого вхождения указанной подстроки, начиная с указанного индекса.
Intern()	Возвращает каноническое представление для строкового объекта.
JavaFinalize()	Вызывается сборщиком мусора для объекта , когда сборка мусора определяет, что больше нет ссылок на объект . (Унаследовано от Object)
Join(ICharSequence, ICharSequence[])	Возвращает новую строку, состоящую из копий , объединенных CharSequence elements вместе с копией указанного delimiterобъекта .
Join(ICharSequence, IIterable)	Возвращает новый String объект , состоящий из копий , объединенных CharSequence elements вместе с копией указанного delimiterобъекта .
Join(String, IIterable)	Возвращает новый String объект , состоящий из копий , объединенных CharSequence elements вместе с копией указанного delimiterобъекта .
Join(String, String[])	Возвращает новую строку, состоящую из копий , объединенных CharSequence elements вместе с копией указанного delimiterобъекта .
LastIndexOf(Int32)	Возвращает индекс в этой строке последнего вхождения указанного символа.
LastIndexOf(Int32, Int32)	Возвращает индекс в этой строке последнего вхождения указанного символа, поиск в обратном направлении, начиная с указанного индекса.
LastIndexOf(String)	Возвращает индекс в этой строке последнего вхождения указанной подстроки.
LastIndexOf(String, Int32)	Возвращает индекс в этой строке последнего вхождения указанной подстроки, начиная с указанного индекса.
Length()	Возвращает длину этой строки.
Matches(String)	Указывает, соответствует ли эта строка заданному регулярному выражению.
Notify()	Пробуждает один поток, ожидающий монитора этого объекта. (Унаследовано от Object)
NotifyAll()	Пробуждает все потоки, ожидающие на мониторе этого объекта. (Унаследовано от Object)
OffsetByCodePoints(Int32, Int32)	Возвращает индекс внутри этого String объекта, который смещается от заданного index по кодовой codePointOffset точке.
RegionMatches(Boolean, Int32, String, Int32, Int32)	Проверяет, равны ли две строковые области.
RegionMatches(Int32, String, Int32, Int32)	Проверяет, равны ли две строковые области.
Repeat(Int32)	Возвращает строку, значение которой является объединением повторяемой строки count .
Replace(Char, Char)	Возвращает строку, полученную в результате замены всех вхождений oldChar в этой строке на newChar.
Replace(ICharSequence, ICharSequence)	Заменяет каждую подстроку этой строки, соответствующую целевой литеральной последовательности, указанной последовательностью замены литерала.
Replace(String, String)	Заменяет каждую подстроку этой строки, соответствующую целевой литеральной последовательности, указанной последовательностью замены литерала.
ReplaceAll(String, String)	Заменяет каждую подстроку этой строки, соответствующую заданному регулярному выражению, данной заменой.
ReplaceFirst(String, String)	Заменяет первую подстроку этой строки, которая соответствует заданному регулярному выражению, данной заменой.
SetHandle(IntPtr, JniHandleOwnership)	Задает свойство Handle. (Унаследовано от Object)
Split(String)	Разбивает эту строку на совпадения заданного регулярного выражения.
Split(String, Int32)	Разбивает эту строку на совпадения заданного регулярного выражения.
StartsWith(String)	Проверяет, начинается ли эта строка с указанного префикса.
StartsWith(String, Int32)	Проверяет, начинается ли подстрока этой строки, начинающаяся с указанного индекса, с указанного префикса.
Strip()	Возвращает строку, значение которой равно этой строке, с удалением всех начальных и конечных значений Character#isWhitespace(int) white space .
StripIndent()	Возвращает строку, значение которой равно этой строке, с случайным пробелом Character#isWhitespace(int), удаленным из начала и конца каждой строки.
StripLeading()	Возвращает строку, значение которой равно этой строке, при этом все ведущие Character#isWhitespace(int) white space удалены.
StripTrailing()	Возвращает строку, значение которой равно этой строке, при этом все конечные Character#isWhitespace(int) white space значения удалены.
SubSequence(Int32, Int32)	Возвращает последовательность символов, которая является частью этой последовательности.
SubSequenceFormatted(Int32, Int32)	Возвращает последовательность символов, которая является частью этой последовательности.
Substring(Int32)	Возвращает строку, которая является подстрокой этой строки.
Substring(Int32, Int32)	Возвращает строку, которая является подстрокой этой строки.
ToArray<T>()	Класс String представляет строки символов. (Унаследовано от Object)
ToCharArray()	Преобразует эту строку в новый массив символов.
ToLowerCase()	Преобразует все символы в нижний String регистр, используя правила языкового стандарта по умолчанию.
ToLowerCase(Locale)	Преобразует все символы в нижний String регистр, используя правила заданного Locale.
ToString()	Класс String представляет строки символов.
ToUpperCase()	Преобразует все символы в верхнем String регистре, используя правила языкового стандарта по умолчанию.
ToUpperCase(Locale)	Преобразует все символы в верхнем String регистре, используя правила заданного Locale.
Transform(IFunction)	Этот метод позволяет применять функцию к this строке.
TranslateEscapes()	Возвращает строку, значение которой равно этой строке, с escape-последовательности, преобразованные как будто в строковый литерал.
Trim()	Возвращает строку, значение которой равно этой строке, с удалением всех начальных и конечных пробелов, где пробел определяется как любой символ, кодовая точка которого меньше или равна 'U+0020' (символ пробела).
UnregisterFromRuntime()	Класс String представляет строки символов. (Унаследовано от Object)
ValueOf(Boolean)	Возвращает строковое представление аргумента boolean .
ValueOf(Char)	Возвращает строковое представление аргумента char .
ValueOf(Char[])	Возвращает строковое представление аргумента массива char .
ValueOf(Char[], Int32, Int32)	Возвращает строковое представление определенного подмассивного массива аргумента массива char .
ValueOf(Double)	Возвращает строковое представление аргумента double .
ValueOf(Int32)	Возвращает строковое представление аргумента int .
ValueOf(Int64)	Возвращает строковое представление аргумента long .
ValueOf(Object)	Возвращает строковое представление аргумента Object .
ValueOf(Single)	Возвращает строковое представление аргумента float .
Wait()	Вызывает ожидание текущего потока, пока он не пробудится, как правило, из-за <уведомления><<> или>прерывания или прерывания.>< (Унаследовано от Object)
Wait(Int64)	Вызывает ожидание текущего потока, пока он не пробудится, как правило, путем <уведомления><<> или>прерывания или прерывания<> или до истечения определенного количества реального времени. (Унаследовано от Object)
Wait(Int64, Int32)	Вызывает ожидание текущего потока, пока он не пробудится, как правило, путем <уведомления><<> или>прерывания или прерывания<> или до истечения определенного количества реального времени. (Унаследовано от Object)

Явные реализации интерфейса

IComparable.CompareTo(Object)	Класс String представляет строки символов.
IEnumerable.GetEnumerator()	Класс String представляет строки символов.
IJavaPeerable.Disposed()	Класс String представляет строки символов. (Унаследовано от Object)
IJavaPeerable.DisposeUnlessReferenced()	Класс String представляет строки символов. (Унаследовано от Object)
IJavaPeerable.Finalized()	Класс String представляет строки символов. (Унаследовано от Object)
IJavaPeerable.JniManagedPeerState	Класс String представляет строки символов. (Унаследовано от Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Класс String представляет строки символов. (Унаследовано от Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Класс String представляет строки символов. (Унаследовано от Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Класс String представляет строки символов. (Унаследовано от Object)

Методы расширения

JavaCast<TResult>(IJavaObject)	Выполняет преобразование типа, проверенного средой выполнения Android.
JavaCast<TResult>(IJavaObject)	Класс String представляет строки символов.
GetJniTypeName(IJavaPeerable)	Класс String представляет строки символов.
SubSequence(ICharSequence, Int32, Int32)	Класс String представляет строки символов.