Detail: 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 iterable 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 iterable 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 ']