Detail: IndexGO: Accessor String

Overview: IndexGO: Accessor String

IndexGO.via_str.__getitem__(key)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.__getitem__(key)[source]

Return a container with the provided selection or slice of each element.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str[-1]
[' ' 'Z' '3' ' ']
IndexGO.via_str.capitalize
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.capitalize()[source]

Return a container with only the first character of each element capitalized.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.capitalize()
['Qrs ' 'Xyz' '123' ' wx ']
IndexGO.via_str.center(width, fillchar)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.center(width, fillchar=' ')[source]

Return a container with its elements centered in a string of length width.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.center(8)
['  qrs   ' '  XYZ   ' '  123   ' '   wX   ']
IndexGO.via_str.contains(item)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.contains(item)[source]

Return a Boolean container showing True of item is a substring of elements.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.contains('X')
[False  True False  True]
IndexGO.via_str.count(sub, start, end)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.count(sub, start=None, end=None)[source]

Returns a container with the number of non-overlapping occurrences of substring sub in the optional range start, end.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.count('X')
[0 1 0 1]
IndexGO.via_str.decode(encoding, errors)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.decode(encoding=None, errors=None)[source]

Apply str.decode() to each element. Elements must be bytes.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX ')).astype(bytes)
>>> ix
<IndexGO>
b'qrs '
b'XYZ'
b'123'
b' wX '
<|S4>
>>> ix.via_str.decode()
['qrs ' 'XYZ' '123' ' wX ']
IndexGO.via_str.encode(encoding, errors)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.encode(encoding=None, errors=None)[source]

Apply str.encode() to each element. Elements must be strings.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.encode()
[b'qrs ' b'XYZ' b'123' b' wX ']
IndexGO.via_str.endswith(suffix, start, end)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.endswith(suffix, start=None, end=None)[source]

Returns a container with the number of non-overlapping occurrences of substring suffix (or an interable of suffixes) in the optional range start, end.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.endswith(' ')
[ True False False  True]
IndexGO.via_str.find(sub, start, end)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.find(sub, start=None, end=None)[source]

For each element, return the lowest index in the string where substring sub is found.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.find('X')
[-1  0 -1  2]
IndexGO.via_str.format(format)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.format(format)[source]

For each element, return a string resulting from calling the string format argument’s format method with the the element. Format strings (given within curly braces) can use Python’s format mini language: https://docs.python.org/3/library/string.html#formatspec

Parameters

format – A string, an iterable of strings, or a mapping of labels to strings. For 1D containers, an iterable of strings must be of length equal to the container; a mapping can use Index labels (for a Series) or positions (for an Index). For 2D containers, an iterable of strings must be of length equal to the columns (for a Frame) or the depth (for an Index Hierarchy); a mapping can use column labels (for a Frame) or depths (for an IndexHierarchy).

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.format('{:-^10}')
['---qrs ---' '---XYZ----' '---123----' '--- wX ---']
IndexGO.via_str.index(sub, start, end)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.index(sub, start=None, end=None)[source]

Like find, but raises ValueError when the substring is not found.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.index('X')
ValueError('substring not found')
IndexGO.via_str.isalnum
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.isalnum()[source]

Returns true for each element if all characters in the string are alphanumeric and there is at least one character, false otherwise.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.isalnum()
[False  True  True False]
IndexGO.via_str.isalpha
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.isalpha()[source]

Returns true for each element if all characters in the string are alphabetic and there is at least one character, false otherwise.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.isalpha()
[False  True False False]
IndexGO.via_str.isdecimal
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.isdecimal()[source]

For each element, return True if there are only decimal characters in the element.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.isdecimal()
[False False  True False]
IndexGO.via_str.isdigit
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.isdigit()[source]

Returns true for each element if all characters in the string are digits and there is at least one character, false otherwise.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.isdigit()
[False False  True False]
IndexGO.via_str.islower
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.islower()[source]

Returns true for each element if all cased characters in the string are lowercase and there is at least one cased character, false otherwise.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.islower()
[ True False False False]
IndexGO.via_str.isnumeric
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.isnumeric()[source]

For each element in self, return True if there are only numeric characters in the element.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.isnumeric()
[False False  True False]
IndexGO.via_str.isspace
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.isspace()[source]

Returns true for each element if there are only whitespace characters in the string and there is at least one character, false otherwise.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.isspace()
[False False False False]
IndexGO.via_str.istitle
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.istitle()[source]

Returns true for each element if the element is a titlecased string and there is at least one character, false otherwise.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.istitle()
[False False False False]
IndexGO.via_str.isupper
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.isupper()[source]

