numpy.fromstring#

numpy.fromstring(string, dtype=float, count=-1, *, sep, like=None)#

從字串中的文字資料初始化的新 1-D 陣列。

參數:
stringstr

包含資料的字串。

dtype資料類型,選用

陣列的資料類型;預設值:float。對於二進位輸入資料,資料必須完全符合此格式。大多數內建數值類型都受支援,且可能支援擴充類型。

countint,選用

從資料中讀取此數量的 dtype 元素。如果此值為負數(預設值),則計數將根據資料長度決定。

sepstr,選用

分隔資料中數字的字串;元素之間多餘的空白也會被忽略。

版本 1.14 開始棄用:傳遞 sep='' (預設值) 已被棄用,因為它會觸發此函數的棄用二進位模式。此模式將 string 解釋為二進位位元組,而不是帶有十進制數字的 ASCII 文字,此操作最好拼寫為 frombuffer(string, dtype, count)。如果 string 包含 unicode 文字,fromstring 的二進位模式將首先使用 utf-8 將其編碼為位元組,這不會產生合理的結果。

likearray_like,選用

參考物件,允許建立非 NumPy 陣列的陣列。如果作為 like 傳入的類陣列物件支援 __array_function__ 協定,則結果將由其定義。在這種情況下,它可以確保建立與透過此引數傳入的物件相容的陣列物件。

版本 1.20.0 新增。

傳回值:
arrndarray

建構的陣列。

引發:
ValueError

如果字串的大小不正確,無法滿足要求的 dtypecount

範例

>>> import numpy as np
>>> np.fromstring('1 2', dtype=int, sep=' ')
array([1, 2])
>>> np.fromstring('1, 2', dtype=int, sep=',')
array([1, 2])