String. Substring Метод

Определение

Извлекает подстроку из данного экземпляра. Retrieves a substring from this instance.

Этот член перегружен. This member is overloaded. Для получения полной информации о данном члене, включая синтаксис, использование и примеры, щелкните имя в списке перегрузок. For complete information about this member, including syntax, usage, and examples, click a name in the overload list.

Перегрузки

Извлекает подстроку из данного экземпляра. Retrieves a substring from this instance. Подстрока начинается в указанном положении символов и продолжается до конца строки. The substring starts at a specified character position and continues to the end of the string.

Извлекает подстроку из данного экземпляра. Retrieves a substring from this instance. Подстрока начинается с указанной позиции знака и имеет указанную длину. The substring starts at a specified character position and has a specified length.

Substring(Int32)

Извлекает подстроку из данного экземпляра. Retrieves a substring from this instance. Подстрока начинается в указанном положении символов и продолжается до конца строки. The substring starts at a specified character position and continues to the end of the string.

Параметры

Отсчитываемая от нуля позиция первого знака подстроки в данном экземпляре. The zero-based starting character position of a substring in this instance.

Возвращаемое значение

Строка, эквивалентная подстроке, которая начинается с startIndex в данном экземпляре, или Empty, если значение startIndex равно длине данного экземпляра. A string that is equivalent to the substring that begins at startIndex in this instance, or Empty if startIndex is equal to the length of this instance.

Исключения

startIndex имеет значение меньше нуля или больше длины этого экземпляра. startIndex is less than zero or greater than the length of this instance.

Примеры

В следующем примере показано получение подстроки из строки. The following example demonstrates obtaining a substring from a string.

В следующем примере метод используется Substring для разделения пар «ключ-значение», разделенных символом равенства («=»). The following example uses the Substring method to separate key/value pairs that are delimited by an equals («=») character.

IndexOfМетод используется для получения позиции знака равенства в строке. The IndexOf method is used to get the position of the equals character in the string. Вызов Substring(Int32, Int32) метода извлекает имя ключа, которое начинается с первого символа в строке и расширяется для количества символов, возвращаемых при вызове IndexOf метода. The call to the Substring(Int32, Int32) method extracts the key name, which starts from the first character in the string and extends for the number of characters returned by the call to the IndexOf method. Substring(Int32)Затем вызов метода извлекает значение, присвоенное ключу. The call to the Substring(Int32) method then extracts the value assigned to the key. Он начинается с одной позиции символа за знаком равенства и расширяется до конца строки. It starts at one character position beyond the equals character and extends to the end of the string.

Комментарии

Метод вызывается Substring(Int32) для извлечения подстроки из строки, которая начинается с указанной позиции символа и заканчивается в конце строки. You call the Substring(Int32) method to extract a substring from a string that begins at a specified character position and ends at the end of the string. Начальная позиции символа начинается с нуля; Иными словами, первый символ в строке находится по индексу 0, а не к индексу 1. The starting character position is a zero-based; in other words, the first character in the string is at index 0, not index 1. Чтобы извлечь подстроку, которая начинается с указанной позиции символа и заканчивается до конца строки, вызовите Substring(Int32, Int32) метод. To extract a substring that begins at a specified character position and ends before the end of the string, call the Substring(Int32, Int32) method.

Этот метод не изменяет значение текущего экземпляра. This method does not modify the value of the current instance. Вместо этого он возвращает новую строку, которая начинается с startIndex позиции в текущей строке. Instead, it returns a new string that begins at the startIndex position in the current string.

Чтобы извлечь подстроку, которая начинается с определенного символа или последовательности символов, вызовите метод, например IndexOf или, IndexOf чтобы получить значение startIndex . To extract a substring that begins with a particular character or character sequence, call a method such as IndexOf or IndexOf to get the value of startIndex . Во втором примере это показано. Он извлекает значение ключа, которое начинается с одной позиции символа после символа «=». The second example illustrates this; it extracts a key value that begins one character position after the «=» character.

Если равен startIndex нулю, метод возвращает исходную строку без изменений. If startIndex is equal to zero, the method returns the original string unchanged.

См. также раздел

Применяется к

Substring(Int32, Int32)

Извлекает подстроку из данного экземпляра. Retrieves a substring from this instance. Подстрока начинается с указанной позиции знака и имеет указанную длину. The substring starts at a specified character position and has a specified length.

Параметры

Отсчитываемая от нуля позиция первого знака подстроки в данном экземпляре. The zero-based starting character position of a substring in this instance.

Число символов в подстроке. The number of characters in the substring.

Возвращаемое значение

Строка, эквивалентная подстроке длиной length , которая начинается с startIndex в данном экземпляре, или Empty, если значение startIndex равно длине данного экземпляра, а значение length равно нулю. A string that is equivalent to the substring of length length that begins at startIndex in this instance, or Empty if startIndex is equal to the length of this instance and length is zero.

Исключения

startIndex плюс length указывает на позицию за пределами данного экземпляра. startIndex plus length indicates a position not within this instance.

