wgKdZddlZddlmZddlmZmZmZddlm Z m Z m Z ddlmZdd lmZdd ldd lmZdd lmZmZmZmZmZm Z!gd Z"ejFejHdZ$dZ%e$e%dZ&e$e%dZ'e$e%dZ(e$e%dZ)e$e%dZ*e$e%dZ+dZedGdde Z,edddZ edddZ y)an 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_`, `bytes_` or `str_`, 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`. N) set_module)bytes_str_ character)ndarrayarrayasarraycompare_chararrays) overrides)*)multiply) _partition _rpartition_split_rsplit _splitlines_join)5equal not_equal greater_equal less_equalgreaterlessstr_lenaddrmod capitalizecentercountdecodeencodeendswith expandtabsfindindexisalnumisalphaisdigitislowerisspaceistitleisupperjoinljustlowerlstrip partitionreplacerfindrindexrjust rpartitionrsplitrstripsplit splitlines startswithstripswapcasetitle translateupperzfill isnumeric isdecimalr r r chararrayz numpy.char)modulec ||fSNx1x2s ]/home/mcse/projects/flask/flask-venv/lib/python3.12/site-packages/numpy/_core/defchararray.py_binary_op_dispatcherrP5s 8Oct||ddS)ao 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 Output array of bools. Examples -------- >>> y = "aa " >>> x = "aa" >>> np.char.equal(x, y) array(True) See Also -------- not_equal, greater_equal, less_equal, greater, less z==Tr rLs rOrr9< b"dD 11rQct||ddS)a 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 Output array of bools. See Also -------- equal, greater_equal, less_equal, greater, less Examples -------- >>> x1 = np.array(['a', 'b', 'c']) >>> np.char.not_equal(x1, 'b') array([ True, False, True]) z!=Tr rLs rOrrZrSrQct||ddS)a 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 Output array of bools. See Also -------- equal, not_equal, less_equal, greater, less Examples -------- >>> x1 = np.array(['a', 'b', 'c']) >>> np.char.greater_equal(x1, 'b') array([False, True, True]) z>=Tr rLs rOrr{s> b"dD 11rQct||ddS)a 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 Output array of bools. See Also -------- equal, not_equal, greater_equal, greater, less Examples -------- >>> x1 = np.array(['a', 'b', 'c']) >>> np.char.less_equal(x1, 'b') array([ True, True, False]) z<=Tr rLs rOrrrSrQct||ddS)a 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 Output array of bools. See Also -------- equal, not_equal, greater_equal, less_equal, less Examples -------- >>> x1 = np.array(['a', 'b', 'c']) >>> np.char.greater(x1, 'b') array([False, False, True]) >Tr rLs rOrr< b"c4 00rQct||ddS)a 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 Output array of bools. See Also -------- equal, not_equal, greater_equal, less_equal, greater Examples -------- >>> x1 = np.array(['a', 'b', 'c']) >>> np.char.less(x1, 'b') array([True, False, False]) >> a = np.array(["a", "b", "c"]) >>> np.strings.multiply(a, 3) array(['aaa', 'bbb', 'ccc'], dtype='>> i = np.array([1, 2, 3]) >>> np.strings.multiply(a, i) array(['a', 'bb', 'ccc'], dtype='>> np.strings.multiply(np.array(['a']), i) array(['a', 'aa', 'aaa'], dtype='>> a = np.array(['a', 'b', 'c', 'd', 'e', 'f']).reshape((2, 3)) >>> np.strings.multiply(a, 3) array([['aaa', 'bbb', 'ccc'], ['ddd', 'eee', 'fff']], dtype='>> np.strings.multiply(a, i) array([['a', 'bb', 'ccc'], ['d', 'ee', 'fff']], dtype='dZd?dZd@dZd@dZd?dZdAdZd?dZd?dZdZdZ dZ!d Z"d!Z#d"Z$d#Z%d$Z&d>d%Z'd&Z(dBd'Z)d(Z*dBd)Z+d?d*Z,d?d+Z-d>d,Z.d-Z/d@d.Z0dBd/Z1d@d0Z2dBd1Z3d?d2Z4dBd3Z5d4Z6d5Z7dBd6Z8d7Z9d8Z:d9Z;d:Z= 2`` and ``order='F'``, 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 : object exposing the buffer interface or str, 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 `~numpy.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.char.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.char.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') Nc |rt}nt}t|}t|tr|} d}nd} |t j ||||f|} nt j ||||f||||} | | | d<| S)Norder)bufferoffsetstridesre.)rrint isinstancestrr __new__) subtypeshapeitemsizeunicoderfrgrhredtypefillerselfs rOrlzchararray.__new__s EE x= fc "FFF >??7EE83D).0D??7EE83D*0*0').0D  DI rQcj|jjdvr|jt|S|S)NSUbc)rqcharviewtype)rsarrcontext return_scalars rO__array_wrap__zchararray.__array_wrap__s, 99>>V #88DJ' ' rQcJ|jjdvr tdy)Nruz-Can only create a chararray from string data.)rqrvr_)rsobjs rO__array_finalize__zchararray.__array_finalize__s# ::??& (LM M )rQctj||}t|tr$|j }t |dk(rd}|S|}|S)Nr)r __getitem__rjrr;len)rsr~valtemps rOrzchararray.__getitem__sL!!$, c9 %::= other) element-wise. See Also -------- greater_equal )rrs rO__ge__zchararray.__ge__sT5))rQct||S)zl Return (self <= other) element-wise. See Also -------- less_equal )rrs rO__le__zchararray.__le__s$&&rQct||S)zh Return (self > other) element-wise. See Also -------- greater )rrs rO__gt__zchararray.__gt__&stU##rQct||S)ze Return (self < other) element-wise. See Also -------- less )rrs rO__lt__zchararray.__lt__0sD%  rQct||S)z Return (self + other), that is string concatenation, element-wise for a pair of array_likes of str or unicode. See Also -------- add rrs rO__add__zchararray.__add__:s4rQct||S)z Return (other + self), that is string concatenation, element-wise for a pair of array_likes of `bytes_` or `str_`. See Also -------- add rrs rO__radd__zchararray.__radd__Es5$rQc,tt||Sz Return (self * i), that is string multiple concatenation, element-wise. See Also -------- multiply r rrsras rO__mul__zchararray.__mul__Pxa())rQc,tt||Srrrs rO__rmul__zchararray.__rmul__[rrQc,tt||S)z Return (self % i), that is pre-Python 2.6 string formatting (interpolation), element-wise for a pair of array_likes of `bytes_` or `str_`. See Also -------- mod )r rrs rO__mod__zchararray.__mod__fss4|$$rQctSrJ)NotImplementedrs rO__rmod__zchararray.__rmod__rsrQcD|jj|||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.char.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') ) __array__argsort)rsaxiskindres rOrzchararray.argsortus $~~''dE::rQc*tt|S)z Return a copy of `self` with only the first character of each element capitalized. See Also -------- char.capitalize )r r rss rOr zchararray.capitalizesz$'((rQc.tt|||S)z Return a copy of `self` with its elements centered in a string of length `width`. See Also -------- center )r r!rswidthfillchars rOr!zchararray.centersvdE8455rQct||||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"rssubstartends rOr"zchararray.countT3s++rQct|||S)zn Calls ``bytes.decode`` element-wise. See Also -------- char.decode )r#rsencodingerrorss rOr#zchararray.decodedHf--rQct|||S)zp Calls :meth:`str.encode` element-wise. See Also -------- char.encode )r$rs rOr$zchararray.encoderrQct||||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%)rssuffixrrs rOr%zchararray.endswithsfeS11rQc,tt||S)z Return a copy of each string element where all tab characters are replaced by one or more spaces. See Also -------- char.expandtabs )r r&)rstabsizes rOr&zchararray.expandtabssz$011rQct||||S)z For each element, return the lowest index in the string where substring `sub` is found. See Also -------- char.find )r'rs rOr'zchararray.findsD#uc**rQct||||S)z Like `find`, but raises :exc:`ValueError` when the substring is not found. See Also -------- char.index )r(rs rOr(zchararray.indexrrQct|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)rs rOr)zchararray.isalnumt}rQct|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*rs rOr*zchararray.isalpharrQct|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+rs rOr+zchararray.isdigit t}rQct|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,rs rOr,zchararray.islowerrrQct|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-rs rOr-zchararray.isspace&rrQct|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.rs rOr.zchararray.istitle3rrQct|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/rs rOr/zchararray.isupper?rrQct||S)z Return a string which is the concatenation of the strings in the sequence `seq`. See Also -------- char.join )r0)rsseqs rOr0zchararray.joinLsD#rQc.tt|||S)z Return an array with the elements of `self` left-justified in a string of length `width`. See Also -------- char.ljust )r r1rs rOr1zchararray.ljustXuT5(344rQc*tt|S)z Return an array with the elements of `self` converted to lowercase. See Also -------- char.lower )r r2rs rOr2zchararray.lowerduT{##rQct||S)z For each element in `self`, return a copy with the leading characters removed. See Also -------- char.lstrip )r3rscharss rOr3zchararray.lstrippdE""rQc,tt||S)zu Partition each element in `self` around `sep`. See Also -------- partition )r r4rsseps rOr4zchararray.partition|sys+,,rQc.t|||||SdS)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 )r5)rsoldnewr"s rOr5zchararray.replaces"tS#0AuJJrJJrQct||||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 )r6rs rOr6zchararray.rfindsT3s++rQct||||S)z Like `rfind`, but raises :exc:`ValueError` when the substring `sub` is not found. See Also -------- char.rindex )r7rs rOr7zchararray.rindexsdC,,rQc.tt|||S)z Return an array with the elements of `self` right-justified in a string of length `width`. See Also -------- char.rjust )r r8rs rOr8zchararray.rjustrrQc,tt||S)zv Partition each element in `self` around `sep`. See Also -------- rpartition )r r9rs rOr9zchararray.rpartitionsz$,--rQct|||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 )r:rsrmaxsplits rOr:zchararray.rsplitsdC**rQct||S)z For each element in `self`, return a copy with the trailing characters removed. See Also -------- char.rstrip )r;rs rOr;zchararray.rstriprrQct|||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<rs rOr<zchararray.splitsT3))rQct||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=)rskeependss rOr=zchararray.splitliness$))rQct||||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>)rsprefixrrs rOr>zchararray.startswiths$s33rQct||S)z For each element in `self`, return a copy with the leading and trailing characters removed. See Also -------- char.strip )r?rs rOr?zchararray.stripsT5!!rQc*tt|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 )r r@rs rOr@zchararray.swapcase sx~&&rQc*tt|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 )r rArs rOrAzchararray.titlesuT{##rQc.tt|||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 )r rB)rstable deletecharss rOrBzchararray.translate"syuk:;;rQc*tt|S)z Return an array with the elements of `self` converted to uppercase. See Also -------- char.upper )r rCrs rOrCzchararray.upper0rrQc,tt||S)z Return the numeric string left-filled with zeros in a string of length `width`. See Also -------- char.zfill )r rD)rsrs rOrDzchararray.zfill<suT5)**rQct|S)z For each element in `self`, return True if there are only numeric characters in the element. See Also -------- char.isnumeric )rErs rOrEzchararray.isnumericHrQct|S)z For each element in `self`, return True if there are only decimal characters in the element. See Also -------- char.isdecimal )rFrs rOrFzchararray.isdecimalTrrQ)rFNrNC)NF)rNN) )rN)NN)rJ)=__name__ __module__ __qualname____doc__rlr|rrrrrrrrrrrrrrrr r r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8r9r:r;r<r=r>r?r@rArBrCrDrErFrKrQrOrGrG2sAKXCG.1@N ""&*'$!     * * %;&oo--GO ) 6 , . . 2 2 + ,         5 $ #- K , - 5. + # * * 4 " ' $ < $ +  rQrGcht|ttfrB|t|trd}nd}| t|}t||z}t |||||St|t t fr t|}t|trt|jjtrt|ts|jt}|5|j}t|jjtr|dz}|)t|jjtrd}nd}|rt}nt }| t||}|s3||jk7s$|st|ts|r,t|t r|j#|t%|f}|St|tr6t|jjt&r||j)}|rt}nt }|t+|||d}nt+|||f|d}|jtS)a Create a `~numpy.char.chararray`. .. note:: This class is provided for numarray backward-compatibility. New code (not concerned with numarray compatibility) should use arrays of type `bytes_` or `str_` and use the free functions in :mod:`numpy.char` for fast vectorized string operations instead. Versus a NumPy array of dtype `bytes_` or `str_`, 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. `chararray.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 `~numpy.char.chararray` can contain Unicode characters, when false only 8-bit characters. If unicode is None and `obj` is one of the following: - a `~numpy.char.chararray`, - an ndarray of type :class:`str_` or :class:`bytes_` - a Python :class:`str` or :class:`bytes` 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). TF)rorprfrerd)rqresubok)rjbytesrkrrGlisttupleasnarrayr issubclassrqrxrrwrorrastyperiobjecttolistnarray)r~rocopyrprernrqrs rOr r as~#s|$ ?#s#  3xHCH$7 #52 2#e}%sm#wJsyy~~y$I#y)((9%C  ||H#))..$/Q ?#))..$/ EE  3e,C S\\)C!6ZV4**eS]34C #wJsyy~~v$F  **,CSU$?S 1dK 88I rQc"t||d||S)a Convert the input to a `~numpy.char.chararray`, copying the data only if necessary. Versus a NumPy array of dtype `bytes_` or `str_`, 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. `chararray.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 `~numpy.char.chararray` can contain Unicode characters, when false only 8-bit characters. If unicode is None and `obj` is one of the following: - a `~numpy.char.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). Examples -------- >>> np.char.asarray(['hello', 'world']) chararray(['hello', 'world'], dtype='rsa"11BB5!6 ,)++ %%l<./202@./202@./202B./202@./101@./101@/:d Lk k k \ LBBJ L8/8/rQ