将給定值轉換為張量。
該函數将各種類型的Python對象轉換為張量對象。它接受張量對象、數字數組、Python清單和Python标量。例如:
這個函數在用Python編寫新操作時非常有用(如上面示例中的my_func)。所有标準的Python op構造函數都将此函數應用于它們的每個張量值輸入,這使得這些ops除了接受張量對象外,還可以接受numpy數組、Python清單和标量。
注意:當Python清單或标量中不存在浮點數和字元串類型時,此函數與預設Numpy行為不同。将抛出一個錯誤,而不是靜靜地轉換None值。
參數:
<code>value</code>:類型具有注冊張量轉換函數的對象。
dtype:傳回張量的可選元素類型。如果缺少,則從值的類型推斷類型。
name:建立新張量時使用的可選名稱。
preferred_dtype:傳回張量的可選元素類型,當dtype為None時使用。在某些情況下,調用者在轉換為張量時可能沒有考慮到dtype,是以preferred_dtype可以用作軟首選項。如果轉換為preferred_dtype是不可能的,則此參數沒有效果。
dtype_hint:與preferred_dtype含義相同,并覆寫它。
傳回值:
一個基于值的張量。
可能産生的異常:
<code>TypeError</code>: If no conversion function is registered for <code>value</code> to <code>dtype</code>.
<code>RuntimeError</code>: If a registered conversion function returns an invalid value.
<code>ValueError</code>: If the <code>value</code> is a tensor not of given <code>dtype</code> in graph mode.