Значение параметра startIndex или length меньше нуля. startIndex or length is less than zero.

Примеры

В следующем примере показан простой вызов Substring(Int32, Int32) метода, который извлекает два символа из строки, начиная с шестой позиции символа (т. е. по индексу 5). The following example illustrates a simple call to the Substring(Int32, Int32) method that extracts two characters from a string starting at the sixth character position (that is, at index five).

В следующем примере метод используется Substring(Int32, Int32) в следующих трех случаях для изоляции подстрок в строке. The following example uses the Substring(Int32, Int32) method in the following three cases to isolate substrings within a string. В двух случаях подстроки используются в сравнениях, а в третьем случае возникает исключение, так как указаны недопустимые параметры. In two cases the substrings are used in comparisons, and in the third case an exception is thrown because invalid parameters are specified.

Он извлекает один и третий позиции в строке (с индексом 2) и сравнивает его с символом «c». It extracts the single character and the third position in the string (at index 2) and compares it with a «c». Это сравнение возвращает true . This comparison returns true .

Он извлекает ноль символов, начиная с четвертой позиции в строке (с индексом 3) и передает ее IsNullOrEmpty методу. It extracts zero characters starting at the fourth position in the string (at index 3) and passes it to the IsNullOrEmpty method. Это возвращает значение true, поскольку вызов Substring метода возвращает String.Empty . This returns true because the call to the Substring method returns String.Empty.

Он пытается извлечь один символ, начиная с четвертой позиции в строке. It attempts to extract one character starting at the fourth position in the string. Так как в этой позиции нет символа, вызов метода создает ArgumentOutOfRangeException исключение. Because there is no character at that position, the method call throws an ArgumentOutOfRangeException exception.

В следующем примере метод используется Substring для разделения пар «ключ-значение», разделенных символом равенства («=»). The following example uses the Substring method to separate key/value pairs that are delimited by an equals («=») character.

IndexOfМетод используется для получения позиции знака равенства в строке. The IndexOf method is used to get the position of the equals character in the string. Вызов Substring(Int32, Int32) метода извлекает имя ключа, которое начинается с первого символа в строке и расширяется для количества символов, возвращаемых при вызове IndexOf метода. The call to the Substring(Int32, Int32) method extracts the key name, which starts from the first character in the string and extends for the number of characters returned by the call to the IndexOf method. Substring(Int32)Затем вызов метода извлекает значение, присвоенное ключу. The call to the Substring(Int32) method then extracts the value assigned to the key. Он начинается с одной позиции символа за знаком равенства и расширяется до конца строки. It starts at one character position beyond the equals character and extends to the end of the string.

Комментарии

Метод вызывается Substring(Int32, Int32) для извлечения подстроки из строки, которая начинается с указанной позиции символа и заканчивается до конца строки. You call the Substring(Int32, Int32) method to extract a substring from a string that begins at a specified character position and ends before the end of the string. Начальная позиции символа начинается с нуля; Иными словами, первый символ в строке находится по индексу 0, а не к индексу 1. The starting character position is a zero-based; in other words, the first character in the string is at index 0, not index 1. Чтобы извлечь подстроку, которая начинается с указанной позиции символа и продолжается до конца строки, вызовите Substring(Int32) метод. To extract a substring that begins at a specified character position and continues to the end of the string, call the Substring(Int32) method.

Этот метод не изменяет значение текущего экземпляра. This method does not modify the value of the current instance. Вместо этого он возвращает новую строку с length символами, начиная с startIndex положения в текущей строке. Instead, it returns a new string with length characters starting from the startIndex position in the current string.

length Параметр представляет общее число символов, извлекаемых из текущего экземпляра строки. The length parameter represents the total number of characters to extract from the current string instance. Сюда входит начальный символ, найденный по индексу startIndex . This includes the starting character found at index startIndex . Иными словами, Substring метод пытается извлечь символы из индекса startIndex в индекс startIndex + length -1. In other words, the Substring method attempts to extract characters from index startIndex to index startIndex + length — 1.

Чтобы извлечь подстроку, которая начинается с определенного символа или последовательности символов, вызовите метод, например IndexOf или, LastIndexOf чтобы получить значение startIndex . To extract a substring that begins with a particular character or character sequence, call a method such as IndexOf or LastIndexOf to get the value of startIndex .

Если подстрока расширяется startIndex до указанной последовательности символов, можно вызвать метод, например IndexOf или, LastIndexOf чтобы получить индекс конечного символа или последовательности символов. If the substring extends from startIndex to a specified character sequence, you can call a method such as IndexOf or LastIndexOf to get the index of the ending character or character sequence. Затем это значение можно преобразовать в индекс в строке следующим образом: You can then convert that value to an index position in the string as follows:

Если вы искали один символ, который должен помечать конец подстроки, length параметр равен endIndex — startIndex + 1, где endIndex — возвращаемое значение IndexOf IndexOf метода или. If you’ve searched for a single character that is to mark the end of the substring, the length parameter equals endIndex — startIndex + 1, where endIndex is the return value of the IndexOf or IndexOf method. В следующем примере извлекается непрерывный блок символов «b» из строки. The following example extracts a continuous block of «b» characters from a string.

