Функции Left, Mid и Right в PowerAppsLeft, Mid, and Right functions in PowerApps

Извлекают левую, среднюю или правую часть текстовой строки.Extracts the left, middle, or right portion of a string of text.

ОписаниеDescription

Функции Left, Mid и Right возвращают часть строки.The Left, Mid, and Right functions return a portion of a string.

  • Left возвращает начальные символы строки.Left returns the beginning characters of a string.
  • Mid возвращает средние символы строки.Mid returns the middle characters of a string.
  • Right возвращает конечные символы строки.Right returns the ending characters of a string.

При указании в качестве аргумента одной строки функция возвращает запрошенную часть этой строки.If you specify a single string as an argument, the function returns the portion that you requested of the string. Если в качестве аргумента указана таблица из одного столбца со строками, функция возвращает таблицу из одного столбца с запрошенными частями соответствующих строк исходной таблицы.If you specify a single-column table that contains strings, the function returns a single-column table of the portions that you requested of those strings. Если указана таблица с несколькими столбцами, ее можно преобразовать в таблицу из одного столбца, как указано в разделе Работа с таблицами.If you specify a multi-column table, you can shape it into a single-column table, as working with tables describes.

Если начальная позиция отрицательна или за пределами строки, Mid возвращает пустое значение.If the starting position is negative or beyond the end of the string, Mid returns blank. Проверить длину строки можно с помощью функции Len.You can check the length of a string by using the Len function. При запросе большего количества символов, чем есть в строке, функция вернет максимальное возможное количество символов.If you request more characters than the string contains, the function returns as many characters as possible.

СинтаксисSyntax

Left( строка, количество_символов )Left( String, NumberOfCharacters )
Mid( строка, начальная_позиция, количество_символов )Mid( String, StartingPosition, NumberOfCharacters )
Right( строка, количество_символов )Right( String, NumberOfCharacters )

  • Строка — обязательный аргумент.String - Required. Строка, из которой нужно извлечь результат.The string to from which to extract the result.
  • Начальная_позиция — обязательный аргумент (только для функции Mid).StartingPosition - Required (Mid only). Начальная позиция в строке.The starting position. Первый символ строки находится в позиции 1.The first character of the string is position 1.
  • Количество_символов — обязательный аргумент.NumberOfCharacters - Required. Число возвращаемых символов.The number of characters to return.

Left( таблица_с_одним_столбцом, количество_символов )Left( SingleColumnTable, NumberOfCharacters )
Mid( таблица_с_одним_столбцом, начальная_позиция, количество_символов )Mid( SingleColumnTable, StartingPosition, NumberOfCharacters )
Right( таблица_с_одним_столбцом, количество_символов )Right( SingleColumnTable, NumberOfCharacters )

  • SingleColumnTable — обязательный аргумент.SingleColumnTable - Required. Таблица с одним столбцом, из которой нужно извлечь результаты.A single-column table of strings from which to extract the results.
  • Начальная_позиция — обязательный аргумент (только для функции Mid).StartingPosition - Required (Mid only). Начальная позиция в строке.The starting position. Первый символ строки находится в позиции 1.The first character of the string is position 1.
  • Количество_символов — обязательный аргумент.NumberOfCharacters - Required. Число возвращаемых символов.The number of characters to return.

ПримерыExamples

Одна строкаSingle string

Примеры в этом разделе используют в качестве источника данных элемент управления для ввода текста.The examples in this section use a text-input control as their data source. Элемент управления называется Author и содержит строку "И.The control is named Author and contains the string "E. И.E. Иванов".Cummings".

ФормулаFormula ОписаниеDescription Возвращаемый результатResult
Left ( Author.Text 5 )Left( Author.Text, 5 ) Извлекает до пяти символов от начала строки.Extracts up to five characters from the start of the string. "И."E. И."E."
Mid ( Author.Text, 7, 4 )Mid( Author.Text, 7, 4 ) Извлекает до четырех символов, начиная с седьмого знака в строке.Extracts up to four characters, starting with the seventh character, from the string. "Иван""Cumm"
Right (Author.Text 5)Right( Author.Text, 5 ) Извлекает до пяти знаков с конца строки.Extracts up to five characters from the end of the string. "ванов""mings"

Для таблицы с одним столбцомSingle-column table

Каждый пример в этом разделе извлекает строки из столбца Address источника данных с именем People и возвращает таблицу из одного столбца с результатами:Each example in this section extracts strings from the Address column of this data source, named People, and returns a single-column table that contains the results:

ФормулаFormula ОписаниеDescription Возвращаемый результатResult
Left( ShowColumns( People, "Address" ), 8 )Left( ShowColumns( People, "Address" ), 8 ) Извлекает первые восемь символов каждой строки.Extracts the first eight characters of each string.
Mid( ShowColumns( People, "Address" ), 5, 7 )Mid( ShowColumns( People, "Address" ), 5, 7 ) Извлекает средние семь символов каждой строки, начиная с пятого символа.Extracts the middle seven characters of each string, starting with the fifth character.
Right( ShowColumns( People, "Address" ), 7 )Right( ShowColumns( People, "Address" ), 7 ) Извлекает последние семь символов каждой строки.Extracts the last seven characters of each string.

Пошаговый примерStep-by-step example

  1. Импортируйте или создайте коллекцию с именем Inventory, затем покажите ее в коллекции, как это описано в первой процедуре раздела Показ изображений и текстов в коллекции.Import or create a collection named Inventory, and show it in a gallery, as the first procedure in Show images and text in a gallery describes.
  2. Задайте в свойстве Text нижней метки в коллекции следующую функцию:Set the Text property of the lower label in the gallery to this function:

    Right(ThisItem.ProductName, 3)Right(ThisItem.ProductName, 3)

    Метка будет показывать три последних символа названия каждого продукта.The label shows the last three characters of each product name.