numpy.chararray

class numpy.chararray[source]

提供了一个方便的查看数组的字符串和unicode值。

注意

存在chararray类以向后兼容Numarray，因此不推荐用于新开发。Starting from numpy 1.4, if one needs arrays of strings, it is recommended to use arrays of dtype object_, string_ or unicode_, and use the free functions in the numpy.char module for fast vectorized string operations.

与类型str或unicode的常规Numpy数组相比，此类添加了以下功能：

值将在索引时自动从结尾处删除空格

比较运算符在比较值时从结尾自动删除空格

向量化字符串操作作为方法（例如endswith）和中缀运算符（例如，“+”， “*”， “％”）

应使用numpy.char.array或numpy.char.asarray创建chararrays，而不是直接使用此构造函数。

如果不是None，则此构造函数使用缓冲区（偏移和strides）创建数组。如果缓冲区为None，则在“C顺序”中构建一个新的数组与strides，除非len ）＆gt； = 2和order='Fortran'，在这种情况下strides

参数：	shape：tuple 数组的形状。 itemsize：int，可选每个数组元素的长度，以字符数表示。默认值为1。 unicode：bool，可选是数组元素类型unicode（True）或字符串（False）。默认值为False。缓冲：int，可选数组数据的起始的内存地址。默认值为None，在这种情况下创建一个新的数据组。 offset：int，可选固定步幅位移从一个轴的开始？默认值为0。需要> = 0。 strides：array_like of ints，可选数组的步幅（有关完整说明，请参阅`ndarray.strides`）。默认值为None。 order：{'C'，'F'}，可选数组数据存储在存储器中的顺序：'C' - >“行主”顺序（默认），'F' - >“列主”（Fortran）顺序。

参数：

shape：tuple

数组的形状。

itemsize：int，可选

每个数组元素的长度，以字符数表示。默认值为1。

unicode：bool，可选

是数组元素类型unicode（True）或字符串（False）。默认值为False。

缓冲：int，可选

数组数据的起始的内存地址。默认值为None，在这种情况下创建一个新的数据组。

offset：int，可选

固定步幅位移从一个轴的开始？默认值为0。需要> = 0。

strides：array_like of ints，可选

数组的步幅（有关完整说明，请参阅ndarray.strides）。默认值为None。

order：{'C'，'F'}，可选

数组数据存储在存储器中的顺序：'C' - >“行主”顺序（默认），'F' - >“列主”（Fortran）顺序。

例子

>>> charar = np.chararray((3, 3))
>>> charar[:] = 'a'
>>> charar
chararray([['a', 'a', 'a'],
       ['a', 'a', 'a'],
       ['a', 'a', 'a']],
      dtype='|S1')

>>> charar = np.chararray(charar.shape, itemsize=5)
>>> charar[:] = 'abc'
>>> charar
chararray([['abc', 'abc', 'abc'],
       ['abc', 'abc', 'abc'],
       ['abc', 'abc', 'abc']],
      dtype='|S5')

属性

`T`	与self.transpose()相同，除非self是self.ndim返回
`base`	如果内存是来自某个其他对象的基本对象。
`ctypes`	一个对象，用于简化数组与ctypes模块的交互。
`data`	Python缓冲区对象指向数组的数据的开始。
`dtype`	数组元素的数据类型。
`flags`	有关数组的内存布局的信息。
`flat`	数组上的1-D迭代器。
`imag`	数组的虚部。
`itemsize`	一个数组元素的长度（以字节为单位）。
`nbytes`	数组的元素消耗的总字节数。
`ndim`	数组尺寸数。
`real`	数组的真实部分。
`shape`	数组维数组。
`size`	数组中的元素数。
`strides`	遍历数组时，在每个维度中步进的字节数组。

方法

