string

Informar un problema . Ver fuente . Por la noche · 7.3 · 7.2 · 7.1 · 7.0 · 6.5

Un tipo de lenguaje integrado para admitir cadenas de texto. 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 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. usa el operador + en su lugar. 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 lo hay) en mayúscula y el resto en minúsculas. Este método no admite caracteres no ASCII.

count

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

Muestra la cantidad de casos (no superpuestos) de la subcadena sub en la cadena, restringiendo opcionalmente a [start:end], en el que start es inclusivo y end es exclusivo.

Parámetros

Parámetro Descripción
sub string; obligatorio
Subcadena que se va a 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
posición opcional antes de la cual restringir a la búsqueda.

elementos

sequence string.elems()

Muestra un valor iterable que contiene subcadenas sucesivas de 1 elemento de la cadena. Equivale a [s[i] for i in range(len(s))], con la excepción de que el valor que se muestra puede no ser una lista.

endswith

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

Muestra el valor True si la cadena termina con sub; de lo contrario, muestra False, y se restringe de manera opcional a [start:end], y si start es inclusivo y end sí lo es.

Parámetros

Parámetro Descripción
sub string; o tupla de cadenas; obligatorio
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
posición opcional en la que detener 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. De manera opcional, se restringe a [start:end], en el que start es inclusivo y end es exclusivo.

Parámetros

Parámetro Descripción
sub string; obligatorio
Subcadena 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
posición opcional antes de la cual restringir a la búsqueda.

formato

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

Realiza una interpolación de cadenas. Las cadenas 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 mediante la duplicación: {{ y }}. Un campo de reemplazo puede ser un nombre, un número o un campo vacío. Los valores se convierten en cadenas usando 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 {}
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 tal índice. De manera opcional, restringe la opción para que [start:end]start sea inclusivo y end sea exclusivo.

Parámetros

Parámetro Descripción
sub string; obligatorio
Subcadena 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
posición opcional antes de la cual restringir a la búsqueda.

isalnum

bool string.isalnum()

Muestra el valor Verdadero 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 Verdadero 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 Verdadero si todos los caracteres de la string son dígitos ([0-9]) y hay, al menos, un carácter.

islower

bool string.islower()

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

isspace

bool string.isspace()

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

istitle

bool string.istitle()

Muestra el valor Verdadero si la string está en mayúsculas de título y contiene al menos un carácter. Esto significa que cada carácter en mayúscula debe ir después del carácter que no está en mayúsculas (p.ej., espacio en blanco), y que cada carácter en minúscula debe ir después del carácter que está en mayúscula (p.ej., mayúscula o minúscula).

isupper

bool string.isupper()

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

unir

string string.join(elements)

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

Parámetros

Parámetro Descripción
elements obligatorio
Los objetos que se van a unir

menor

string string.lower()

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

lstrip

string string.lstrip(chars=None)

Muestra 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 string; o None; el valor predeterminado es None
Los caracteres que se quitarán o todos los espacios en blanco si el valor es Ninguno

partición

tuple string.partition(sep)

Divide la cadena de entrada en la primera aparición del separador sep y muestra la partición resultante como una tupla de tres elementos del formulario (antes, separador, después). Si la cadena de entrada no contiene el separador, se muestra la partición (self, '', '').

Parámetros

Parámetro Descripción
sep string; obligatorio
Cadena en la que se va a dividir.

removeprefix

string string.removeprefix(prefix)

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

Parámetros

Parámetro Descripción
prefix string; obligatorio
El prefijo que se quitará si está presente.

removesuffix

string string.removesuffix(suffix)

Si la cadena termina con suffix, muestra una cadena nueva sin el sufijo. De lo contrario, muestra la cadena.

Parámetros

Parámetro Descripción
suffix string; obligatorio
El sufijo que se quitará 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 y, de manera opcional, restringe la cantidad de reemplazos a count.

Parámetros

Parámetro Descripción
old string; obligatorio
Cadena que se reemplazará.
new string; obligatorio
Cadena con la que se va a reemplazar.
count int; el valor predeterminado 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 encontró sub, o bien -1 si no existe tal índice. De manera opcional, se restringe a [start:end], en el que start es inclusivo y end es exclusivo.

Parámetros

Parámetro Descripción
sub string; obligatorio
Subcadena 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
posición opcional antes de la cual restringir a la búsqueda.

rindex

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

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

Parámetros

Parámetro Descripción
sub string; obligatorio
Subcadena 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
posición opcional antes de la cual restringir a la búsqueda.

rpartition

tuple string.rpartition(sep)

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

Parámetros

Parámetro Descripción
sep string; obligatorio
Cadena en la que se va a dividir.

rsplit

list string.rsplit(sep, maxsplit=None)

Muestra una lista de todas las palabras de la string, con sep como separador y, de manera opcional, limitando la cantidad de divisiones a maxsplit. Excepto por la división desde la derecha, este método se comporta como split().

Parámetros

Parámetro Descripción
sep string; obligatorio
Cadena en la que se va a dividir.
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 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 string; o None; el valor predeterminado es None
Los caracteres que se quitarán o todos los espacios en blanco si el valor es Ninguno

split

list string.split(sep, maxsplit=None)

Muestra una lista de todas las palabras de la string, con sep como separador y, de manera opcional, limitando la cantidad de divisiones a maxsplit.

Parámetros

Parámetro Descripción
sep string; obligatorio
Cadena en la que se va a dividir.
maxsplit int; o None; el valor predeterminado es None
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 muestra el resultado como una nueva lista mutable.

Parámetros

Parámetro Descripción
keepends bool; el valor predeterminado es False
Si los saltos de línea deben incluirse en la lista resultante.

startswith

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

Muestra el valor True si la cadena comienza con sub; de lo contrario, muestra False, restringiendo opcionalmente a [start:end], start es inclusivo y end exclusivo.

Parámetros

Parámetro Descripción
sub string; o tupla de cadenas; obligatorio
Prefijo (o 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 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 string; o None; el valor predeterminado es None
Los caracteres que se quitarán o todos los espacios en blanco si el valor es Ninguno

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, mientras que las letras restantes están en minúscula. En este contexto, una palabra significa estrictamente una secuencia de letras. Este método no admite caracteres Unicode complementarios.

mayor

string string.upper()

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