Substr

החזר מחרוזות משנה מ'טנזור' של מחרוזות.

עבור כל מחרוזת בקלט `Tensor`, יוצרת תת-מחרוזת שמתחילה באינדקס `pos` באורך כולל של `len`.

אם `len` מגדיר תת-מחרוזת שתתרחב מעבר לאורך מחרוזת הקלט, או אם `len` הוא שלילי, אזי נעשה שימוש בכמה שיותר תווים.

'pos' שלילי מציין מרחק בתוך המחרוזת לאחור מהקצה.

אם 'pos' מציין אינדקס שהוא מחוץ לטווח עבור כל אחת ממחרוזות הקלט, אזי נזרק 'InvalidArgumentError'.

`pos` ו-`len` חייבות להיות באותה צורה, אחרת `ValueError` נזרק ביצירת Op.

הערה : `strings.Substr` תומך בשידור עד שני ממדים. עוד על שידור [כאן](http://docs.scipy.org/doc/numpy/user/basics.broadcasting.html)

---

דוגמאות

שימוש ב-`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']]
 

שידור ` קלט` על `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` אינם אותה צורה.