De acuerdo a la documentación, tanto en Java
como en Kotlin
la definición del método flush() es:
Vacía el stream escribiendo cualquier salida almacenada en el stream
subyacente.
Cuando estas haciendo uso de un stream, como ejemplo cuando pasamos información a un archivo, en ocasiones se mantiene información en la clase que esta manejando el stream, con flush() se obliga a que pase toda la información.
Puedes usar close() al terminar la lectura de información, pero para asegurar el envió de los datos pero sin cerrar el stream usamos flush().
Ejemplo:
fun copyInputStreamToFile(inputStream: InputStream, outputStream: FileOutputStream) {
val buffer = ByteArray(2048)
inputStream.use { input ->
outputStream.use { fileOut ->
while (true) {
val length = input.read(buffer)
if (length <= 0)
break
fileOut.write(buffer, 0, length)
}
//Aseguramos enviar toda la información.
fileOut.flush()
//Cerramos Stream.
fileOut.close()
}
}
inputStream.close()
}