Current File : //proc/self/root/opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyo
�
� 9Zc 4 @` s d Z d d l m Z m Z m Z d d l Z d d l m Z m Z m Z m
Z
m Z m Z d d l
m Z m Z d d l
m Z d d l m Z d d l m Z m Z d d l Z d
d d d
d d d d d d d d d d d d d d d d d d d d! d" d# d$ d% d& d' d( d) d* d+ d, d- d. d/ d0 d1 d2 d3 d4 d5 d6 d7 d8 d9 d: d; d< d= g4 Z d a e j d d> k r~e Z e Z n e Z e Z e Z! d? � Z" d@ � Z# dA � Z$ dB � Z% dC � Z& dD � Z' dE � Z( dF � Z) dG � Z* dH � Z+ dI � Z, dJ � Z- dK � Z. dL � Z/ dM � Z0 dN dO � Z1 d e2 dP � Z3 e2 e2 dQ � Z4 e2 e2 dR � Z5 d e2 dS � Z6 dT dU � Z7 d e2 dV � Z8 d e2 dW � Z9 dX � Z: dY � Z; dZ � Z< d[ � Z= d\ � Z> d] � Z? d^ � Z@ d_ � ZA dN d` � ZB da � ZC e2 db � ZD dc � ZE e2 dd � ZF d e2 de � ZG d e2 df � ZH dN dg � ZI dh � ZJ e2 e2 di � ZK e2 dj � ZL e2 e2 dk � ZM e2 dl � ZN d e2 dm � ZO e2 dn � ZP do � ZQ dp � ZR e2 dq � ZS dr � ZT ds � ZU dt � ZV du � ZW d
e f dv � � YZX e2 eY e2 e2 dw � Z e2 e2 e2 dx � ZZ d S(y ss
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`.
i ( t divisiont absolute_importt print_functionNi ( t string_t unicode_t integert object_t bool_t character( t ndarrayt compare_chararrays( t array( t _vec_string( t asbytest longt chararrayt equalt not_equalt
greater_equalt
less_equalt greatert lesst str_lent addt multiplyt modt
capitalizet centert countt decodet encodet endswitht
expandtabst findt indext isalnumt isalphat isdigitt islowert isspacet istitlet isuppert joint ljustt lowert lstript partitiont replacet rfindt rindext rjustt
rpartitiont rsplitt rstript splitt
splitlinest
startswitht stript swapcaset titlet translatet uppert zfillt isnumerict isdecimalR t asarrayi c G` sF x? | D]7 } t | t � s: t t j | � j j t � r t Sq Wt S( s�
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.
( t
isinstancet _unicodet
issubclasst numpyRA t dtypet typeR R ( t argst x( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyt _use_unicode2 s
c C` s t j | j � � S( s�
Helper function to cast a result back into a string or unicode array
if an object array must be used as an intermediary.
( RE RA t tolist( t result( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyt _to_string_or_unicode_array@ s c G` s8 g } x+ | D]# } | d k r# Pn | j | � q
W| S( s#
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( t Nonet append( RH t newargst chk( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyt _clean_argsG s
c C` s' t | j j t � r | j d S| j S( s�
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.
i ( RD RF RG R t itemsize( t a( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyt _get_num_charsW s c C` s t | | d t � S( s4
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
s ==( R
t True( t x1t x2( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR b s c C` s t | | d t � S( s4
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
s !=( R
RV ( RW RX ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR z s c C` s t | | d t � S( s7
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
s >=( R
RV ( RW RX ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR � s c C` s t | | d t � S( s4
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
s <=( R
RV ( RW RX ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR � s c C` s t | | d t � S( s3
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
t >( R
RV ( RW RX ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR � s c C` s t | | d t � S( s6
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
t <( R
RV ( RW RX ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR � s c C` s t | t d � S( s�
Return len(a) element-wise.
Parameters
----------
a : array_like of str or unicode
Returns
-------
out : ndarray
Output array of integers
See also
--------
__builtin__.len
t __len__( R R ( RT ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR � s c C` s_ t j | � } t j | � } t | � t | � } t | | � } t | | | f d | f � S( s�
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`.
t __add__( RE RA RU RJ R ( RW RX t arr1t arr2t out_sizeRF ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR s
c C` s� t j | � } t j | � } t | j j t � sB t d � � n t | � t t | j � � d � } t
| | j j | f d | f � S( sv
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
s Can only multiply by integersi t __mul__( RE RA RD RF RG R t
ValueErrorRU t maxR R ( RT t it a_arrt i_arrR_ ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR s %c C` s t t | t d | f � � S( s�
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__
t __mod__( RM R R ( RT t values( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR < s c C` s" t j | � } t | | j d � S( s�
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 ( RE RA R RF ( RT Rd ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR V s "t c C` s� t j | � } t j | � } t t j | j � � } t j | j t j � r] t | � } n t | | j j
| f d | | f � S( s
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 ( RE RA R Rb t flatt
issubdtypeRF R R
R RG ( RT t widtht fillcharRd t width_arrt size( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR | s c C` s# t | t d | | g t | � � S( s�
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='|S7')
>>> 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 RR ( RT t subt startt end( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR � s +c C` s" t t | t d t | | � � � S( s�
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='|S7')
>>> 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 ( RM R R RR ( RT t encodingt errors( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR � s *c C` s" t t | t d t | | � � � S( sA
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 ( RM R R RR ( RT Rr Rs ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR � s c C` s# t | t d | | g t | � � S( sU
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='|S3')
>>> np.char.endswith(s, 'ar')
array([False, True], dtype=bool)
>>> np.char.endswith(s, 'a', start=1, end=2)
array([False, True], dtype=bool)
R ( R R RR ( RT t suffixRp Rq ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR s (i c C` s t t | t d | f � � S( sS
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 ( RM R R ( RT t tabsize( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR K s c C` s# t | t d | | g t | � � S( s�
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 RR ( RT Ro Rp Rq ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR! n s c C` s# t | t d | | g t | � � S( s�
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 RR ( RT Ro Rp Rq ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR" � s c C` s t | t d � S( s�
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 ( RT ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR# � s c C` s t | t d � S( s�
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 ( RT ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR$ � s c C` s t | t d � S( s�
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 ( RT ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR% � s c C` s t | t d � S( s�
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 ( RT ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR& � s c C` s t | t d � S( s�
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 ( RT ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR'
s c C` s t | t d � S( s�
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 ( RT ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR( & s c C` s t | t d � S( s�
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 ( RT ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR) > s c C` s t t | t d | f � � S( s�
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* ( RM R R ( t sept seq( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR* W s c C` s� t j | � } t j | � } t t j | j � � } t j | j t j � r] t | � } n t | | j j
| f d | | f � S( s�
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
R+ ( RE RA R Rb Ri Rj RF R R
R RG ( RT Rk Rl Rd Rm Rn ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR+ p s c C` s" t j | � } t | | j d � S( s{
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='|S5')
>>> np.char.lower(c)
array(['a1b c', '1bca', 'bca1'],
dtype='|S5')
R, ( RE RA R RF ( RT Rd ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR, � s c C` s( t j | � } t | | j d | f � S( s�
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='|S7')
The 'a' variable is unstripped from c[1] because whitespace leading.
>>> np.char.lstrip(c, 'a')
array(['AaAaA', ' aA ', 'bBABba'],
dtype='|S7')
>>> np.char.lstrip(c, 'A') # leaves c unchanged
array(['aAaAaA', ' aA ', 'abBABba'],
dtype='|S7')
>>> (np.char.lstrip(c, ' ') == np.char.lstrip(c, '')).all()
... # XXX: is this a regression? this line now returns False
... # np.char.lstrip(c,'') does not modify c at all.
True
>>> (np.char.lstrip(c, ' ') == np.char.lstrip(c, None)).all()
True
R- ( RE RA R RF ( RT t charsRd ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR- � s 5c C` s t t | t d | f � � S( sU
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
R. ( RM R R ( RT Rv ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR. � s c C` s) t t | t d | | g t | � � � S( s%
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
R/ ( RM R R RR ( RT t oldt newR ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR/ s c C` s# t | t d | | g t | � � S( s.
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
R0 ( R R RR ( RT Ro Rp Rq ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR0 3 s c C` s# t | t d | | g t | � � S( sx
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
R1 ( R R RR ( RT Ro Rp Rq ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR1 S s c C` s� t j | � } t j | � } t t j | j � � } t j | j t j � r] t | � } n t | | j j
| f d | | f � S( s�
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
R2 ( RE RA R Rb Ri Rj RF R R
R RG ( RT Rk Rl Rd Rm Rn ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR2 p s c C` s t t | t d | f � � S( sf
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
R3 ( RM R R ( RT Rv ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR3 � s c C` s t | t d | g t | � � S( s�
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
R4 ( R R RR ( RT Rv t maxsplit( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR4 � s !c C` s( t j | � } t | | j d | f � S( s�
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, 'a')
array(['aAaAaA', 'abBABb'],
dtype='|S7')
>>> np.char.rstrip(c, 'A')
array(['aAaAa', 'abBABba'],
dtype='|S7')
R5 ( RE RA R RF ( RT Rx Rd ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR5 � s (c C` s t | t d | g t | � � S( s9
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.
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
R6 ( R R RR ( RT Rv R{ ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR6 s c C` s t | t d t | � � S( s�
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
R7 ( R R RR ( RT t keepends( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR7 ) s c C` s# t | t d | | g t | � � S( s
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
R8 ( R R RR ( RT t prefixRp Rq ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR8 F s c C` s+ t j | � } t | | j d t | � � S( s�
For each element in `a`, return a copy with the leading and
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 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='|S7')
>>> np.char.strip(c)
array(['aAaAaA', 'aA', 'abBABba'],
dtype='|S7')
>>> np.char.strip(c, 'a') # 'a' unstripped from c[1] because whitespace leads
array(['AaAaA', ' aA ', 'bBABb'],
dtype='|S7')
>>> np.char.strip(c, 'A') # 'A' unstripped from c[1] because (unprinted) ws trails
array(['aAaAa', ' aA ', 'abBABba'],
dtype='|S7')
R9 ( RE RA R RF RR ( RT Rx Rd ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR9 e s ,c C` s" t j | � } t | | j d � S( s�
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: ( RE RA R RF ( RT Rd ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR: � s !c C` s" t j | � } t | | j d � S( s�
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; ( RE RA R RF ( RT Rd ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR; � s #c C` sd t j | � } t | j j t � r= t | | j d | f � St | | j d | g t | � � Sd S( s,
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
R< N( RE RA RD RF RG R R RR ( RT t tablet deletecharsRd ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR< � s c C` s" t j | � } t | | j d � S( sx
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='|S5')
>>> np.char.upper(c)
array(['A1B C', '1BCA', 'BCA1'],
dtype='|S5')
R= ( RE RA R RF ( RT Rd ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR= s c C` sX t j | � } t j | � } t t j | j � � } t | | j j | f d | f � S( s�
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
R> ( RE RA R Rb Ri R RF RG ( RT Rk Rd Rm Rn ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR> ) s
c C` s1 t | � t k r! t d � � n t | t d � S( s
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
s: isnumeric is only available for Unicode strings and arraysR? ( RJ R t TypeErrorR R ( RT ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR? G s c C` s1 t | � t k r! t d � � n t | t d � S( s!
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
s: isnumeric is only available for Unicode strings and arraysR@ ( RJ R R� R R ( RT ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR@ f s c B` s� e Z d Z d e d? d d? d d � Z d � Z d � Z d � Z d � Z d � Z
d
� Z d � Z d � Z
d
� Z d � Z d � Z d � Z d � Z d � Z d d d? d � Z e j j e _ d � Z d d � Z d d? d � Z d? d? d � Z d? d? d � Z d d? d � Z d d � Z d d? d � Z d d? d � Z d! � Z d" � Z d# � Z! d$ � Z" d% � Z# d& � Z$ d' � Z% d( � Z& d d) � Z' d* � Z( d? d+ � Z) d, � Z* d? d- � Z+ d d? d. � Z, d d? d/ � Z- d d0 � Z. d1 � Z/ d? d? d2 � Z0 d? d3 � Z1 d? d? d4 � Z2 d? d5 � Z3 d d? d6 � Z4 d? d7 � Z5 d8 � Z6 d9 � Z7 d? d: � Z8 d; � Z9 d< � Z: d= � Z; d> � Z< RS(@ s�
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([['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')
i i t Cc C` s� | r t } n t } t | � } t j d d k rR t | t � rR | } d } n d } d a | d k r� t j
| | | | f d | �}
n3 t j
| | | | f d | d | d | d | �}
| d k r� | |
d <n d a |
S( Ni i i t ordert buffert offsett strides.( R R R t syst version_infoRB RC RN t
_globalvarR t __new__( t subtypet shapeRS t unicodeR� R� R� R� RF t fillert self( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR� s( "
c C` s, t r( | j j d k r( t d � � n d S( Nt SUbcs- Can only create a chararray from string data.( R� RF t charRa ( R� t obj( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyt __array_finalize__6 s c C` sU t j | | � } t | t � rQ | j � } t | � d k rH d } qQ | } n | S( Ni t ( R t __getitem__RB R R5 t _len( R� R� t valt temp( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR� ; s c C` s
t | | � S( sg
Return (self == other) element-wise.
See also
--------
equal
( R ( R� t other( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyt __eq__L s c C` s
t | | � S( sk
Return (self != other) element-wise.
See also
--------
not_equal
( R ( R� R� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyt __ne__V s c C` s
t | | � S( so
Return (self >= other) element-wise.
See also
--------
greater_equal
( R ( R� R� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyt __ge__` s c C` s
t | | � S( sl
Return (self <= other) element-wise.
See also
--------
less_equal
( R ( R� R� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyt __le__j s c C` s
t | | � S( sh
Return (self > other) element-wise.
See also
--------
greater
( R ( R� R� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyt __gt__t s c C` s
t | | � S( se
Return (self < other) element-wise.
See also
--------
less
( R ( R� R� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyt __lt__~ s c C` s t t | | � � S( s�
Return (self + other), that is string concatenation,
element-wise for a pair of array_likes of str or unicode.
See also
--------
add
( RA R ( R� R� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR\ � s c C` s t t t j | � | � � S( s�
Return (other + self), that is string concatenation,
element-wise for a pair of array_likes of `string_` or `unicode_`.
See also
--------
add
( RA R RE ( R� R� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyt __radd__� s c C` s t t | | � � S( s�
Return (self * i), that is string multiple concatenation,
element-wise.
See also
--------
multiply
( RA R ( R� Rc ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR` � s c C` s t t | | � � S( s�
Return (self * i), that is string multiple concatenation,
element-wise.
See also
--------
multiply
( RA R ( R� Rc ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyt __rmul__� s c C` s t t | | � � S( s�
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
( RA R ( R� Rc ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyRf � s
c C` s t S( N( t NotImplemented( R� R� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyt __rmod__� s i����t quicksortc C` s | j � j | | | � S( s
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')
( t __array__t argsort( R� t axist kindR� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR� � s c C` s t t | � � S( s�
Return a copy of `self` with only the first character of each element
capitalized.
See also
--------
char.capitalize
( RA R ( R� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR � s
Rh c C` s t t | | | � � S( s�
Return a copy of `self` with its elements centered in a
string of length `width`.
See also
--------
center
( RA R ( R� Rk Rl ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR � s c C` s t | | | | � S( s�
Returns an array with the number of non-overlapping occurrences of
substring `sub` in the range [`start`, `end`].
See also
--------
char.count
( R ( R� Ro Rp Rq ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR � s
c C` s t | | | � S( sj
Calls `str.decode` element-wise.
See also
--------
char.decode
( R ( R� Rr Rs ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR � s c C` s t | | | � S( sj
Calls `str.encode` element-wise.
See also
--------
char.encode
( R ( R� Rr Rs ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR s c C` s t | | | | � S( s�
Returns a boolean array which is `True` where the string element
in `self` ends with `suffix`, otherwise `False`.
See also
--------
char.endswith
( R ( R� Rt Rp Rq ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR s
i c C` s t t | | � � S( s�
Return a copy of each string element where all tab characters are
replaced by one or more spaces.
See also
--------
char.expandtabs
( RA R ( R� Ru ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR s
c C` s t | | | | � S( s�
For each element, return the lowest index in the string where
substring `sub` is found.
See also
--------
char.find
( R! ( R� Ro Rp Rq ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR! ) s
c C` s t | | | | � S( s�
Like `find`, but raises `ValueError` when the substring is not found.
See also
--------
char.index
( R" ( R� Ro Rp Rq ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR" 5 s c C` s
t | � S( s�
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� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR# @ s c C` s
t | � S( s�
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� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR$ M s c C` s
t | � S( s�
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� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR% Z s
c C` s
t | � S( s�
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� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR& f s c C` s
t | � S( s�
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� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR' s s c C` s
t | � S( s�
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� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR( � s
c C` s
t | � S( s�
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� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR) � s c C` s
t | | � S( s�
Return a string which is the concatenation of the strings in the
sequence `seq`.
See also
--------
char.join
( R* ( R� Rw ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR* � s
c C` s t t | | | � � S( s�
Return an array with the elements of `self` left-justified in a
string of length `width`.
See also
--------
char.ljust
( RA R+ ( R� Rk Rl ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR+ � s
c C` s t t | � � S( s�
Return an array with the elements of `self` converted to
lowercase.
See also
--------
char.lower
( RA R, ( R� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR, � s
c C` s t t | | � � S( s�
For each element in `self`, return a copy with the leading characters
removed.
See also
--------
char.lstrip
( RA R- ( R� Rx ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR- � s
c C` s t t | | � � S( su
Partition each element in `self` around `sep`.
See also
--------
partition
( RA R. ( R� Rv ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR. � s c C` s t t | | | | � � S( s�
For each element in `self`, return a copy of the string with all
occurrences of substring `old` replaced by `new`.
See also
--------
char.replace
( RA R/ ( R� Ry Rz R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR/ � s
c C` s t | | | | � S( s�
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
( R0 ( R� Ro Rp Rq ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR0 � s c C` s t | | | | � S( s�
Like `rfind`, but raises `ValueError` when the substring `sub` is
not found.
See also
--------
char.rindex
( R1 ( R� Ro Rp Rq ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR1 � s
c C` s t t | | | � � S( s�
Return an array with the elements of `self`
right-justified in a string of length `width`.
See also
--------
char.rjust
( RA R2 ( R� Rk Rl ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR2 � s
c C` s t t | | � � S( sv
Partition each element in `self` around `sep`.
See also
--------
rpartition
( RA R3 ( R� Rv ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR3 s c C` s t | | | � S( s�
For each element in `self`, return a list of the words in
the string, using `sep` as the delimiter string.
See also
--------
char.rsplit
( R4 ( R� Rv R{ ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR4 s
c C` s t t | | � � S( s�
For each element in `self`, return a copy with the trailing
characters removed.
See also
--------
char.rstrip
( RA R5 ( R� Rx ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR5 s
c C` s t | | | � S( s�
For each element in `self`, return a list of the words in the
string, using `sep` as the delimiter string.
See also
--------
char.split
( R6 ( R� Rv R{ ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR6 & s
c C` s
t | | � S( s�
For each element in `self`, return a list of the lines in the
element, breaking at line boundaries.
See also
--------
char.splitlines
( R7 ( R� R| ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR7 2 s
c C` s t | | | | � S( s�
Returns a boolean array which is `True` where the string element
in `self` starts with `prefix`, otherwise `False`.
See also
--------
char.startswith
( R8 ( R� R} Rp Rq ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR8 > s
c C` s t t | | � � S( s�
For each element in `self`, return a copy with the leading and
trailing characters removed.
See also
--------
char.strip
( RA R9 ( R� Rx ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR9 J s
c C` s t t | � � S( s�
For each element in `self`, return a copy of the string with
uppercase characters converted to lowercase and vice versa.
See also
--------
char.swapcase
( RA R: ( R� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR: V s
c C` s t t | � � S( s�
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
( RA R; ( R� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR; b s c C` s t t | | | � � S( sB
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
( RA R< ( R� R~ R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR< o s c C` s t t | � � S( s�
Return an array with the elements of `self` converted to
uppercase.
See also
--------
char.upper
( RA R= ( R� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR= } s
c C` s t t | | � � S( s�
Return the numeric string left-filled with zeros in a string of
length `width`.
See also
--------
char.zfill
( RA R> ( R� Rk ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR> � s
c C` s
t | � S( s�
For each element in `self`, return True if there are only
numeric characters in the element.
See also
--------
char.isnumeric
( R? ( R� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR? � s
c C` s
t | � S( s�
For each element in `self`, return True if there are only
decimal characters in the element.
See also
--------
char.isdecimal
( R@ ( R� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR@ � s
N(= t __name__t
__module__t __doc__t FalseRN R� R� R� R� R� R� R� R� R� R\ R� R` R� Rf R� R� R R R 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@ ( ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR � st � "
c
C` sx t | t t f � rO| d k rB t | t � r9 t } qB t } n | d k r] t | � } n t | � | } | r!t j d k rt j d k r� | j
d � } q t | t � r� t j
| d � } t j | d � } | j } q t j
| d � } t j | d � } | j } q-t | � } n t | � } t | d | d | d | d
| �St | t t f � rvt j | � } n t | t � r�t | j j t � r�t | t � s�| j t � } n | d k r�| j } t | j j t � r�| d } q�n | d k r(t | j j t � r t } q(t } n | r7t } n t } | d k rat j | d
| �} n | s�| | j k s�| r�t | t � s�| r�t | t � r�| j | t | � f � } n | St | t � rt | j j t � r| d k r| j � } qn | rt } n t } | d k rGt! | d | d
| d
t �}
n$ t! | d | | f d
| d
t �}
|
j t � S( s�
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).
i�� i t utf_32t u1t u4t u2RS R� R� R� i RF t subokN(" RB t _bytesRC RN RV R� R� R� t
maxunicodet
hexversionR t strRE t
frombufferR t dataR t listt tupleRA R RD RF RG R t viewRS R R t astypeR t objectRK t narray( R� RS t copyR� R� R� t asciit ucs4t ucs2RF R� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyR � sr >
$ $ !$c C` s t | | d t d | d | �S( s�
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).
R� R� R� ( R R� ( R� RS R� R� ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyRA P
s 0([ R� t
__future__R R R R� t numerictypesR R R R R R t numericR R
R R� t numpy.core.multiarrayR t numpy.compatR
R RE t __all__R� R� R� RC t bytesR� R� t lenR� RJ RM RR RU R R R R R R R R R R R R RN 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@ R RV RA ( ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/numpy/core/defchararray.pyt <module> s� . & $..#, ## # $ 9 # # #% ," 0 % ' $ $ � � � ,�
Mini Shell