com.android.utils
Enum GrabProcessOutput.Wait

java.lang.Object
  extended by java.lang.Enum<GrabProcessOutput.Wait>
      extended by 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
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
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