string

Informar un problema Ver fuente

Tipo de lenguaje integrado para admitir cadenas. Ejemplos de literales de string:
a = 'abc\ndef'
b = "ab'cd"
c = """multiline string"""

# Strings support slicing (negative index starts from the end):
x = "hello"[2:4]  # "ll"
y = "hello"[1:-1]  # "ell"
z = "hello"[:4]  # "hell"# Slice steps can be used, too:
s = "hello"[::2] # "hlo"
t = "hello"[3:0:-1] # "lle"
Las strings no se pueden iterar directamente. Usa el método .elems() para iterar sobre sus caracteres. Ejemplos:
"bc" in "abcd"   # evaluates to True
x = [c for c in "abc".elems()]  # x == ["a", "b", "c"]
No se permite la concatenación implícita de strings. En su lugar, usa el operador +. Los operadores de comparación realizan una comparación lexicográfica; usa == para probar la igualdad.

Miembros

usar mayúsculas

string string.capitalize()

Muestra una copia de la cadena con el primer carácter (si corresponde) en mayúscula y el resto en minúscula. Este método no admite caracteres no ASCII.

cantidad

int string.count(sub, start=0, end=None)

Muestra la cantidad de casos (no superpuestos) de la subcadena sub en la cadena, que puede restringirse de manera opcional a [start:end], que start sea inclusivo y end sea exclusivo.

Parámetros

Parámetro Descripción
sub required
La substring que se debe contar.
start int o None; el valor predeterminado es 0
Restringir a la búsqueda desde esta posición
end int o None; el valor predeterminado es None
, la posición opcional antes de la cual se debe restringir la búsqueda.

elementos

sequence string.elems()

Muestra un valor iterable que contiene substrings sucesivas de 1 elemento de la string. Equivale a [s[i] for i in range(len(s))], excepto que el valor que se muestra podría no ser una lista.

endswith

bool string.endswith(sub, start=0, end=None)

Muestra el valor True si la string termina con sub; de lo contrario, es False, pero se restringe de forma opcional a [start:end], si start es inclusivo y end es exclusivo.

Parámetros

Parámetro Descripción
sub string; o tuple de string; obligatorio
El sufijo (o la tupla de sufijos alternativos) con el que se buscarán coincidencias.
start int; o None; el valor predeterminado es 0
La prueba comienza en esta posición.
end int; o None; el valor predeterminado es None
, la posición opcional en la que se detiene la comparación.

buscar

int string.find(sub, start=0, end=None)

Muestra el primer índice en el que se encuentra sub, o -1 si no existe tal índice, que puede restringirse a [start:end], start es inclusivo y end es exclusivo.

Parámetros

Parámetro Descripción
sub required
La substring que se debe buscar.
start int o None; el valor predeterminado es 0
Restringir a la búsqueda desde esta posición
end int o None; el valor predeterminado es None
, la posición opcional antes de la cual se debe restringir la búsqueda.

formato

string string.format(*args, **kwargs)

Interpola las strings. Las strings de formato contienen campos de reemplazo rodeados de llaves {}. Todo lo que no esté contenido entre llaves se considera texto literal, que se copia sin cambios en el resultado. Si necesitas incluir un carácter de llave en el texto literal, se puede escapar duplicando: {{ y }}. Un campo de reemplazo puede ser un nombre, un número o estar vacío. Los valores se convierten en cadenas con la función str.
# Access in order:
"{} < {}".format(4, 5) == "4 < 5"
# Access by position:
"{1}, {0}".format(2, 1) == "1, 2"
# Access by name:
"x{key}x".format(key = 2) == "x2x"

Parámetros

Parámetro Descripción
args la opción predeterminada es ()
Lista de argumentos.
kwargs la opción predeterminada es {}
Diccionario de argumentos.

index

int string.index(sub, start=0, end=None)

Muestra el primer índice en el que se encuentra sub o genera un error si no existe dicho índice. De manera opcional, se restringe [start:end]start para que sea inclusivo y end sea exclusivo.

