cadena

Informar un problema Ver código fuente Nocturno · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

Es un tipo integrado de lenguaje para admitir cadenas. Ejemplos de literales de cadena:

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 cadenas no son directamente iterables. 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 cadenas. 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()

Devuelve una copia de la cadena con su primer carácter (si lo hay) en mayúscula y el resto en minúscula. Este método no admite caracteres que no sean ASCII.

count

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

Devuelve la cantidad de ocurrencias (no superpuestas) de la subcadena sub en la cadena, y se puede restringir de forma opcional a [start:end], start (inclusivo) y end (exclusivo).

Parámetros

Parámetro Descripción
sub obligatorio
Subcadena que se debe contar.
start int o None; el valor predeterminado es 0
Restringe la búsqueda desde esta posición.
end int o None; el valor predeterminado es None
posición opcional antes de la cual se debe restringir la búsqueda.

elems

sequence string.elems()

Devuelve un valor iterable que contiene substrings sucesivas de 1 elemento de la cadena. Es equivalente a [s[i] for i in range(len(s))], excepto que el valor devuelto podría no ser una lista.

endswith

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

Devuelve True si la cadena termina con sub; de lo contrario, devuelve False. También puedes restringir la búsqueda a [start:end], con start como inclusivo y end como exclusivo.

Parámetros

Parámetro Descripción
sub string o tupla de strings; obligatorio
Sufijo (o tupla de sufijos alternativos) con el que se debe coincidir.
start int o None; el valor predeterminado es 0
Prueba que comienza en esta posición.
end int o None; el valor predeterminado es None
posición opcional en la que se detiene la comparación.

buscar

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

Devuelve el primer índice en el que se encuentra sub o -1 si no existe tal índice. De manera opcional, se puede restringir a [start:end], donde start es inclusivo y end es exclusivo.

Parámetros

Parámetro Descripción
sub obligatorio
Subcadena que se buscará.
start int o None; el valor predeterminado es 0
Restringe la búsqueda desde esta posición.
end int o None; el valor predeterminado es None
posición opcional antes de la cual se debe restringir la búsqueda.

formato

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

