Added in API level 29

Summary: Nested Classes | Methods | Inherited Methods

FileUtils

---

Kotlin |Java

public final class FileUtils
extends Object

java.lang.Object
↳	android.os.FileUtils

---

Utility methods useful for working with files.

Summary

Nested classes
interface	FileUtils.ProgressListener Listener that is called periodically as progress is made.

Public methods
static void	closeQuietly(FileDescriptor fd) This method was deprecated in API level 30. This method may suppress potentially significant exceptions, particularly when closing writable resources. With a writable resource, a failure thrown from close() should be considered as significant as a failure thrown from a write method because it may indicate a failure to flush bytes to the underlying resource.
static void	closeQuietly(AutoCloseable closeable) This method was deprecated in API level 30. This method may suppress potentially significant exceptions, particularly when closing writable resources. With a writable resource, a failure thrown from close() should be considered as significant as a failure thrown from a write method because it may indicate a failure to flush bytes to the underlying resource.
static long	copy(InputStream in, OutputStream out, CancellationSignal signal, Executor executor, FileUtils.ProgressListener listener) Copy the contents of one stream to another.
static long	copy(FileDescriptor in, FileDescriptor out, CancellationSignal signal, Executor executor, FileUtils.ProgressListener listener) Copy the contents of one FD to another.
static long	copy(FileDescriptor in, FileDescriptor out) Copy the contents of one FD to another.
static long	copy(InputStream in, OutputStream out) Copy the contents of one stream to another.

Inherited methods

From class java.lang.Object Object clone() Creates and returns a copy of this object. boolean equals(Object obj) Indicates whether some other object is "equal to" this one. void finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. final Class<?> getClass() Returns the runtime class of this Object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait() Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public methods

closeQuietly

Added in API level 29
Deprecated in API level 30

public static void closeQuietly (FileDescriptor fd)

This method was deprecated in API level 30.
This method may suppress potentially significant exceptions, particularly when closing writable resources. With a writable resource, a failure thrown from close() should be considered as significant as a failure thrown from a write method because it may indicate a failure to flush bytes to the underlying resource.

Closes the given object quietly, ignoring any checked exceptions. Does nothing if the given object is null.

Parameters
fd	FileDescriptor: This value may be null.

closeQuietly

Added in API level 29
Deprecated in API level 30

public static void closeQuietly (AutoCloseable closeable)

This method was deprecated in API level 30.
This method may suppress potentially significant exceptions, particularly when closing writable resources. With a writable resource, a failure thrown from close() should be considered as significant as a failure thrown from a write method because it may indicate a failure to flush bytes to the underlying resource.

Closes the given object quietly, ignoring any checked exceptions. Does nothing if the given object is null.

Parameters
closeable	AutoCloseable: This value may be null.

copy

Added in API level 29

public static long copy (InputStream in, 
                OutputStream out, 
                CancellationSignal signal, 
                Executor executor, 
                FileUtils.ProgressListener listener)

Copy the contents of one stream to another.

Attempts to use several optimization strategies to copy the data in the kernel before falling back to a userspace copy as a last resort.

Parameters
in	InputStream: This value cannot be null.
out	OutputStream: This value cannot be null.
signal	CancellationSignal: to signal if the copy should be cancelled early. This value may be null.
executor	Executor: that listener events should be delivered via. This value may be null.
listener	FileUtils.ProgressListener: to be periodically notified as the copy progresses. This value may be null.

Returns
long	number of bytes copied.

Throws
IOException

copy

Added in API level 29

public static long copy (FileDescriptor in, 
                FileDescriptor out, 
                CancellationSignal signal, 
                Executor executor, 
                FileUtils.ProgressListener listener)

Copy the contents of one FD to another.

Attempts to use several optimization strategies to copy the data in the kernel before falling back to a userspace copy as a last resort.

Parameters
in	FileDescriptor: This value cannot be null.
out	FileDescriptor: This value cannot be null.
signal	CancellationSignal: to signal if the copy should be cancelled early. This value may be null.
executor	Executor: that listener events should be delivered via. This value may be null.
listener	FileUtils.ProgressListener: to be periodically notified as the copy progresses. This value may be null.

Returns
long	number of bytes copied.

Throws
IOException

copy

Added in API level 29

public static long copy (FileDescriptor in, 
                FileDescriptor out)

Copy the contents of one FD to another.

Attempts to use several optimization strategies to copy the data in the kernel before falling back to a userspace copy as a last resort.

Parameters
in	FileDescriptor: This value cannot be null.
out	FileDescriptor: This value cannot be null.

Returns
long	number of bytes copied.

Throws
IOException

copy

Added in API level 29

public static long copy (InputStream in, 
                OutputStream out)

Copy the contents of one stream to another.

Attempts to use several optimization strategies to copy the data in the kernel before falling back to a userspace copy as a last resort.

Parameters
in	InputStream: This value cannot be null.
out	OutputStream: This value cannot be null.

Returns
long	number of bytes copied.

Throws
IOException