Parámetros

Parámetro Descripción
sub required
La substring que se debe buscar.
start int o None; el valor predeterminado es 0
Restringir a la búsqueda desde esta posición
end int o None; el valor predeterminado es None
, la posición opcional antes de la cual se debe restringir la búsqueda.

isalnum

bool string.isalnum()

Muestra el valor True si todos los caracteres de la cadena son alfanuméricos ([a-zA-Z0-9]) y hay al menos un carácter.

isalpha

bool string.isalpha()

Muestra el valor True si todos los caracteres de la cadena son alfabéticos ([a-zA-Z]) y hay al menos un carácter.

isdigit

bool string.isdigit()

Muestra el valor True si todos los caracteres de la cadena son dígitos ([0-9]) y hay al menos un carácter.

islower

bool string.islower()

Muestra el valor True si todos los caracteres en mayúsculas de la string están en minúsculas y hay al menos un carácter.

isspace

bool string.isspace()

Muestra el valor True si todos los caracteres son caracteres de espacio en blanco y la string contiene al menos un carácter.

istitle

bool string.istitle()

Muestra el valor True si la cadena está en mayúscula y contiene al menos un carácter. Esto significa que cada carácter en mayúscula debe estar después de otro sin mayúsculas (p.ej., espacio en blanco) y cada carácter en minúscula debe ir después del carácter en mayúscula (p.ej., mayúsculas o minúsculas).

isupper

bool string.isupper()

Muestra el valor True si todos los caracteres en mayúsculas de la string están en mayúsculas y hay al menos un carácter.

join

string string.join(elements)

Muestra una cadena en la que los elementos de cadena del argumento se unieron como separador por esta cadena. Ejemplo:
"|".join(["a", "b", "c"]) == "a|b|c"

Parámetros

Parámetro Descripción
elements required
Los objetos que se unirán.

menos

string string.lower()

Muestra la versión en minúscula de esta string.

lstrip

string string.lstrip(chars=None)

Muestra una copia de la string en la que se quitan los caracteres iniciales que aparecen en chars. Ten en cuenta que chars no es un prefijo: se quitan todas las combinaciones de su valor:
"abcba".lstrip("ba") == "cba"

Parámetros

Parámetro Descripción
chars string; o None; el valor predeterminado es None
Los caracteres que se quitarán o todos los espacios en blanco si se muestra None.

partición

tuple string.partition(sep)

Divide la string de entrada en el primer caso del separador sep y muestra la partición resultante como una tupla de tres elementos de la forma (antes, separador, después). Si la string de entrada no contiene un separador, se muestra la partición (self, '', '').

Parámetros

Parámetro Descripción
sep required
Es la cadena en la que se divide.

removeprefix

string string.removeprefix(prefix)

Si la string comienza con prefix, muestra una nueva string sin el prefijo. De lo contrario, muestra la string.

Parámetros

Parámetro Descripción
prefix obligatorio
Es el prefijo que se quita si está presente.

removesuffix

string string.removesuffix(suffix)

Si la string termina en suffix, muestra una nueva string sin el sufijo. De lo contrario, muestra la string.

Parámetros

Parámetro Descripción
suffix obligatorio
Sufijo que se quita si está presente.

replace

string string.replace(old, new, count=-1)

Muestra una copia de la cadena en la que los casos de old se reemplazaron por new, lo que restringe de manera opcional la cantidad de reemplazos a count.

Parámetros

Parámetro Descripción
old obligatorio
Cadena que se reemplazará.
new obligatorio
Cadena con la que se reemplazará.
count la cantidad predeterminada es -1
La cantidad máxima de reemplazos. Si se omite, o si el valor es negativo, no hay límite.

rfind

int string.rfind(sub, start=0, end=None)

Muestra el último índice en el que se encuentra sub, o -1 si no existe tal índice, de manera opcional, lo restringe a [start:end], start es inclusivo y end es exclusivo.

Parámetros

