Методы типа string

Тип string в PascalABC.NET является классом и содержит ряд свойств, статических и экземплярных методов, а также методов расширения.

В методах класса string считается, что строки индексируются с нуля. Кроме того, ни один метод не меняет строку, т.к. строки в .NET являются неизменяемыми.

Свойства класса String

Свойство	Описание
s[i]	Индексное свойство. Возвращает или позволяет изменить i-тый символ строки s. Строки в PascalABC.NET индексируются от 1.
Length: integer	Возвращает длину строки

Статические методы класса String

Метод	Описание
String.Compare(s1,s2: string): integer	Сравнивает строки s1 и s2. Возвращает число <0 если s1<s2, =0 если s1=s2 и >0 если s1>s2
String.Compare(s1,s2: string; ignorecase: boolean): integer	То же. Если ignorecase=True, то строки сравниваются без учета регистра букв
String.Format(fmtstr: string, params arr: array of object): string;	Форматирует параметры arr согласно форматной строке fmtstr
String.Join(ss: array of string; delim: string): string	Возвращает строку, полученную слиянием строк ss с использованием delim в качестве разделителя

Экземплярные методы класса String

Отметим, что все экземплярные методы не меняют строку, как это может показаться на первый взгляд, а при необходимости возвращают измененную строку. Кроме того, считается, что символы в сроке индексируются с нуля.

Метод	Описание
Contains(s: string): boolean	Возвращает True, если текущая строка содержит s, и False в противном случае
EndsWith(s: string): boolean	Возвращает True, если текущая строка заканчивается на s, и False в противном случае
IndexOf(s: string): integer	Возвращает индекс первого вхождения подстроки s в текущую строку или -1 если подстрока не найдена
IndexOf(s: string; start,count: integer): integer	Возвращает индекс первого вхождения подстроки s в текущую строку или -1 если подстрока не найдена. Поиск начинается с символа с номером start и распространяется на следующие count символов
IndexOfAny(cc: array of char): integer	Возвращает индекс первого вхождения любого символа из массива сс
Insert(from: integer; s: string): string	Возвращает строку, полученную из исходной строки вставкой подстроки s в позицию from
LastIndexOf(s: string): integer	Возвращает индекс последнего вхождения подстроки s в текущую строку
LastIndexOf(s: string; start,count: integer): integer	Возвращает индекс последнего вхождения подстроки s в текущую строку или -1 если подстрока не найдена. Поиск начинается с символа с номером start и распространяется на следующие count символов
LastIndexOfAny(a: array of char): integer	Возвращает индекс последнего вхождения любого символа из массива сс
PadLeft(n: integer): string	Возвращает строку, полученную из исходной строки выравниванием по правому краю с заполнением пробелами слева до длины n
PadRight(n: integer): string	Возвращает строку, полученную из исходной строки выравниванием по левому краю с заполнением пробелами справа до длины n
Remove(from,len: integer): string	Возвращает строку, полученную из исходной строки удалением len симолов с позиции from
Replace(s1,s2: string): string	Возвращает строку, полученную из исходной строки заменой всех вхождений подстроки s1 на строку s2
Split(params delim: array of char): array of string	Возвращает массив строк, полученный расщеплением исходной строки на слова, при этом в качестве разделителей используется любой из символов delim (по умолчанию - пробел)
StartsWith(s: string): boolean	Возвращает True, если текущая строка начинается на s, и False в противном случае
Substring(from,len: integer): string	Возвращает подстроку исходной строки с позиции from длины len
ToCharArray: array of char	Возвращает динамический массив символов исходной строки
ToLower: string	Возвращает строку, приведенную к нижнему регистру
ToUpper: string	Возвращает строку, приведенную к верхнему регистру
Trim: string	Возвращает строку, полученную из исходной удалением лидирующих и завершающих пробелов
TrimEnd(params cc: array of char): string	Возвращает строку, полученную из исходной удалением завершающих символов из массива cc
TrimStart(params cc: array of char): string	Возвращает строку, полученную из исходной удалением лидирующих  символов из массива cc

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

Некоторые методы расширения - стандартные для .NET, некоторые реализованы только в PascalABC.NET.

Метод	Описание
Inverse: string	Возвращает инверсию строки
Print	Выводит буквы строки, разделенные пробелом
Println	Выводит буквы строки, разделенные пробелом, и осуществляет переход на новую строку
ReadInteger(var from: integer): integer	Считывает из строки целое число с позиции from и возвращает его. Позиция from при этом увеличивается на считанный элемент
ReadReal(var from: integer): real	Считывает из строки вещественное число с позиции from и возвращает его. Позиция from при этом увеличивается на считанный элемент
ReadWord(var from: integer): string	Считывает из строки слово до пробела или до конца строки с позиции from и возвращает его. Позиция from при этом увеличивается на считанный элемент
ToInteger: integer	Преобразует строку к целому и возвращает его. Если это невозможно, генерируется исключение
ToIntegers: array of integer	В строке должны храниться целые, разделенные пробелами. Возвращается массив целых. Если это невозможно, генерируется исключение
ToReal: real	Преобразует строку к вещественному и возвращает его. Если это невозможно, генерируется исключение
ToReals: array of real	В строке должны храниться вещественные, разделенные пробелами. Возвращается массив вещественных. Если это невозможно, генерируется исключение
ToWords(params delim: array of char): array of string	Возвращает массив строк, полученный расщеплением исходной строки на слова, при этом в качестве разделителей используется любой из символов delim (по умолчанию - пробел). В отличие от s.Split не включает в итоговый массив пустые строки. В частности, это означает, что слова могут быть разделены несколькими разделителями delim