$\texttt{copiar}(origen, destino)$

Nombre

copiar - Copia el contenido completo de un archivo de texto en otro archivo.

Sinopsis

cant = archivos.copiar(origen, destino)

Descripcion

Copia el contenido completo de un archivo de texto en otro archivo.

Que hace: Abre el archivo origen en modo lectura (r) y el archivo destino en modo escritura (w). Luego lee el origen linea por linea y va escribiendo cada linea en el destino, agregando un salto de linea .

• Si no puede abrir origen o destino, retorna 0.
• Si la escritura falla en algun punto, detiene la copia.
• Al finalizar, cierra ambos archivos y retorna la cantidad de lineas procesadas.

Para que puede usarse:

• Duplicar un archivo de configuracion o plantilla antes de modificarlo.
• Generar una copia de seguridad rapida.
• Exportar el resultado de un proceso a un nuevo archivo manteniendo el original intacto.
• Crear versiones de un archivo.

Comportamiento

• Abre origen en lectura y destino en escritura.
• Copia linea por linea usando LEER_LINEA() y ESCRIBIR_LINEA().
• Cierra ambos archivos al finalizar.
• Retorna la cantidad de lineas procesadas o 0 si falla la apertura.

Funciones API relacionadas

• archivos.str_a_archivo()
• archivos.archivo_a_str()
• archivos.archivo_a_vectorstr()

Parámetros

Valor de retorno

NUMERICO - Cantidad de lineas procesadas. Retorna 0 si falla al abrir origen o destino.

Ejemplo

INCLUIR "archivos.api"

FUNCION PRINCIPAL
INICIO

	STRING   origen, destino
	NUMERICO resultado

	origen = "texto1.txt"
	destino = "texto2.txt"

	resultado = archivos.copiar(origen, destino)
	IMPRIMIR(resultado)
	SI (resultado) ENTONCES
		IMPRIMIR("\nArchivo copiado con suceso!")
	SINO	
		IMPRIMIR("\nFalla en copia de archivo!")
	FIN_SI

FINAL