tensorflow::ops::Substr

#include <string_ops.h>

Возвращает подстроки из Tensor строк.

Summary

Для каждой строки во входном Tensor, создаёт подстроку, начинающуюся с индекса pos с общей длиной len.

Если len определяет подстроку, которая выходит за пределы длины входной строки, или если len отрицательно, то используется как можно больше символов.

Отрицательный pos указывает расстояние внутри строки назад от конца.

Если pos указывает индекс, который выходит за пределы диапазона для любой из входных строк, то генерируется InvalidArgumentError.

pos и len должны иметь одинаковую форму, в противном случае при создании операции возникает ValueError.

ПРИМЕЧАНИЕ: Substr поддерживает векторизацию до двух измерений. Подробнее о векторизации здесь

Примеры

Использование скалярных pos и len:

input = [b'Hello', b'World']
position = 1
length = 3

output = [b'ell', b'orl']

Использование pos и len с той же формой, что и input:

input = [[b'ten', b'eleven', b'twelve'],
         [b'thirteen', b'fourteen', b'fifteen'],
         [b'sixteen', b'seventeen', b'eighteen']]
position = [[1, 2, 3],
            [1, 2, 3],
            [1, 2, 3]]
length =   [[2, 3, 4],
            [4, 3, 2],
            [5, 5, 5]]

output = [[b'en', b'eve', b'lve'],
          [b'hirt', b'urt', b'te'],
          [b'ixtee', b'vente', b'hteen']]

Векторизация pos и len на input:

input = [[b'ten', b'eleven', b'twelve'],
         [b'thirteen', b'fourteen', b'fifteen'],
         [b'sixteen', b'seventeen', b'eighteen'],
         [b'nineteen', b'twenty', b'twentyone']]
position = [1, 2, 3]
length =   [1, 2, 3]

output = [[b'e', b'ev', b'lve'],
          [b'h', b'ur', b'tee'],
          [b'i', b've', b'hte'],
          [b'i', b'en', b'nty']]

Векторизация input на pos и len:

input = b'thirteen'
position = [1, 5, 7]
length =   [3, 2, 1]

output = [b'hir', b'ee', b'n']

Возбуждает исключения:

• ValueError: Если первый аргумент не может быть преобразован в Tensor типа dtype string.
• InvalidArgumentError: Если индексы выходят за пределы диапазона.
• ValueError: Если pos и len не имеют одинаковую форму.

Аргументы:

• scope: Объект Scope
• input: Tensor строк
• pos: Скаляр, определяющий позицию первого символа в каждой подстроке
• len: Скаляр, определяющий количество символов для включения в каждую подстроку

Необязательные атрибуты (см. Attrs):

• unit: Единица, используемая для создания подстроки. Одна из: "BYTE" (для определения позиции и длины в байтах) или "UTF8_CHAR" (для кодовых точек UTF-8 кодированных Юникода). По умолчанию "BYTE". Результаты не определены, если unit=UTF8_CHAR и строки input не содержат структурно корректного UTF-8.

Возвращает:

• Output: Tensor подстрок

Общедоступные атрибуты

Operation operation

::tensorflow::Output output

Общедоступные функции

 Substr(
  const ::tensorflow::Scope & scope,
  ::tensorflow::Input input,
  ::tensorflow::Input pos,
  ::tensorflow::Input len
)

 Substr(
  const ::tensorflow::Scope & scope,
  ::tensorflow::Input input,
  ::tensorflow::Input pos,
  ::tensorflow::Input len,
  const Substr::Attrs & attrs
)

::tensorflow::Node * node() const 

operator::tensorflow::Input() const 

operator::tensorflow::Output() const 

Общедоступные статические функции

Attrs Unit(
  StringPiece x
)