OwlCyberSecurity - MANAGER
Edit File: defchararray.cpython-38.pyc
U �p�]T � 3 @ s� d Z ddlmZmZmZ ddlZddlZddlmZm Z m Z m Z m Z m Z ddlmZmZ ddlmZ ddlmZ dd lmZ dd lmZ dd lmZmZ ddl Z d d ddddddddddddddd d d d d d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>g3Z da ej d d?k�r(e Z!e"Z#ne$Z!e Z#e%Z&ej'ej(d@dA�Z(dBdC� Z)dDdE� Z*dFdG� Z+dHdI� Z,dJdK� Z-e(e-�dLd � �Z.e(e-�dMd � �Z/e(e-�dNd� �Z0e(e-�dOd� �Z1e(e-�dPd� �Z2e(e-�dQd� �Z3dRdS� Z4e(e4�dTd� �Z5e(e-�dUd� �Z6dVdW� Z7e(e7�dXd� �Z8dYdZ� Z9e(e9�d[d� �Z:e(e4�d\d� �Z;d�d]d^�Z<e(e<�d�d`d��Z=d�dadb�Z>e(e>�d�dcd��Z?d�ddde�Z@e(e@�d�dfd��ZAe(e@�d�dgd��ZBd�dhdi�ZCe(eC�d�djd��ZDd�dkdl�ZEe(eE�d�dnd ��ZFe(e>�d�dod ��ZGe(e>�d�dpd ��ZHe(e4�dqd � �ZIe(e4�drd � �ZJe(e4�dsd!� �ZKe(e4�dtd"� �ZLe(e4�dud#� �ZMe(e4�dvd$� �ZNe(e4�dwd%� �ZOdxdy� ZPe(eP�dzd&� �ZQd�d{d|�ZRe(eR�d�d}d'��ZSe(e4�d~d(� �ZTd�dd��ZUe(eU�d�d�d)��ZVd�d�� ZWe(eW�d�d*� �ZXd�d�d��ZYe(eY�d�d�d+��ZZe(e>�d�d�d,��Z[e(e>�d�d�d-��Z\e(eR�d�d�d.��Z]e(eW�d�d/� �Z^d�d�d��Z_e(e_�d�d�d0��Z`d�d�d��ZUe(eU�d�d�d1��Zae(e_�d�d�d2��Zbd�d�d��Zce(ec�d�d�d3��Zdd�d�d��Zee(ee�d�d�d4��Zfe(eU�d�d�d5��Zge(e4�d�d6� �Zhe(e4�d�d7� �Zid�d�d��Zje(ej�d�d�d8��Zke(e4�d�d9� �Zld�d�� Zme(em�d�d:� �Zne(e4�d�d;� �Zoe(e4�d�d<� �Zped��G d�d�� d�e��Zqd�d�d=�Zd�d�d>�ZrdS )�as This module contains a set of functions for vectorized string operations and methods. .. note:: The `chararray` class exists for backwards compatibility with Numarray, it is not recommended for new development. 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. Some methods will only be available if the corresponding string method is available in your version of Python. The preferred alias for `defchararray` is `numpy.char`. � )�division�absolute_import�print_functionN� )�string_�unicode_�integer�object_�bool_� character)�ndarray�compare_chararrays��array)� _vec_string)� set_module)� overrides)�asbytes�long�equal� not_equal� greater_equal� less_equal�greater�less�str_len�add�multiply�mod� capitalize�center�count�decode�encode�endswith� expandtabs�find�index�isalnum�isalpha�isdigit�islower�isspace�istitle�isupper�join�ljust�lower�lstrip� partition�replace�rfind�rindex�rjust� rpartition�rsplit�rstrip�split� splitlines� startswith�strip�swapcase�title� translate�upper�zfill� isnumeric� isdecimalr �asarray� z numpy.char)�modulec G s4 | D ]*}t |t�s&tt�|�jjt�rt S qtS )z� Helper function for determining the output type of some string operations. For an operation on two ndarrays, if at least one is unicode, the result should be unicode. ) � isinstance�_unicode� issubclass�numpyrF �dtype�typer r )�args�x� rQ �9/usr/lib/python3/dist-packages/numpy/core/defchararray.py� _use_unicode9 s � rS c C s t �| �� �S )z� Helper function to cast a result back into a string or unicode array if an object array must be used as an intermediary. )rL rF �tolist)�resultrQ rQ rR �_to_string_or_unicode_arrayG s rV c G s( g }| D ]}|dkr q$|� |� q|S )a# Helper function for delegating arguments to Python string functions. Many of the Python string operations that have optional arguments do not use 'None' to indicate a default value. In these cases, we need to remove all `None` arguments, and those following them. N)�append)rO ZnewargsZchkrQ rQ rR � _clean_argsN s rX c C s t | jjt�r| jd S | jS )z� Helper function that returns the number of characters per field in a string or unicode array. This is to abstract out the fact that for a unicode array this is itemsize / 4. � )rK rM rN r �itemsize��arQ rQ rR �_get_num_chars^ s r] c C s | |fS �NrQ ��x1�x2rQ rQ rR �_binary_op_dispatcheri s rb c C s t | |dd�S )a4 Return (x1 == x2) element-wise. Unlike `numpy.equal`, this comparison is performed by first stripping whitespace characters from the end of the string. This behavior is provided for backward-compatibility with numarray. Parameters ---------- x1, x2 : array_like of str or unicode Input arrays of the same shape. Returns ------- out : ndarray or bool Output array of bools, or a single bool if x1 and x2 are scalars. See Also -------- not_equal, greater_equal, less_equal, greater, less z==T�r r_ rQ rQ rR r m s c C s t | |dd�S )a4 Return (x1 != x2) element-wise. Unlike `numpy.not_equal`, this comparison is performed by first stripping whitespace characters from the end of the string. This behavior is provided for backward-compatibility with numarray. Parameters ---------- x1, x2 : array_like of str or unicode Input arrays of the same shape. Returns ------- out : ndarray or bool Output array of bools, or a single bool if x1 and x2 are scalars. See Also -------- equal, greater_equal, less_equal, greater, less z!=Trc r_ rQ rQ rR r � s c C s t | |dd�S )a7 Return (x1 >= x2) element-wise. Unlike `numpy.greater_equal`, this comparison is performed by first stripping whitespace characters from the end of the string. This behavior is provided for backward-compatibility with numarray. Parameters ---------- x1, x2 : array_like of str or unicode Input arrays of the same shape. Returns ------- out : ndarray or bool Output array of bools, or a single bool if x1 and x2 are scalars. See Also -------- equal, not_equal, less_equal, greater, less z>=Trc r_ rQ rQ rR r � s c C s t | |dd�S )a4 Return (x1 <= x2) element-wise. Unlike `numpy.less_equal`, this comparison is performed by first stripping whitespace characters from the end of the string. This behavior is provided for backward-compatibility with numarray. Parameters ---------- x1, x2 : array_like of str or unicode Input arrays of the same shape. Returns ------- out : ndarray or bool Output array of bools, or a single bool if x1 and x2 are scalars. See Also -------- equal, not_equal, greater_equal, greater, less z<=Trc r_ rQ rQ rR r � s c C s t | |dd�S )a3 Return (x1 > x2) element-wise. Unlike `numpy.greater`, this comparison is performed by first stripping whitespace characters from the end of the string. This behavior is provided for backward-compatibility with numarray. Parameters ---------- x1, x2 : array_like of str or unicode Input arrays of the same shape. Returns ------- out : ndarray or bool Output array of bools, or a single bool if x1 and x2 are scalars. See Also -------- equal, not_equal, greater_equal, less_equal, less �>Trc r_ rQ rQ rR r � s c C s t | |dd�S )a6 Return (x1 < x2) element-wise. Unlike `numpy.greater`, this comparison is performed by first stripping whitespace characters from the end of the string. This behavior is provided for backward-compatibility with numarray. Parameters ---------- x1, x2 : array_like of str or unicode Input arrays of the same shape. Returns ------- out : ndarray or bool Output array of bools, or a single bool if x1 and x2 are scalars. See Also -------- equal, not_equal, greater_equal, less_equal, greater �<Trc r_ rQ rQ rR r � s c C s | fS r^ rQ r[ rQ rQ rR �_unary_op_dispatcher s rf c C s t | td�S )z� Return len(a) element-wise. Parameters ---------- a : array_like of str or unicode Returns ------- out : ndarray Output array of integers See also -------- __builtin__.len �__len__)r r r[ rQ rQ rR r s c C sB t �| �}t �|�}t|�t|� }t||�}t|||fd|f�S )a� Return element-wise string concatenation for two arrays of str or unicode. Arrays `x1` and `x2` must have the same shape. Parameters ---------- x1 : array_like of str or unicode Input array. x2 : array_like of str or unicode Input array. Returns ------- add : ndarray Output array of `string_` or `unicode_`, depending on input types of the same shape as `x1` and `x2`. �__add__)rL rF r] rS r )r` ra Zarr1Zarr2�out_sizerM rQ rQ rR r # s c C s | fS r^ rQ )r\ �irQ rQ rR �_multiply_dispatcher? s rk c C s\ t �| �}t �|�}t|jjt�s*td��t|�tt |�� �d� }t ||jj|fd|f�S )av Return (a * i), that is string multiple concatenation, element-wise. Values in `i` of less than 0 are treated as 0 (which yields an empty string). Parameters ---------- a : array_like of str or unicode i : array_like of ints Returns ------- out : ndarray Output array of str or unicode, depending on input types z Can only multiply by integersr �__mul__) rL rF rK rM rN r � ValueErrorr] �maxr r )r\ rj �a_arrZi_arrri rQ rQ rR r C s �c C s | |fS r^ rQ �r\ �valuesrQ rQ rR �_mod_dispatchera s rr c C s t t| td|f��S )a� Return (a % i), that is pre-Python 2.6 string formatting (iterpolation), element-wise for a pair of array_likes of str or unicode. Parameters ---------- a : array_like of str or unicode values : array_like of values These values will be element-wise interpolated into the string. Returns ------- out : ndarray Output array of str or unicode, depending on input types See also -------- str.__mod__ �__mod__�rV r r rp rQ rQ rR r e s �c C s t �| �}t||jd�S )a� Return a copy of `a` with only the first character of each element capitalized. Calls `str.capitalize` element-wise. For 8-bit strings, this method is locale-dependent. Parameters ---------- a : array_like of str or unicode Input array of strings to capitalize. Returns ------- out : ndarray Output array of str or unicode, depending on input types See also -------- str.capitalize Examples -------- >>> c = np.array(['a1b2','1b2a','b2a1','2a1b'],'S4'); c array(['a1b2', '1b2a', 'b2a1', '2a1b'], dtype='|S4') >>> np.char.capitalize(c) array(['A1b2', '1b2a', 'B2a1', '2a1b'], dtype='|S4') r �rL rF r rM �r\ ro rQ rQ rR r � s # c C s | fS r^ rQ �r\ �width�fillcharrQ rQ rR �_center_dispatcher� s rz � c C sV t �| �}t �|�}tt �|j��}t �|jt j�r<t|�}t ||jj |fd||f�S )a Return a copy of `a` with its elements centered in a string of length `width`. Calls `str.center` element-wise. Parameters ---------- a : array_like of str or unicode width : int The length of the resulting strings fillchar : str or unicode, optional The padding character to use (default is space). Returns ------- out : ndarray Output array of str or unicode, depending on input types See also -------- str.center r � rL rF r rn �flatZ issubdtyperM r r r rN �r\ rx ry ro � width_arr�sizerQ rQ rR r � s �c C s | fS r^ rQ �r\ �sub�start�endrQ rQ rR �_count_dispatcher� s r� c C s t | td||gt|� �S )a� Returns an array with the number of non-overlapping occurrences of substring `sub` in the range [`start`, `end`]. Calls `str.count` element-wise. Parameters ---------- a : array_like of str or unicode sub : str or unicode The substring to search for. start, end : int, optional Optional arguments `start` and `end` are interpreted as slice notation to specify the range in which to count. Returns ------- out : ndarray Output array of ints. See also -------- str.count Examples -------- >>> c = np.array(['aAaAaA', ' aA ', 'abBABba']) >>> c array(['aAaAaA', ' aA ', 'abBABba'], dtype='<U7') >>> np.char.count(c, 'A') array([3, 1, 1]) >>> np.char.count(c, 'aA') array([3, 1, 0]) >>> np.char.count(c, 'A', start=1, end=4) array([2, 1, 1]) >>> np.char.count(c, 'A', start=1, end=3) array([1, 0, 0]) r! �r r rX r� rQ rQ rR r! � s +c C s | fS r^ rQ �r\ �encoding�errorsrQ rQ rR �_code_dispatcher s r� c C s t t| tdt||���S )a} Calls `str.decode` element-wise. The set of available codecs comes from the Python standard library, and may be extended at runtime. For more information, see the :mod:`codecs` module. Parameters ---------- a : array_like of str or unicode encoding : str, optional The name of an encoding errors : str, optional Specifies how to handle encoding errors Returns ------- out : ndarray See also -------- str.decode Notes ----- The type of the result will depend on the encoding specified. Examples -------- >>> c = np.array(['aAaAaA', ' aA ', 'abBABba']) >>> c array(['aAaAaA', ' aA ', 'abBABba'], dtype='<U7') >>> np.char.encode(c, encoding='cp037') array(['\x81\xc1\x81\xc1\x81\xc1', '@@\x81\xc1@@', '\x81\x82\xc2\xc1\xc2\x82\x81'], dtype='|S7') r" �rV r r rX r� rQ rQ rR r" s *�c C s t t| tdt||���S )aA Calls `str.encode` element-wise. The set of available codecs comes from the Python standard library, and may be extended at runtime. For more information, see the codecs module. Parameters ---------- a : array_like of str or unicode encoding : str, optional The name of an encoding errors : str, optional Specifies how to handle encoding errors Returns ------- out : ndarray See also -------- str.encode Notes ----- The type of the result will depend on the encoding specified. r# r� r� rQ rQ rR r# 5 s �c C s | fS r^ rQ �r\ �suffixr� r� rQ rQ rR �_endswith_dispatcherY s r� c C s t | td||gt|� �S )a5 Returns a boolean array which is `True` where the string element in `a` ends with `suffix`, otherwise `False`. Calls `str.endswith` element-wise. Parameters ---------- a : array_like of str or unicode suffix : str start, end : int, optional With optional `start`, test beginning at that position. With optional `end`, stop comparing at that position. Returns ------- out : ndarray Outputs an array of bools. See also -------- str.endswith Examples -------- >>> s = np.array(['foo', 'bar']) >>> s[0] = 'foo' >>> s[1] = 'bar' >>> s array(['foo', 'bar'], dtype='<U3') >>> np.char.endswith(s, 'ar') array([False, True]) >>> np.char.endswith(s, 'a', start=1, end=2) array([False, True]) r$ �r r rX r� rQ rQ rR r$ ] s ( �c C s | fS r^ rQ �r\ �tabsizerQ rQ rR �_expandtabs_dispatcher� s r� � c C s t t| td|f��S )aS Return a copy of each string element where all tab characters are replaced by one or more spaces. Calls `str.expandtabs` element-wise. Return a copy of each string element where all tab characters are replaced by one or more spaces, depending on the current column and the given `tabsize`. The column number is reset to zero after each newline occurring in the string. This doesn't understand other non-printing characters or escape sequences. Parameters ---------- a : array_like of str or unicode Input array tabsize : int, optional Replace tabs with `tabsize` number of spaces. If not given defaults to 8 spaces. Returns ------- out : ndarray Output array of str or unicode, depending on input type See also -------- str.expandtabs r% rt r� rQ rQ rR r% � s �c C s t | td||gt|� �S )a� For each element, return the lowest index in the string where substring `sub` is found. Calls `str.find` element-wise. For each element, return the lowest index in the string where substring `sub` is found, such that `sub` is contained in the range [`start`, `end`]. Parameters ---------- a : array_like of str or unicode sub : str or unicode start, end : int, optional Optional arguments `start` and `end` are interpreted as in slice notation. Returns ------- out : ndarray or int Output array of ints. Returns -1 if `sub` is not found. See also -------- str.find r& r� r� rQ rQ rR r& � s �c C s t | td||gt|� �S )a� Like `find`, but raises `ValueError` when the substring is not found. Calls `str.index` element-wise. Parameters ---------- a : array_like of str or unicode sub : str or unicode start, end : int, optional Returns ------- out : ndarray Output array of ints. Returns -1 if `sub` is not found. See also -------- find, str.find r' r� r� rQ rQ rR r' � s �c C s t | td�S )a� Returns true for each element if all characters in the string are alphanumeric and there is at least one character, false otherwise. Calls `str.isalnum` element-wise. For 8-bit strings, this method is locale-dependent. Parameters ---------- a : array_like of str or unicode Returns ------- out : ndarray Output array of str or unicode, depending on input type See also -------- str.isalnum r( �r r r[ rQ rQ rR r( � s c C s t | td�S )a� Returns true for each element if all characters in the string are alphabetic and there is at least one character, false otherwise. Calls `str.isalpha` element-wise. For 8-bit strings, this method is locale-dependent. Parameters ---------- a : array_like of str or unicode Returns ------- out : ndarray Output array of bools See also -------- str.isalpha r) r� r[ rQ rQ rR r) s c C s t | td�S )a� Returns true for each element if all characters in the string are digits and there is at least one character, false otherwise. Calls `str.isdigit` element-wise. For 8-bit strings, this method is locale-dependent. Parameters ---------- a : array_like of str or unicode Returns ------- out : ndarray Output array of bools See also -------- str.isdigit r* r� r[ rQ rQ rR r* & s c C s t | td�S )a� Returns true for each element if all cased characters in the string are lowercase and there is at least one cased character, false otherwise. Calls `str.islower` element-wise. For 8-bit strings, this method is locale-dependent. Parameters ---------- a : array_like of str or unicode Returns ------- out : ndarray Output array of bools See also -------- str.islower r+ r� r[ rQ rQ rR r+ @ s c C s t | td�S )a� Returns true for each element if there are only whitespace characters in the string and there is at least one character, false otherwise. Calls `str.isspace` element-wise. For 8-bit strings, this method is locale-dependent. Parameters ---------- a : array_like of str or unicode Returns ------- out : ndarray Output array of bools See also -------- str.isspace r, r� r[ rQ rQ rR r, [ s c C s t | td�S )a� Returns true for each element if the element is a titlecased string and there is at least one character, false otherwise. Call `str.istitle` element-wise. For 8-bit strings, this method is locale-dependent. Parameters ---------- a : array_like of str or unicode Returns ------- out : ndarray Output array of bools See also -------- str.istitle r- r� r[ rQ rQ rR r- v s c C s t | td�S )a� Returns true for each element if all cased characters in the string are uppercase and there is at least one character, false otherwise. Call `str.isupper` element-wise. For 8-bit strings, this method is locale-dependent. Parameters ---------- a : array_like of str or unicode Returns ------- out : ndarray Output array of bools See also -------- str.isupper r. r� r[ rQ rQ rR r. � s c C s | |fS r^ rQ ��sep�seqrQ rQ rR �_join_dispatcher� s r� c C s t t| td|f��S )a� Return a string which is the concatenation of the strings in the sequence `seq`. Calls `str.join` element-wise. Parameters ---------- sep : array_like of str or unicode seq : array_like of str or unicode Returns ------- out : ndarray Output array of str or unicode, depending on input types See also -------- str.join r/ rt r� rQ rQ rR r/ � s �c C s | fS r^ rQ rw rQ rQ rR �_just_dispatcher� s r� c C sV t �| �}t �|�}tt �|j��}t �|jt j�r<t|�}t ||jj |fd||f�S )a� Return an array with the elements of `a` left-justified in a string of length `width`. Calls `str.ljust` element-wise. Parameters ---------- a : array_like of str or unicode width : int The length of the resulting strings fillchar : str or unicode, optional The character to use for padding Returns ------- out : ndarray Output array of str or unicode, depending on input type See also -------- str.ljust r0 r| r~ rQ rQ rR r0 � s �c C s t �| �}t||jd�S )ag Return an array with the elements converted to lowercase. Call `str.lower` element-wise. For 8-bit strings, this method is locale-dependent. Parameters ---------- a : array_like, {str, unicode} Input array. Returns ------- out : ndarray, {str, unicode} Output array of str or unicode, depending on input type See also -------- str.lower Examples -------- >>> c = np.array(['A1B C', '1BCA', 'BCA1']); c array(['A1B C', '1BCA', 'BCA1'], dtype='<U5') >>> np.char.lower(c) array(['a1b c', '1bca', 'bca1'], dtype='<U5') r1 ru rv rQ rQ rR r1 � s c C s | fS r^ rQ �r\ �charsrQ rQ rR �_strip_dispatcher s r� c C s t �| �}t||jd|f�S )am For each element in `a`, return a copy with the leading characters removed. Calls `str.lstrip` element-wise. Parameters ---------- a : array-like, {str, unicode} Input array. chars : {str, unicode}, optional The `chars` argument is a string specifying the set of characters to be removed. If omitted or None, the `chars` argument defaults to removing whitespace. The `chars` argument is not a prefix; rather, all combinations of its values are stripped. Returns ------- out : ndarray, {str, unicode} Output array of str or unicode, depending on input type See also -------- str.lstrip Examples -------- >>> c = np.array(['aAaAaA', ' aA ', 'abBABba']) >>> c array(['aAaAaA', ' aA ', 'abBABba'], dtype='<U7') The 'a' variable is unstripped from c[1] because whitespace leading. >>> np.char.lstrip(c, 'a') array(['AaAaA', ' aA ', 'bBABba'], dtype='<U7') >>> np.char.lstrip(c, 'A') # leaves c unchanged array(['aAaAaA', ' aA ', 'abBABba'], dtype='<U7') >>> (np.char.lstrip(c, ' ') == np.char.lstrip(c, '')).all() ... # XXX: is this a regression? This used to return True ... # np.char.lstrip(c,'') does not modify c at all. False >>> (np.char.lstrip(c, ' ') == np.char.lstrip(c, None)).all() True r2 ru �r\ r� ro rQ rQ rR r2 s 3 c C s | fS r^ rQ �r\ r� rQ rQ rR �_partition_dispatcherP s r� c C s t t| td|f��S )aU Partition each element in `a` around `sep`. Calls `str.partition` element-wise. For each element in `a`, split the element as the first occurrence of `sep`, and return 3 strings containing the part before the separator, the separator itself, and the part after the separator. If the separator is not found, return 3 strings containing the string itself, followed by two empty strings. Parameters ---------- a : array_like, {str, unicode} Input array sep : {str, unicode} Separator to split each string element in `a`. Returns ------- out : ndarray, {str, unicode} Output array of str or unicode, depending on input type. The output array will have an extra dimension with 3 elements per input element. See also -------- str.partition r3 rt r� rQ rQ rR r3 T s �c C s | fS r^ rQ �r\ �old�newr! rQ rQ rR �_replace_dispatcherx s r� c C s t t| td||gt|� ��S )a% For each element in `a`, return a copy of the string with all occurrences of substring `old` replaced by `new`. Calls `str.replace` element-wise. Parameters ---------- a : array-like of str or unicode old, new : str or unicode count : int, optional If the optional argument `count` is given, only the first `count` occurrences are replaced. Returns ------- out : ndarray Output array of str or unicode, depending on input type See also -------- str.replace r4 r� r� rQ rQ rR r4 | s ��c C s t | td||gt|� �S )a. For each element in `a`, return the highest index in the string where substring `sub` is found, such that `sub` is contained within [`start`, `end`]. Calls `str.rfind` element-wise. Parameters ---------- a : array-like of str or unicode sub : str or unicode start, end : int, optional Optional arguments `start` and `end` are interpreted as in slice notation. Returns ------- out : ndarray Output array of ints. Return -1 on failure. See also -------- str.rfind r5 r� r� rQ rQ rR r5 � s �c C s t | td||gt|� �S )ax Like `rfind`, but raises `ValueError` when the substring `sub` is not found. Calls `str.rindex` element-wise. Parameters ---------- a : array-like of str or unicode sub : str or unicode start, end : int, optional Returns ------- out : ndarray Output array of ints. See also -------- rfind, str.rindex r6 r� r� rQ rQ rR r6 � s �c C sV t �| �}t �|�}tt �|j��}t �|jt j�r<t|�}t ||jj |fd||f�S )a� Return an array with the elements of `a` right-justified in a string of length `width`. Calls `str.rjust` element-wise. Parameters ---------- a : array_like of str or unicode width : int The length of the resulting strings fillchar : str or unicode, optional The character to use for padding Returns ------- out : ndarray Output array of str or unicode, depending on input type See also -------- str.rjust r7 r| r~ rQ rQ rR r7 � s �c C s t t| td|f��S )af Partition (split) each element around the right-most separator. Calls `str.rpartition` element-wise. For each element in `a`, split the element as the last occurrence of `sep`, and return 3 strings containing the part before the separator, the separator itself, and the part after the separator. If the separator is not found, return 3 strings containing the string itself, followed by two empty strings. Parameters ---------- a : array_like of str or unicode Input array sep : str or unicode Right-most separator to split each element in array. Returns ------- out : ndarray Output array of string or unicode, depending on input type. The output array will have an extra dimension with 3 elements per input element. See also -------- str.rpartition r8 rt r� rQ rQ rR r8 s �c C s | fS r^ rQ �r\ r� �maxsplitrQ rQ rR �_split_dispatcher$ s r� c C s t | td|gt|� �S )a� For each element in `a`, return a list of the words in the string, using `sep` as the delimiter string. Calls `str.rsplit` element-wise. Except for splitting from the right, `rsplit` behaves like `split`. Parameters ---------- a : array_like of str or unicode sep : str or unicode, optional If `sep` is not specified or `None`, any whitespace string is a separator. maxsplit : int, optional If `maxsplit` is given, at most `maxsplit` splits are done, the rightmost ones. Returns ------- out : ndarray Array of list objects See also -------- str.rsplit, split r9 �r r rX r� rQ rQ rR r9 ( s " �c C s | fS r^ rQ r� rQ rQ rR r� N s c C s t �| �}t||jd|f�S )a� For each element in `a`, return a copy with the trailing characters removed. Calls `str.rstrip` element-wise. Parameters ---------- a : array-like of str or unicode chars : str or unicode, optional The `chars` argument is a string specifying the set of characters to be removed. If omitted or None, the `chars` argument defaults to removing whitespace. The `chars` argument is not a suffix; rather, all combinations of its values are stripped. Returns ------- out : ndarray Output array of str or unicode, depending on input type See also -------- str.rstrip Examples -------- >>> c = np.array(['aAaAaA', 'abBABba'], dtype='S7'); c array(['aAaAaA', 'abBABba'], dtype='|S7') >>> np.char.rstrip(c, b'a') array(['aAaAaA', 'abBABb'], dtype='|S7') >>> np.char.rstrip(c, b'A') array(['aAaAa', 'abBABba'], dtype='|S7') r: ru r� rQ rQ rR r: R s ) c C s t | td|gt|� �S )a8 For each element in `a`, return a list of the words in the string, using `sep` as the delimiter string. Calls `str.split` element-wise. Parameters ---------- a : array_like of str or unicode sep : str or unicode, optional If `sep` is not specified or `None`, any whitespace string is a separator. maxsplit : int, optional If `maxsplit` is given, at most `maxsplit` splits are done. Returns ------- out : ndarray Array of list objects See also -------- str.split, rsplit r; r� r� rQ rQ rR r; s �c C s | fS r^ rQ �r\ �keependsrQ rQ rR �_splitlines_dispatcher� s r� c C s t | tdt|��S )a� For each element in `a`, return a list of the lines in the element, breaking at line boundaries. Calls `str.splitlines` element-wise. Parameters ---------- a : array_like of str or unicode keepends : bool, optional Line breaks are not included in the resulting list unless keepends is given and true. Returns ------- out : ndarray Array of list objects See also -------- str.splitlines r< r� r� rQ rQ rR r< � s �c C s | fS r^ rQ �r\ �prefixr� r� rQ rQ rR �_startswith_dispatcher� s r� c C s t | td||gt|� �S )a Returns a boolean array which is `True` where the string element in `a` starts with `prefix`, otherwise `False`. Calls `str.startswith` element-wise. Parameters ---------- a : array_like of str or unicode prefix : str start, end : int, optional With optional `start`, test beginning at that position. With optional `end`, stop comparing at that position. Returns ------- out : ndarray Array of booleans See also -------- str.startswith r= r� r� rQ rQ rR r= � s �c C s t �| �}t||jdt|��S )a� For each element in `a`, return a copy with the leading and trailing characters removed. Calls `str.strip` element-wise. Parameters ---------- a : array-like of str or unicode chars : str or unicode, optional The `chars` argument is a string specifying the set of characters to be removed. If omitted or None, the `chars` argument defaults to removing whitespace. The `chars` argument is not a prefix or suffix; rather, all combinations of its values are stripped. Returns ------- out : ndarray Output array of str or unicode, depending on input type See also -------- str.strip Examples -------- >>> c = np.array(['aAaAaA', ' aA ', 'abBABba']) >>> c array(['aAaAaA', ' aA ', 'abBABba'], dtype='<U7') >>> np.char.strip(c) array(['aAaAaA', 'aA', 'abBABba'], dtype='<U7') >>> np.char.strip(c, 'a') # 'a' unstripped from c[1] because whitespace leads array(['AaAaA', ' aA ', 'bBABb'], dtype='<U7') >>> np.char.strip(c, 'A') # 'A' unstripped from c[1] because (unprinted) ws trails array(['aAaAa', ' aA ', 'abBABba'], dtype='<U7') r> )rL rF r rM rX r� rQ rQ rR r> � s ) c C s t �| �}t||jd�S )a� Return element-wise a copy of the string with uppercase characters converted to lowercase and vice versa. Calls `str.swapcase` element-wise. For 8-bit strings, this method is locale-dependent. Parameters ---------- a : array_like, {str, unicode} Input array. Returns ------- out : ndarray, {str, unicode} Output array of str or unicode, depending on input type See also -------- str.swapcase Examples -------- >>> c=np.array(['a1B c','1b Ca','b Ca1','cA1b'],'S5'); c array(['a1B c', '1b Ca', 'b Ca1', 'cA1b'], dtype='|S5') >>> np.char.swapcase(c) array(['A1b C', '1B cA', 'B cA1', 'Ca1B'], dtype='|S5') r? ru rv rQ rQ rR r? s " c C s t �| �}t||jd�S )a� Return element-wise title cased version of string or unicode. Title case words start with uppercase characters, all remaining cased characters are lowercase. Calls `str.title` element-wise. For 8-bit strings, this method is locale-dependent. Parameters ---------- a : array_like, {str, unicode} Input array. Returns ------- out : ndarray Output array of str or unicode, depending on input type See also -------- str.title Examples -------- >>> c=np.array(['a1b c','1b ca','b ca1','ca1b'],'S5'); c array(['a1b c', '1b ca', 'b ca1', 'ca1b'], dtype='|S5') >>> np.char.title(c) array(['A1B C', '1B Ca', 'B Ca1', 'Ca1B'], dtype='|S5') r@ ru rv rQ rQ rR r@ ; s $ c C s | fS r^ rQ )r\ �table� deletecharsrQ rQ rR �_translate_dispatcherc s r� c C sH t �| �}t|jjt�r*t||jd|f�S t||jd|gt|� �S dS )a, For each element in `a`, return a copy of the string where all characters occurring in the optional argument `deletechars` are removed, and the remaining characters have been mapped through the given translation table. Calls `str.translate` element-wise. Parameters ---------- a : array-like of str or unicode table : str of length 256 deletechars : str Returns ------- out : ndarray Output array of str or unicode, depending on input type See also -------- str.translate rA N)rL rF rK rM rN r r rX )r\ r� r� ro rQ rQ rR rA g s � �c C s t �| �}t||jd�S )ah Return an array with the elements converted to uppercase. Calls `str.upper` element-wise. For 8-bit strings, this method is locale-dependent. Parameters ---------- a : array_like, {str, unicode} Input array. Returns ------- out : ndarray, {str, unicode} Output array of str or unicode, depending on input type See also -------- str.upper Examples -------- >>> c = np.array(['a1b c', '1bca', 'bca1']); c array(['a1b c', '1bca', 'bca1'], dtype='<U5') >>> np.char.upper(c) array(['A1B C', '1BCA', 'BCA1'], dtype='<U5') rB ru rv rQ rQ rR rB � s c C s | fS r^ rQ )r\ rx rQ rQ rR �_zfill_dispatcher� s r� c C s< t �| �}t �|�}tt �|j��}t||jj|fd|f�S )a� Return the numeric string left-filled with zeros Calls `str.zfill` element-wise. Parameters ---------- a : array_like, {str, unicode} Input array. width : int Width of string to left-fill elements in `a`. Returns ------- out : ndarray, {str, unicode} Output array of str or unicode, depending on input type See also -------- str.zfill rC )rL rF r rn r} r rM rN )r\ rx ro r r� rQ rQ rR rC � s �c C s t | �tkrtd��t| td�S )a For each element, return True if there are only numeric characters in the element. Calls `unicode.isnumeric` element-wise. Numeric characters include digit characters, and all characters that have the Unicode numeric value property, e.g. ``U+2155, VULGAR FRACTION ONE FIFTH``. Parameters ---------- a : array_like, unicode Input array. Returns ------- out : ndarray, bool Array of booleans of same shape as `a`. See also -------- unicode.isnumeric �:isnumeric is only available for Unicode strings and arraysrD �rS r � TypeErrorr r r[ rQ rQ rR rD � s c C s t | �tkrtd��t| td�S )a! For each element, return True if there are only decimal characters in the element. Calls `unicode.isdecimal` element-wise. Decimal characters include digit characters, and all characters that that can be used to form decimal-radix numbers, e.g. ``U+0660, ARABIC-INDIC DIGIT ZERO``. Parameters ---------- a : array_like, unicode Input array. Returns ------- out : ndarray, bool Array of booleans identical in shape to `a`. See also -------- unicode.isdecimal r� rE r� r[ rQ rQ rR rE � s rL c @ s e Zd ZdZdxdd�Zd d � Zd d � Zd d� Zdd� Zdd� Z dd� Z dd� Z dd� Z dd� Z dd � Zd d � Zd d � Zd!d"� Zd#d$� Zdyd&d'�Zejje_d(d)� Zdzd+d,�Zd{d-d.�Zd|d/d0�Zd}d1d2�Zd~d3d4�Zdd6d7�Zd�d8d9�Z d�d:d;�Z d<d=� Z d>d?� Z d@dA� Z dBdC� Z!dDdE� Z"dFdG� Z#dHdI� Z$dJdK� Z%d�dLdM�Z&dNdO� Z'd�dPdQ�Z(dRdS� Z)d�dTdU�Z*d�dVdW�Z+d�dXdY�Z,d�dZd[�Z-d\d]� Z.d�d^d_�Z/d�d`da�Z0d�dbdc�Z1d�ddde�Z2d�dfdg�Z3d�dhdi�Z4djdk� Z5dldm� Z6d�dndo�Z7dpdq� Z8drds� Z9dtdu� Z:dvdw� Z;dS )�� chararraya� chararray(shape, itemsize=1, unicode=False, buffer=None, offset=0, strides=None, order=None) Provides a convenient view on arrays of string and unicode values. .. note:: The `chararray` class exists for backwards compatibility with Numarray, it is not recommended for new development. 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. Versus a regular NumPy array of type `str` or `unicode`, this class adds the following functionality: 1) values automatically have whitespace removed from the end when indexed 2) comparison operators automatically remove whitespace from the end when comparing values 3) vectorized string operations are provided as methods (e.g. `.endswith`) and infix operators (e.g. ``"+", "*", "%"``) chararrays should be created using `numpy.char.array` or `numpy.char.asarray`, rather than this constructor directly. This constructor creates the array, using `buffer` (with `offset` and `strides`) if it is not ``None``. If `buffer` is ``None``, then constructs a new array with `strides` in "C order", unless both ``len(shape) >= 2`` and ``order='Fortran'``, in which case `strides` is in "Fortran order". Methods ------- astype argsort copy count decode dump dumps encode endswith expandtabs fill find flatten getfield index isalnum isalpha isdecimal isdigit islower isnumeric isspace istitle isupper item join ljust lower lstrip nonzero put ravel repeat replace reshape resize rfind rindex rjust rsplit rstrip searchsorted setfield setflags sort split splitlines squeeze startswith strip swapaxes swapcase take title tofile tolist tostring translate transpose upper view zfill Parameters ---------- shape : tuple Shape of the array. itemsize : int, optional Length of each array element, in number of characters. Default is 1. unicode : bool, optional Are the array elements of type unicode (True) or string (False). Default is False. buffer : int, optional Memory address of the start of the array data. Default is None, in which case a new array is created. offset : int, optional Fixed stride displacement from the beginning of an axis? Default is 0. Needs to be >=0. strides : array_like of ints, optional Strides for the array (see `ndarray.strides` for full description). Default is None. order : {'C', 'F'}, optional The order in which the array data is stored in memory: 'C' -> "row major" order (the default), 'F' -> "column major" (Fortran) order. Examples -------- >>> charar = np.chararray((3, 3)) >>> charar[:] = 'a' >>> charar chararray([[b'a', b'a', b'a'], [b'a', b'a', b'a'], [b'a', b'a', b'a']], dtype='|S1') >>> charar = np.chararray(charar.shape, itemsize=5) >>> charar[:] = 'abc' >>> charar chararray([[b'abc', b'abc', b'abc'], [b'abc', b'abc', b'abc'], [b'abc', b'abc', b'abc']], dtype='|S5') r FNr �Cc C s� |r t }nt}t|�}tjd dkr8t|t�r8|} d }nd } da|d kr`tj | |||f|d�} n tj | |||f||||d�} | d k r�| | d< da| S )Nr rG r ��order)�buffer�offset�stridesr� .) r r r �sys� version_inforI rJ � _globalvarr �__new__) Zsubtype�shaperZ �unicoder� r� r� r� rM Zfiller�selfrQ rQ rR r� � s. � �zchararray.__new__c C s t s| jjdkrtd��d S )NZSUbcz-Can only create a chararray from string data.)r� rM �charrm )r� �objrQ rQ rR �__array_finalize__� s z chararray.__array_finalize__c C s8 t �| |�}t|t�r4|�� }t|�dkr0d}n|}|S )Nr � )r � __getitem__rI r r: �_len)r� r� �valZtemprQ rQ rR r� � s zchararray.__getitem__c C s t | |�S )zg Return (self == other) element-wise. See also -------- equal )r �r� �otherrQ rQ rR �__eq__� s zchararray.__eq__c C s t | |�S )zk Return (self != other) element-wise. See also -------- not_equal )r r� rQ rQ rR �__ne__� s zchararray.__ne__c C s t | |�S )zo Return (self >= other) element-wise. See also -------- greater_equal )r r� rQ rQ rR �__ge__� s zchararray.__ge__c C s t | |�S )zl Return (self <= other) element-wise. See also -------- less_equal )r r� rQ rQ rR �__le__� s zchararray.__le__c C s t | |�S )zh Return (self > other) element-wise. See also -------- greater )r r� rQ rQ rR �__gt__ s zchararray.__gt__c C s t | |�S )ze Return (self < other) element-wise. See also -------- less )r r� rQ rQ rR �__lt__ s zchararray.__lt__c C s t t| |��S )z� Return (self + other), that is string concatenation, element-wise for a pair of array_likes of str or unicode. See also -------- add )rF r r� rQ rQ rR rh s zchararray.__add__c C s t tt� |�| ��S )z� Return (other + self), that is string concatenation, element-wise for a pair of array_likes of `string_` or `unicode_`. See also -------- add )rF r rL r� rQ rQ rR �__radd__ s zchararray.__radd__c C s t t| |��S �z� Return (self * i), that is string multiple concatenation, element-wise. See also -------- multiply �rF r �r� rj rQ rQ rR rl * s zchararray.__mul__c C s t t| |��S r� r� r� rQ rQ rR �__rmul__5 s zchararray.__rmul__c C s t t| |��S )z� Return (self % i), that is pre-Python 2.6 string formatting (iterpolation), element-wise for a pair of array_likes of `string_` or `unicode_`. See also -------- mod )rF r r� rQ rQ rR rs @ s zchararray.__mod__c C s t S r^ )�NotImplementedr� rQ rQ rR �__rmod__L s zchararray.__rmod__���c C s | � � �|||�S )a Return the indices that sort the array lexicographically. For full documentation see `numpy.argsort`, for which this method is in fact merely a "thin wrapper." Examples -------- >>> c = np.array(['a1b c', '1b ca', 'b ca1', 'Ca1b'], 'S5') >>> c = c.view(np.chararray); c chararray(['a1b c', '1b ca', 'b ca1', 'Ca1b'], dtype='|S5') >>> c[c.argsort()] chararray(['1b ca', 'Ca1b', 'a1b c', 'b ca1'], dtype='|S5') )Z __array__�argsort)r� ZaxisZkindr� rQ rQ rR r� O s zchararray.argsortc C s t t| ��S )z� Return a copy of `self` with only the first character of each element capitalized. See also -------- char.capitalize )rF r �r� rQ rQ rR r d s zchararray.capitalizer{ c C s t t| ||��S )z� Return a copy of `self` with its elements centered in a string of length `width`. See also -------- center )rF r �r� rx ry rQ rQ rR r p s zchararray.centerc C s t | |||�S )z� Returns an array with the number of non-overlapping occurrences of substring `sub` in the range [`start`, `end`]. See also -------- char.count )r! �r� r� r� r� rQ rQ rR r! { s zchararray.countc C s t | ||�S )zj Calls `str.decode` element-wise. See also -------- char.decode )r" �r� r� r� rQ rQ rR r" � s zchararray.decodec C s t | ||�S )zj Calls `str.encode` element-wise. See also -------- char.encode )r# r� rQ rQ rR r# � s zchararray.encodec C s t | |||�S )z� Returns a boolean array which is `True` where the string element in `self` ends with `suffix`, otherwise `False`. See also -------- char.endswith )r$ )r� r� r� r� rQ rQ rR r$ � s zchararray.endswithr� c C s t t| |��S )z� Return a copy of each string element where all tab characters are replaced by one or more spaces. See also -------- char.expandtabs )rF r% )r� r� rQ rQ rR r% � s zchararray.expandtabsc C s t | |||�S )z� For each element, return the lowest index in the string where substring `sub` is found. See also -------- char.find )r& r� rQ rQ rR r& � s zchararray.findc C s t | |||�S )z� Like `find`, but raises `ValueError` when the substring is not found. See also -------- char.index )r' r� rQ rQ rR r' � s zchararray.indexc C s t | �S )z� Returns true for each element if all characters in the string are alphanumeric and there is at least one character, false otherwise. See also -------- char.isalnum )r( r� rQ rQ rR r( � s zchararray.isalnumc C s t | �S )z� Returns true for each element if all characters in the string are alphabetic and there is at least one character, false otherwise. See also -------- char.isalpha )r) r� rQ rQ rR r) � s zchararray.isalphac C s t | �S )z� Returns true for each element if all characters in the string are digits and there is at least one character, false otherwise. See also -------- char.isdigit )r* r� rQ rQ rR r* � s zchararray.isdigitc C s t | �S )z� Returns true for each element if all cased characters in the string are lowercase and there is at least one cased character, false otherwise. See also -------- char.islower )r+ r� rQ rQ rR r+ � s zchararray.islowerc C s t | �S )z� Returns true for each element if there are only whitespace characters in the string and there is at least one character, false otherwise. See also -------- char.isspace )r, r� rQ rQ rR r, � s zchararray.isspacec C s t | �S )z� Returns true for each element if the element is a titlecased string and there is at least one character, false otherwise. See also -------- char.istitle )r- r� rQ rQ rR r- s zchararray.istitlec C s t | �S )z� Returns true for each element if all cased characters in the string are uppercase and there is at least one character, false otherwise. See also -------- char.isupper )r. r� rQ rQ rR r. s zchararray.isupperc C s t | |�S )z� Return a string which is the concatenation of the strings in the sequence `seq`. See also -------- char.join )r/ )r� r� rQ rQ rR r/ % s zchararray.joinc C s t t| ||��S )z� Return an array with the elements of `self` left-justified in a string of length `width`. See also -------- char.ljust )rF r0 r� rQ rQ rR r0 1 s zchararray.ljustc C s t t| ��S )z� Return an array with the elements of `self` converted to lowercase. See also -------- char.lower )rF r1 r� rQ rQ rR r1 = s zchararray.lowerc C s t t| |��S )z� For each element in `self`, return a copy with the leading characters removed. See also -------- char.lstrip )rF r2 �r� r� rQ rQ rR r2 I s zchararray.lstripc C s t t| |��S )zu Partition each element in `self` around `sep`. See also -------- partition )rF r3 �r� r� rQ rQ rR r3 U s zchararray.partitionc C s t t| |||��S )z� For each element in `self`, return a copy of the string with all occurrences of substring `old` replaced by `new`. See also -------- char.replace )rF r4 )r� r� r� r! rQ rQ rR r4 _ s zchararray.replacec C s t | |||�S )z� 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`]. See also -------- char.rfind )r5 r� rQ rQ rR r5 k s zchararray.rfindc C s t | |||�S )z� Like `rfind`, but raises `ValueError` when the substring `sub` is not found. See also -------- char.rindex )r6 r� rQ rQ rR r6 x s zchararray.rindexc C s t t| ||��S )z� Return an array with the elements of `self` right-justified in a string of length `width`. See also -------- char.rjust )rF r7 r� rQ rQ rR r7 � s zchararray.rjustc C s t t| |��S )zv Partition each element in `self` around `sep`. See also -------- rpartition )rF r8 r� rQ rQ rR r8 � s zchararray.rpartitionc C s t | ||�S )z� For each element in `self`, return a list of the words in the string, using `sep` as the delimiter string. See also -------- char.rsplit )r9 �r� r� r� rQ rQ rR r9 � s zchararray.rsplitc C s t t| |��S )z� For each element in `self`, return a copy with the trailing characters removed. See also -------- char.rstrip )rF r: r� rQ rQ rR r: � s zchararray.rstripc C s t | ||�S )z� For each element in `self`, return a list of the words in the string, using `sep` as the delimiter string. See also -------- char.split )r; r� rQ rQ rR r; � s zchararray.splitc C s t | |�S )z� For each element in `self`, return a list of the lines in the element, breaking at line boundaries. See also -------- char.splitlines )r< )r� r� rQ rQ rR r< � s zchararray.splitlinesc C s t | |||�S )z� Returns a boolean array which is `True` where the string element in `self` starts with `prefix`, otherwise `False`. See also -------- char.startswith )r= )r� r� r� r� rQ rQ rR r= � s zchararray.startswithc C s t t| |��S )z� For each element in `self`, return a copy with the leading and trailing characters removed. See also -------- char.strip )rF r> r� rQ rQ rR r> � s zchararray.stripc C s t t| ��S )z� For each element in `self`, return a copy of the string with uppercase characters converted to lowercase and vice versa. See also -------- char.swapcase )rF r? r� rQ rQ rR r? � s zchararray.swapcasec C s t t| ��S )z� For each element in `self`, return a titlecased version of the string: words start with uppercase characters, all remaining cased characters are lowercase. See also -------- char.title )rF r@ r� rQ rQ rR r@ � s zchararray.titlec C s t t| ||��S )aB For each element in `self`, return a copy of the string where all characters occurring in the optional argument `deletechars` are removed, and the remaining characters have been mapped through the given translation table. See also -------- char.translate )rF rA )r� r� r� rQ rQ rR rA � s zchararray.translatec C s t t| ��S )z� Return an array with the elements of `self` converted to uppercase. See also -------- char.upper )rF rB r� rQ rQ rR rB s zchararray.upperc C s t t| |��S )z� Return the numeric string left-filled with zeros in a string of length `width`. See also -------- char.zfill )rF rC )r� rx rQ rQ rR rC s zchararray.zfillc C s t | �S )z� For each element in `self`, return True if there are only numeric characters in the element. See also -------- char.isnumeric )rD r� rQ rQ rR rD ! s zchararray.isnumericc C s t | �S )z� For each element in `self`, return True if there are only decimal characters in the element. See also -------- char.isdecimal )rE r� rQ rQ rR rE - s zchararray.isdecimal)r FNr Nr� )r� NN)r{ )r N)NN)NN)r N)r� )r N)r N)r{ )N)N)r N)r N)r{ )NN)N)NN)N)r N)N)N)<�__name__� __module__� __qualname__�__doc__r� r� r� r� r� r� r� r� r� rh r� rl r� rs r� r� r r r r! r" r# r$ r% r& r' r( r) r* r+ r, r- r. r/ r0 r1 r2 r3 r4 r5 r6 r7 r8 r9 r: r; r< r= r> r? r@ rA rB rC rD rE rQ rQ rQ rR r� s| � # r� Tc C s t | ttf�r�|dkr*t | t�r&d}nd}|dkr:t| �}t| �| }|rjtjdkr`| �d�} qrt| �} nt| �} t|||| |d�S t | tt f�r�t � | �} t | t ��r�t | jjt��r�t | t�s�| �t�} |dkr�| j}t | jjt�r�|d }|dk�rt | jjt��rd}nd}|�r t}nt}|dk �r<t j | |d�} |�sr|| jk�sr|�s`t | t��sr|�r�t | t��r�| �|t|�f�} | S t | t ��r�t | jjt��r�|dk�r�| �� } |�r�t}nt}|dk�r�t| ||dd �}nt| ||f|dd �}|�t�S ) a� Create a `chararray`. .. note:: This class is provided for numarray backward-compatibility. New code (not concerned with numarray compatibility) should use arrays of type `string_` or `unicode_` and use the free functions in :mod:`numpy.char <numpy.core.defchararray>` for fast vectorized string operations instead. Versus a regular NumPy array of type `str` or `unicode`, this class adds the following functionality: 1) values automatically have whitespace removed from the end when indexed 2) comparison operators automatically remove whitespace from the end when comparing values 3) vectorized string operations are provided as methods (e.g. `str.endswith`) and infix operators (e.g. ``+, *, %``) Parameters ---------- obj : array of str or unicode-like itemsize : int, optional `itemsize` is the number of characters per scalar in the resulting array. If `itemsize` is None, and `obj` is an object array or a Python list, the `itemsize` will be automatically determined. If `itemsize` is provided and `obj` is of type str or unicode, then the `obj` string will be chunked into `itemsize` pieces. copy : bool, optional If true (default), then the object is copied. Otherwise, a copy will only be made if __array__ returns a copy, if obj is a nested sequence, or if a copy is needed to satisfy any of the other requirements (`itemsize`, unicode, `order`, etc.). unicode : bool, optional When true, the resulting `chararray` can contain Unicode characters, when false only 8-bit characters. If unicode is `None` and `obj` is one of the following: - a `chararray`, - an ndarray of type `str` or `unicode` - a Python str or unicode object, then the unicode setting of the output array will be automatically determined. order : {'C', 'F', 'A'}, optional Specify the order of the array. If order is 'C' (default), then the array will be in C-contiguous order (last-index varies the fastest). If order is 'F', then the returned array will be in Fortran-contiguous order (first-index varies the fastest). If order is 'A', then the returned array may be in any order (either C-, Fortran-contiguous, or even discontiguous). NTFi�� �utf_32)rZ r� r� r� rY r� )rM r� Zsubok)rI �_bytesrJ r� r� � maxunicoder# r� �list�tuplerL rF r rK rM rN r ZviewrZ r r Zastyper �objectrT �narray)r� rZ �copyr� r� r� rM r� rQ rQ rR r : st > � ����� c C s t | |d||d�S )a� Convert the input to a `chararray`, copying the data only if necessary. Versus a regular NumPy array of type `str` or `unicode`, this class adds the following functionality: 1) values automatically have whitespace removed from the end when indexed 2) comparison operators automatically remove whitespace from the end when comparing values 3) vectorized string operations are provided as methods (e.g. `str.endswith`) and infix operators (e.g. ``+``, ``*``,``%``) Parameters ---------- obj : array of str or unicode-like itemsize : int, optional `itemsize` is the number of characters per scalar in the resulting array. If `itemsize` is None, and `obj` is an object array or a Python list, the `itemsize` will be automatically determined. If `itemsize` is provided and `obj` is of type str or unicode, then the `obj` string will be chunked into `itemsize` pieces. unicode : bool, optional When true, the resulting `chararray` can contain Unicode characters, when false only 8-bit characters. If unicode is `None` and `obj` is one of the following: - a `chararray`, - an ndarray of type `str` or 'unicode` - a Python str or unicode object, then the unicode setting of the output array will be automatically determined. order : {'C', 'F'}, optional Specify the order of the array. If order is 'C' (default), then the array will be in C-contiguous order (last-index varies the fastest). If order is 'F', then the returned array will be in Fortran-contiguous order (first-index varies the fastest). F)r� r� r� r )r� rZ r� r� rQ rQ rR rF � s 0 �)N)r{ )NN)r N)NN)NN)NN)NN)r N)N)r� )r N)r N)N)r{ )N)N)N)N)r N)r N)r{ )NN)NN)N)N)NN)N)N)NN)r N)N)N)N)NTNN)NNN)sr� Z __future__r r r � functoolsr� Z numerictypesr r r r r r Znumericr r r r� Znumpy.core.multiarrayr Znumpy.core.overridesr Z numpy.corer Z numpy.compatr r rL �__all__r� r� �strrJ �bytesr� r� �lenr� �partialZarray_function_dispatchrS rV rX r] rb r r r r r r rf r r rk r rr r r rz r r� r! r� r" r# r� r$ r� r% r& r' r( r) r* r+ r, r- r. r� r/ r� r0 r1 r� r2 r� r3 r� r4 r5 r6 r7 r8 r� r9 r: r; r� r< r� r= r> r? r@ r� rA rB r� rC rD rE r� rF rQ rQ rQ rR �<module> s� � � & $ - - # + # # # " 6 # # # % , " , % ' $ " -