Realiza la interpolación de cadenas. Las cadenas de formato contienen campos de reemplazo entre llaves {}. Todo lo que no esté 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, puedes duplicarlo para escaparlo: {{ 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 El valor predeterminado es ()
. Lista de argumentos.
kwargs El valor predeterminado es {}
. Es un diccionario de argumentos.

índice

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

Devuelve el primer índice en el que se encuentra sub o genera un error si no existe tal índice. De manera opcional, se puede restringir a [start:end]start como inclusivo y end como exclusivo.

Parámetros

Parámetro Descripción
sub obligatorio
Subcadena que se buscará.
start int o None; el valor predeterminado es 0
Restringe la búsqueda desde esta posición.
end int o None; el valor predeterminado es None
posición opcional antes de la cual se debe restringir la búsqueda.

isalnum

bool string.isalnum()

Devuelve 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()

Devuelve 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()

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

islower

bool string.islower()

Devuelve True si todos los caracteres en mayúsculas y minúsculas de la cadena están en minúsculas y hay al menos un carácter.

isspace

bool string.isspace()

Devuelve True si todos los caracteres son espacios en blanco y la cadena contiene al menos un carácter.

istitle

bool string.istitle()

Devuelve True si la cadena está en formato de título y contiene al menos un carácter. Esto significa que cada carácter en mayúscula debe seguir a uno sin mayúsculas (p. ej., un espacio en blanco) y cada carácter en minúscula debe seguir a uno con mayúsculas o minúsculas.

isupper

bool string.isupper()

Devuelve True si todos los caracteres que admiten mayúsculas y minúsculas de la cadena están en mayúsculas y hay al menos un carácter.

unir

string string.join(elements)

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

Parámetros

Parámetro Descripción
elements obligatorio
Objetos que se unirán.

menor

string string.lower()

Devuelve la versión en minúsculas de esta cadena.

lstrip

string string.lstrip(chars=None)

Devuelve una copia de la cadena 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 cadena o None; El valor predeterminado es None
Los caracteres que se quitarán o todos los espacios en blanco si es None.

partición

tuple string.partition(sep)

Divide la cadena de entrada en el primer caso del separador sep y devuelve la partición resultante como una tupla de tres elementos con el formato (antes, separador, después). Si la cadena de entrada no contiene el separador, partition devuelve (self, '', '').

Parámetros

Parámetro Descripción
sep obligatorio
Es la cadena en la que se realizará la división.

removeprefix

string string.removeprefix(prefix)

Si la cadena comienza con prefix, devuelve una cadena nueva sin el prefijo. De lo contrario, devuelve la cadena.

Parámetros

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

removesuffix

string string.removesuffix(suffix)

Si la cadena termina con suffix, devuelve una cadena nueva con el sufijo quitado. De lo contrario, devuelve la cadena.

Parámetros

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

replace

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

Devuelve una copia de la cadena en la que las ocurrencias de old se reemplazaron por new, y se puede restringir la cantidad de reemplazos a count.

Parámetros

Parámetro Descripción
old obligatorio
Es la cadena que se reemplazará.
new obligatorio
Es la cadena con la que se reemplazará.
count El valor predeterminado es -1
. Es 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)

Devuelve el último índice en el que se encuentra sub o -1 si no existe tal índice. De manera opcional, se puede restringir a [start:end], con start como valor inclusivo y end como valor exclusivo.

Parámetros

Parámetro Descripción
sub obligatorio
Subcadena que se buscará.
start int o None; el valor predeterminado es 0
Restringe la búsqueda desde esta posición.
end int o None; el valor predeterminado es None
posición opcional antes de la cual se debe restringir la búsqueda.

rindex

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

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

Parámetros

Parámetro Descripción
sub obligatorio
Subcadena que se buscará.
start int o None; el valor predeterminado es 0
Restringe la búsqueda desde esta posición.
end int o None; el valor predeterminado es None
posición opcional antes de la cual se debe restringir la búsqueda.

rpartition

tuple string.rpartition(sep)

Divide la cadena de entrada en la última aparición del separador sep y devuelve la partición resultante como una tupla de tres elementos de la forma (antes, separador, después). Si la cadena de entrada no contiene el separador, rpartition devuelve ("", "", self).

Parámetros

Parámetro Descripción
sep obligatorio
Es la cadena en la que se realizará la división.

rsplit

list string.rsplit(sep, maxsplit=None)

Devuelve una lista de todas las palabras de la cadena, usando sep como separador y, de manera opcional, limita la cantidad 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 obligatorio
Es la cadena en la que se realizará la división.
maxsplit int o None; el valor predeterminado es None
Es la cantidad máxima de divisiones.

rstrip

string string.rstrip(chars=None)

Devuelve una copia de la cadena 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 cadena o None; El valor predeterminado es None
Los caracteres que se quitarán o todos los espacios en blanco si es None.

split

list string.split(sep, maxsplit=None)

Devuelve una lista de todas las palabras de la cadena, usando sep como separador y, de manera opcional, limita la cantidad de divisiones a maxsplit.

Parámetros

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

splitlines

sequence string.splitlines(keepends=False)

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

Parámetros

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

startswith

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

Devuelve True si la cadena comienza con sub; de lo contrario, devuelve False. También se puede restringir de forma opcional a [start:end], con start como inclusivo y end como exclusivo.

Parámetros

Parámetro Descripción
sub string o tupla de strings; obligatorio
Es el prefijo (o la tupla de prefijos alternativos) que se debe coincidir.
start int o None; el valor predeterminado es 0
Prueba que comienza en esta posición.
end int o None; El valor predeterminado es None
Detén la comparación en esta posición.

strip

string string.strip(chars=None)

Devuelve una copia de la cadena 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 cadena o None; El valor predeterminado es None
Los caracteres que se quitarán o todos los espacios en blanco si es None.

título

string string.title()

Convierte la cadena de entrada en mayúsculas de título, es decir, cada palabra comienza con una letra mayúscula y las letras restantes son minúsculas. En este contexto, una palabra significa estrictamente una secuencia de letras. Este método no admite caracteres Unicode complementarios.

mayor

string string.upper()

Devuelve la versión en mayúsculas de esta cadena.