$\texttt{reemplazar\_primero}(texto, sub, nuevo_{sub})$

Nombre

reemplazar_primero - Reemplaza la primera ocurrencia de un patron dentro de un texto.

Sinopsis

nuevo = strings.reemplazar_primero(texto, sub, nuevo_sub)

Descripcion

Busca un patron dentro de un texto y reemplaza solo la primera ocurrencia por otro.

Es util para:

• hacer sustituciones controladas
• modificar encabezados o prefijos
• corregir solo la primera coincidencia

Comportamiento

• Explora el texto buscando sub.
• Cambia solo la primera coincidencia encontrada.
• Devuelve un nuevo STRING con el reemplazo aplicado.

Funciones API relacionadas

• strings.posicion_ocurrencias()
• strings.contiene_substr()
• strings.contar_ocurrencias()
• strings.reemplazar_todos()
• strings.extraer_entre()

Parámetros

Valor de retorno

STRING - Texto con el primer patron cambiado.

Ejemplo

INCLUIR "strings.api"

FUNCION PRINCIPAL
INICIO 

	STRING str, sub, new_sub, resultado
	VECTOR v[30]
	NUMERICO i, cant

	str = "No es lo que logras, es lo que superas. Eso es lo que define tu vida."
	sub = "superas."
	new_sub = "CON DOLOR SUPERAS."

	resultado = strings.reemplazar_primero(str, sub, new_sub)

	DEPURAR(str)
	DEPURAR(resultado)
FINAL