Returns true for each element if all cased characters in the string are uppercase and there is at least one character, false otherwise.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.isupper()
[False  True False False]
IndexGO.via_str.ljust(width, fillchar)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.ljust(width, fillchar=' ')[source]

Return a container with its elements ljusted in a string of length width.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.ljust(8)
['qrs     ' 'XYZ     ' '123     ' ' wX     ']
IndexGO.via_str.len
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.len()[source]

Return the length of the string.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.len()
[4 3 3 4]
IndexGO.via_str.lower
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.lower()[source]

Return an array with the elements of self converted to lowercase.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.lower()
['qrs ' 'xyz' '123' ' wx ']
IndexGO.via_str.lstrip(chars)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.lstrip(chars=None)[source]

For each element, return a copy with the leading characters removed.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.lstrip()
['qrs ' 'XYZ' '123' 'wX ']
IndexGO.via_str.partition(sep)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.partition(sep)[source]

Partition each element around sep.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.partition('X')
[('qrs ', '', '') ('', 'X', 'YZ') ('123', '', '') (' w', 'X', ' ')]
IndexGO.via_str.replace(old, new, count)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.replace(old, new, count=None)[source]

Return a container with its elements replaced in a string of length width.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.replace('X', '*')
['qrs ' '*YZ' '123' ' w* ']
IndexGO.via_str.rfind(sub, start, end)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.rfind(sub, start=None, end=None)[source]

For each element, return the highest index in the string where substring sub is found, such that sub is contained within start, end.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.rfind('X')
[-1  0 -1  2]
IndexGO.via_str.rindex(sub, start, end)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.rindex(sub, start=None, end=None)[source]

Like rfind, but raises ValueError when the substring sub is not found.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.rindex('X')
ValueError('substring not found')
IndexGO.via_str.rjust(width, fillchar)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.rjust(width, fillchar=' ')[source]

Return a container with its elements rjusted in a string of length width.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.rjust(8)
['    qrs ' '     XYZ' '     123' '     wX ']
IndexGO.via_str.rpartition(sep)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.rpartition(sep)[source]

Partition (split) each element around the right-most separator.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.rpartition('X')
[('', '', 'qrs ') ('', 'X', 'YZ') ('', '', '123') (' w', 'X', ' ')]
IndexGO.via_str.rsplit(sep, maxsplit)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.rsplit(sep, maxsplit=- 1)[source]

For each element, return a tuple of the words in the string, using sep as the delimiter string.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.rsplit('X')
[('qrs ',) ('', 'YZ') ('123',) (' w', ' ')]
IndexGO.via_str.rstrip(chars)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.rstrip(chars=None)[source]

For each element, return a copy with the trailing characters removed.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.rstrip()
['qrs' 'XYZ' '123' ' wX']
IndexGO.via_str.split(sep, maxsplit)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.split(sep, maxsplit=- 1)[source]

For each element, return a tuple of the words in the string, using sep as the delimiter string.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.split('X')
[('qrs ',) ('', 'YZ') ('123',) (' w', ' ')]
IndexGO.via_str.startswith(prefix, start, end)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.startswith(prefix, start=None, end=None)[source]

Returns a container with the number of non-overlapping occurrences of substring prefix (or an interable of prefixes) in the optional range start, end.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.startswith('X')
[False  True False False]
IndexGO.via_str.strip(chars)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.strip(chars=None)[source]

For each element, return a copy with the leading and trailing characters removed.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.strip()
['qrs' 'XYZ' '123' 'wX']
IndexGO.via_str.swapcase
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.swapcase()[source]

Return a container with uppercase characters converted to lowercase and vice versa.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.swapcase()
['QRS ' 'xyz' '123' ' Wx ']
IndexGO.via_str.title
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.title()[source]

Return a container with uppercase characters converted to lowercase and vice versa.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.title()
['Qrs ' 'Xyz' '123' ' Wx ']
IndexGO.via_str.upper
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.upper()[source]

Return a container with uppercase characters converted to lowercase and vice versa.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.upper()
['QRS ' 'XYZ' '123' ' WX ']
IndexGO.via_str.zfill(width)
IndexGO.via_str

Interface for applying string methods to elements in this container.

InterfaceString.zfill(width)[source]

Return the string left-filled with zeros.

>>> ix = sf.IndexGO(('qrs ', 'XYZ', '123', ' wX '))
>>> ix
<IndexGO>
qrs
XYZ
123
 wX
<<U4>
>>> ix.via_str.zfill(8)
['0000qrs ' '00000XYZ' '00000123' '0000 wX ']

IndexGO: Constructor | Exporter | Attribute | Method | Dictionary-Like | Display | Selector | Iterator | Operator Binary | Operator Unary | Accessor Values | Accessor Datetime | Accessor String | Accessor Regular Expression | Accessor Hashlib