Parámetro Descripción
sub required
La substring que se debe buscar.
start int o None; el valor predeterminado es 0
Restringir a la búsqueda desde esta posición
end int o None; el valor predeterminado es None
, la posición opcional antes de la cual se debe restringir la búsqueda.

rindex

int string.rindex(sub, start=0, end=None)

Muestra el último índice en el que se encuentra sub o genera un error si no existe tal índice. De manera opcional, se restringe [start:end], si start es inclusivo y end es exclusivo.

Parámetros

Parámetro Descripción
sub required
La substring que se debe buscar.
start int o None; el valor predeterminado es 0
Restringir a la búsqueda desde esta posición
end int o None; el valor predeterminado es None
, la posición opcional antes de la cual se debe restringir la búsqueda.

rpartition

tuple string.rpartition(sep)

Divide la string de entrada en el último caso del separador sep y muestra la partición resultante como una tupla de tres elementos de la forma (antes, separador, después). Si la cadena de entrada no contiene un separador, rpartition muestra ('', '', self).

Parámetros

Parámetro Descripción
sep required
Es la cadena en la que se divide.

rsplit

list string.rsplit(sep, maxsplit=None)

Muestra una lista de todas las palabras en la string, usando sep como separador, lo que, de manera opcional, limita el número de divisiones a maxsplit. A excepción de la división desde la derecha, este método se comporta como split().

Parámetros

Parámetro Descripción
sep required
Es la cadena en la que se divide.
maxsplit int; o None; el valor predeterminado es None
La cantidad máxima de divisiones.

rstrip

string string.rstrip(chars=None)

Muestra una copia de la string en la que se quitan los caracteres finales que aparecen en chars. Ten en cuenta que chars no es un sufijo: se quitan todas las combinaciones de su valor:
"abcbaa".rstrip("ab") == "abc"

Parámetros

Parámetro Descripción
chars string; o None; el valor predeterminado es None
Los caracteres que se quitarán o todos los espacios en blanco si se muestra None.

split

list string.split(sep, maxsplit=None)

Muestra una lista de todas las palabras en la string, usando sep como separador, lo que, de manera opcional, limita el número de divisiones a maxsplit.

Parámetros

Parámetro Descripción
sep required
Es la cadena en la que se divide.
maxsplit int; o None; el valor predeterminado es None
La cantidad máxima de divisiones.

splitlines

sequence string.splitlines(keepends=False)

Divide la string en los límites de línea ('\n', '\r\n', '\r') y muestra el resultado como una nueva lista mutable.

Parámetros

Parámetro Descripción
keepends El valor predeterminado es False
Indica si los saltos de línea se deben incluir en la lista resultante.

startswith

bool string.startswith(sub, start=0, end=None)

Muestra el valor True si la string comienza con sub. De lo contrario, es False. De forma opcional, se restringe a [start:end], start es inclusivo y end es exclusivo.

Parámetros

Parámetro Descripción
sub string; o tuple de string; obligatorio
El prefijo (o la tupla de prefijos alternativos) con el que se buscarán coincidencias.
start int; o None; el valor predeterminado es 0
La prueba comienza en esta posición.
end int; o None; el valor predeterminado es None
Deja de comparar en esta posición.

strip

string string.strip(chars=None)

Muestra una copia de la string en la que se quitan los caracteres iniciales o finales que aparecen en chars. Ten en cuenta que chars no es un prefijo ni un sufijo: se quitan todas las combinaciones de su valor:
"aabcbcbaa".strip("ab") == "cbc"

Parámetros

Parámetro Descripción
chars string; o None; el valor predeterminado es None
Los caracteres que se quitarán o todos los espacios en blanco si se muestra None.

título

string string.title()

Convierte la cadena de entrada a mayúscula inicial, es decir, cada palabra comienza con una letra mayúscula y las demás letras están en minúscula. En este contexto, una palabra significa estrictamente una secuencia de letras. Este método no admite caracteres Unicode complementarios.

upper

string string.upper()

Muestra la versión en mayúsculas de esta string.