Если вы искали несколько символов, которые помечают конец подстроки, length параметр равен endIndex + endMatchLength — startIndex , где endIndex — возвращаемое значение IndexOf IndexOf метода или, а endMatchLength — Длина последовательности символов, которая отмечает конец подстроки. If you’ve searched for multiple characters that are to mark the end of the substring, the length parameter equals endIndex + endMatchLength — startIndex , where endIndex is the return value of the IndexOf or IndexOf method, and endMatchLength is the length of the character sequence that marks the end of the substring. В следующем примере извлекается блок текста, содержащий элемент XML. The following example extracts a block of text that contains an XML element.

Если символ или последовательность символов не включена в конец подстроки, length параметр равен endIndex — startIndex , где endIndex — возвращаемое значение IndexOf IndexOf метода или. If the character or character sequence is not included in the end of the substring, the length parameter equals endIndex — startIndex , where endIndex is the return value of the IndexOf or IndexOf method.

Если startIndex значение равно нулю и равно длине текущей строки, метод возвращает исходную строку без изменений. If startIndex is equal to zero and equals the length of the current string, the method returns the original string unchanged.

Урок 12 по VBScript: Строковые функции vbs

В этой статье рассмотрены строковые функции vbs сценариев, которые могут пригодиться при написании собственного текстового редактора или, просто, при работе со строковыми значениями и с символами. Для каждой функции я написал vbs сценарий, и дал ссылку на архив для скачивания.

Строковые функции vbs

Asc(str) – С помощью этой строковой функции vbs можно получить ASCII-код первого символа в строке str. Параметр str может быть пробелом или содержать только один символ.

Chr(code) – Данная vbs строковая функция позволяет получить символ, указав в качестве параметра его ASCII-код

InStr([start,] str1, str2 [, compare]) – позволяет определить позицию, с которой начинается искомая последовательность символов в заданной строчке.

Start – данный аргумент является числом, и задает позицию, начиная с которой надо начать поиск. Если аргумент отсутствует, то поиск производится с начала.
string1 – собственно, та строка, в которой надо произвести поиск.
string2 – тут мы задаем те символы, которые ищем.
compare – данный параметр может принимать значения vbBinaryCompare (учет регистра, значение 0) и vbTextCompare (без учета регистра, значение 1).

InStrRev(strl, str2[, start [, compare]] ) – Аналогично работе предыдущей строковой vbs функции, но поиск идет в обратном порядке.

Join(list[, delim]) – позволяет объединить все значения элементов массива в одну строку. Тут list – одномерный массив, а delim – необязательный параметр, который задает символ разделитель.

LCase(str) – Позволяет преобразовать все символы к нижнему регистру.

UCase(str) — Позволяет преобразовать все символы к верхнему регистру.

Left(str, len) – Вернёт заданное количество (len) знаков с начала строки str.

Right(str, len) — Вернёт заданное количество (len) знаков с конца строки str.

Len(str) – Использование этой строковой функции vbs позволяет определить количество знаков в str.

LTrim(str) — удаление пробелов в начале.

RTrim(str) — удаление пробелов в конце.

Trim(str) – удаление пробелов в начале и в конце.

Space(x) — Просто формирует строчку из пробелов количеством x.

String(number, char) – Формирование строчки, которая состоит из заданного количества (number) определенных символов (char).

Mid(str, start [, len]) – Формирование из строчки str подстрочки, которая будет начинаться с позиции start, параметр len позволяет указать длину. Строковые функции vbs.

Replace(str, find, replacewith [, start[, count[, compare]]]) – Позволяет производит замену в строке.

str – начальная строка.
find – подстрока, которую мы ищем.
replacewith – подставляемое значение.
start – начало поиска.
count – количество замен, по умолчанию стоит -1, что говорит о полной замене.
compare – параметр принимает значения vbBinaryCompare (учет регистра, значение 0) и vbTextCompare (без учета регистра, значение 1).

Split(str[, delim[, count[, compare]]]) – Производит парсинг строки на подстроки и заполняет ими возвращаемый массив.

str – строка для обработки.
delim – разделитель (по умолчанию — пробел).
count – количество, по умолчанию – значение -1 (все элементы).
compare — параметр принимает значения vbBinaryCompare (учет регистра, значение 0) и vbTextCompare (без учета регистра, значение 1).

StrComp(str1, str2[, compare]) – функция сравнения str1 строки и строки str2. Если они равны, возвращается 0, если str1 str2 – возвращается 1. Параметр compare принимает значения vbBinaryCompare (учет регистра, значение 0) и vbTextCompare (без учёта регистра, значение 1). Строковые функции vbs.

Благодарю всех за внимание, надеюсь, материал статьи был для вас полезным.

Спасибо за внимание. Автор блога Владимир Баталий