Package com.android.utils

Enum GrabProcessOutput.Wait

java.lang.Object

java.lang.Enum<GrabProcessOutput.Wait>

com.android.utils.GrabProcessOutput.Wait

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<GrabProcessOutput.Wait>

Enclosing class:

GrabProcessOutput

public static enum GrabProcessOutput.Wait
extends java.lang.Enum<GrabProcessOutput.Wait>

Enum Constant Summary

Enum Constants

Enum Constant	Description
ASYNC	Doesn't wait for the exec to complete.
WAIT_FOR_PROCESS	This waits for the process to finish.
WAIT_FOR_READERS	This waits for the process to finish and for the stdout/stderr threads to complete.

Method Summary

Modifier and Type	Method	Description
static GrabProcessOutput.Wait	valueOf(java.lang.String name)	Returns the enum constant of this type with the specified name.
static GrabProcessOutput.Wait[]	values()	Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

ASYNC

public static final GrabProcessOutput.Wait ASYNC

Doesn't wait for the exec to complete. This still monitors the output but does not wait for the process to finish. In this mode the process return code is unknown and always 0.

WAIT_FOR_PROCESS

public static final GrabProcessOutput.Wait WAIT_FOR_PROCESS

This waits for the process to finish. In this mode, GrabProcessOutput.grabProcessOutput(java.lang.Process, com.android.utils.GrabProcessOutput.Wait, com.android.utils.GrabProcessOutput.IProcessOutput) returns the error code from the process. In some rare cases and depending on the OS, the process might not have finished dumping data into stdout/stderr.

Use this when you don't particularly care for the output but instead care for the return code of the executed process.

WAIT_FOR_READERS

public static final GrabProcessOutput.Wait WAIT_FOR_READERS

This waits for the process to finish and for the stdout/stderr threads to complete. In this mode, GrabProcessOutput.grabProcessOutput(java.lang.Process, com.android.utils.GrabProcessOutput.Wait, com.android.utils.GrabProcessOutput.IProcessOutput) returns the error code from the process.

Use this one when capturing all the output from the process is important.

Method Detail

values

public static GrabProcessOutput.Wait[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (GrabProcessOutput.Wait c : GrabProcessOutput.Wait.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static GrabProcessOutput.Wait valueOf(java.lang.String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null