`astype`（dtype [，order，casting，subok，copy]）	数组的复制，强制转换为指定的类型。
`copy`（[order]）	返回数组的副本。
`count`（sub [，start，end]）	返回一个数组，其中在[开始，结束]范围内具有子串sub的不重叠出现次数。
`decode`（[encoding，errors]）	逐个调用`str.decode`。
`dump`（file）	将数组的pickle转储到指定的文件。
`dumps`()	以字符串形式返回数组的pickle。
`encode`（[encoding，errors]）	逐个调用`str.encode`。
`endswith`（suffix [，start，end]）	返回True的布尔数组，self中的字符串元素以后缀结尾，否则False。
`expandtabs`（[tabsize]）	返回每个字符串元素的副本，其中所有制表符字符都由一个或多个空格替换。
`fill`（value）	使用标量值填充数组。
`find`（sub [，start，end]）	对于每个元素，返回字符串中找到子字符串sub的最低索引。
`flatten`（[order]）	将折叠的数组的副本返回到一个维度。
`getfield`（dtype [，offset]）	将给定数组的字段返回为特定类型。
`index`（sub [，start，end]）	像`find`，但在找不到子字符串时引发ValueError。
`isalnum`()	如果字符串中的所有字符都是字母数字，并且至少有一个字符，则为每个元素返回true，否则返回false。
`isalpha`()	如果字符串中的所有字符都是字母并且至少有一个字符，则为每个元素返回true，否则返回false。
`isdecimal`()	对于self中的每个元素，如果元素中只有十进制字符，则返回True。
`isdigit`()	如果字符串中的所有字符都是数字，并且至少有一个字符，则返回true，否则返回false。
`islower`()	如果字符串中的所有封装字符都是小写字符，并且至少有一个套接字符，则返回true，否则返回false。
`isnumeric`()	对于self中的每个元素，如果元素中只有数字字符，则返回True。
`isspace`()	如果字符串中只有空格字符并且至少有一个字符，则为每个元素返回true，否则返回false。
`istitle`()	如果元素是一个已滴定的字符串并且至少有一个字符，则为每个元素返回true，否则返回false。
`isupper`()	如果字符串中所有包含字符的字符都是大写且至少有一个字符，则返回true，否则返回false。
`item`（\ * args）	将数组的元素复制到标准Python标量并返回。
`join`（seq）	返回一个字符串，它是序列seq中字符串的并置。
`ljust`（width [，fillchar]）	返回一个数组，元素self在长度宽度的字符串中左对齐。
`lower`()	返回一个数组，其中元素self转换为小写。
`lstrip`（[chars]）	对于self中的每个元素，返回一个删除了前导字符的副本。
`nonzero`()	返回非零元素的索引。
`put`（indices，values [，mode]）	对于所有n，设置`a.flat [n] = 在指数。`
`ravel`（[order]）	返回展平的数组。
`repeat`（重复[，轴]）	重复数组的元素。
`replace`（old，new [，count]）	对于self中的每个元素，返回一个字符串的副本，其中所有出现的子字符串old替换为`new`。
`reshape`（shape [，order]）	返回包含具有新形状的相同数据的数组。
`resize`（new_shape [，refcheck]）	就地更改数组的形状和大小。
`rfind`（sub [，start，end]）	For each element in self, return the highest index in the string where substring sub is found, such that sub is contained within [start, end].
`rindex`（sub [，start，end]）	像`rfind`，但当找不到子字符串sub时，会引发ValueError。
`rjust`（width [，fillchar]）	返回具有self元素的数组，在长度width的字符串中右对齐。
`rsplit`（[sep，maxsplit]）	对于self中的每个元素，使用sep作为分隔符字符串返回字符串中的单词列表。
`rstrip`（[chars]）	对于self中的每个元素，返回一个删除了尾随字符的副本。
`searchsorted`（v [，side，sorter]）	查找索引，其中v的元素应插入到a以维持顺序。
`setfield`	将值放入由数据类型定义的字段中的指定位置。
`setflags`（[write，align，uic]）	分别设置数组标志WRITEABLE，ALIGNED和UPDATEIFCOPY。
`sort`（[axis，kind，order]）	就地对数组进行排序。
`split`（[sep，maxsplit]）	对于self中的每个元素，使用sep作为分隔符字符串返回字符串中的单词列表。
`splitlines`（[keepends]）	对于self中的每个元素，返回元素中的行的列表，在行边界处断开。
`squeeze`（[axis]）	从a形状中删除单维条目。
`startswith`（prefix [，start，end]）	返回True的布尔数组，其中self中的字符串元素以前缀开头，否则为False。
`strip`（[chars]）	对于self中的每个元素，返回一个删除前导和尾随字符的副本。
`swapaxes`（axis1，axis2）	返回数组的视图，其中axis1和axis2互换。
`swapcase`()	对于self中的每个元素，返回大写字符的字符串的副本转换为小写，反之亦然。
`take`（indices [，axis，out，mode]）	返回由给定索引处的a元素组成的数组。
`title`()	对于self中的每个元素，返回字符串的缩排版本：字词以大写字符开头，所有剩余的套用字符都是小写字母。
`tofile`（fid [，sep，format]）	将数组作为文本或二进制（默认）写入文件。
`tolist`()	将数组返回为（可能是嵌套的）列表。
`tostring`（[order]）	在数组中构造包含原始数据字节的Python字节。
`translate`（table [，deletechars]）	对于self中的每个元素，返回字符串的副本，其中可选参数deletechars中出现的所有字符都将被删除，其余字符已通过给定的转换表。
`transpose`（\ * axes）	返回具有轴转置的数组的视图。
`upper`()	返回具有转换为大写的self元素的数组。
`view`（[dtype，type]）	数组的新视图与相同的数据。
`zfill`（width）	返回长度width的字符串中以零填充的数字字符串。

argsort