Process es la clase base para todas las llamadas basadas en Bridge para la comunicación con el shell de la Yun. No se llama directamente, sino que invoca cada vez que se utiliza una función que depende de él.
FUNCIONES
begin()
Descripción:
Inicia un proceso llamado Linux. Sólo el comando debería llamarse aquí, seguido de run () o runAsynchronously (), y opcionalmente addParameter (). El proceso de llamada no comienza la ejecución hasta que run () se llama.
Sintaxis:
Process.begin(cmd)
Parámetros:
cmd (string): el comando Linux que desea ejecutar.
Retornos:
Ninguno
________________________________________________________________________
addParameter()()
Descripción:
addParameter () añade un parámetro a un comando de Linux iniciado con begin (). No es necesario añadir espacios, addParameter () los inserta por usted.
Sintaxis:
Process.addParameter(param)
Parámetros:
param (string): El parámetro que desea añadir a un comando
Retornos:
Ninguno
________________________________________________________________________
run()
Descripción:
Inicia un proceso de Linux identificado en Process.begin ().
run () es una función de bloqueo. Es decir, una vez que se llama a Process.run (), nada más va a pasar en el programa hasta que se haya completado. El tiempo depende de la naturaleza del comando que se está ejecutando. Para una alternativa de no bloqueo, ver runAsynchronously ().
Sintaxis:
Process.run()
Parámetros:
Ninguno
Retornos:
int
________________________________________________________________________
runAsynchronously()()
Descripción:
Inicia un proceso de Linux identificado en Process.begin ().
A diferencia de run(), runAsynchronously () es de no-bloqueo. Su programa continuará funcionando mientras que el proceso de Linux se ejecuta en segundo plano.
Tenga en cuenta que dado que Process.begin (). hace una llamada para cerrar que termina el proceso en ejecución. Esta es la razón por la cual no se pueden ejecutar 2 procesos al mismo tiempo con la misma instancia de Process.
Sintaxis:
Process.runAsynchronously()
Parámetros:
Ninguno
Retornos:
Ninguno
________________________________________________________________________
running()
Descripción:
Comprueba un proceso iniciado por runAsynchronously () para ver si todavía está en marcha.
Sintaxis:
Process.running()
Parámetros:
Ninguno
Retornos:
boolean
________________________________________________________________________
exitValue()
Descripción:
Devuelve el valor de salida (también conocido como código de retorno) de un proceso que se estaba ejecutando. Utilizado por run () y runShellCommand () para devolver el estado del proceso que el usuario ha puesto en marcha.
exitValue () devuelve un 0 si el proceso se ha completado correctamente.
Si se produce un error durante el proceso el valor de salida será diferente a 0. No hay una definición estándar para el código de retorno, que depende del proceso. Consulte la documentación de Process para saber lo que significa el código.
Sintaxis:
Process.exitValue()
Parámetros:
Ninguno
Retornos:
unsigned int. 0 si el proceso se ha completado correctamente. Cualquier valor distinto de 0 significa que se produjo un error durante el proceso. No hay un estándar para el código de retorno, depende del proceso que ha ejecutado.
________________________________________________________________________
close()
Descripción:
Cierra un proceso iniciado por runAsynchronously ().
Sintaxis:
Process.close()
Parámetros:
Ninguno
Retornos:
Ninguno
________________________________________________________________________
runShellCommand()()
Descripción:
Inicia un comando shell en Linux.
runShellCommand () es una función de bloqueo. Es decir, una vez que se llama a Process.runShellCommand (), nada más va a pasar en el programa hasta que se haya completado. El tiempo depende de la naturaleza del comando que se está ejecutando. Para una alternativa de no bloqueo, ver runShellCommandAsynchronously ().
Sintaxis:
Process.runShellCommand(cmd)
Parámetros:
cmd: string que contiene el comando
Retornos:
int
_______________________________________________________________
runShellCommandAsynchronously()()
Descripción:
Inicia un comando shell de Linux
A diferencia de runShellCommand (), runShellCommandAsynchronously () es de no-bloqueo. Su programa continuará funcionando mientras que el proceso de Linux se ejecuta en segundo plano.
Tenga en cuenta que puesto que Process.begin (). llama a cerrar el proceso en ejecución se termina. Esta es la razón por la cual no se pueden ejecutar 2 procesos al mismo tiempo con la misma instancia de Process.
Sintaxis:
Process.runShellCommandAsynchronously(cmd)
Parámetros:
cmd: string que contiene el comando
Retornos:
Ninguno
________________________________________________________________________
available()
Descripción:
Obtiene el número de bytes (caracteres) disponibles para la lectura en la conexión de Linux. Se trata de datos que ya llegaron y se almacenan en el buffer de recepción.
Sintaxis:
Process.available()
Parámetros:
Ninguno
Retornos:
El número de bytes disponibles para leer
____________________________________________________________________
read()
Descripción:
Lee los datos entrantes de un proceso Linux.
Sintaxis:
Process.read()
Parámetros:
Ninguno
Retornos:
int: el primer byte de datos de entrada disponible (o -1 si no hay datos disponibles)
________________________________________________________________________
write()
Descripción:
Escribe datos en un proceso Linux. Estos datos se envían como un byte o una serie de bytes.
Sintaxis:
Process.write(val)
Process.write(str)
Process.write(buf, len)
Parámetros:
val: un valor a enviar como un solo byte
str: una cadena para enviar como una serie de bytes
buf: una matriz para enviar como una serie de bytes
len: la longitud de la memoria intermedia (buffer)
Retornos:
byte: el número de bytes escritos. La lectura del número es opcional.
________________________________________________________________________
peek()
Descripción:
Devuelve el siguiente byte (carácter) de los datos entrantes de un proceso Linux sin sacarlo de la memoria intermedia interna (buffer). Sucesivas llamadas a peek () devolverán el mismo carácter, como si fuera una siguiente llamada a read ().
Sintaxis:
Process.peek()
Parámetros:
Ninguno
Retornos:
int: el primer byte de datos de entrada disponible (o -1 si no hay datos disponibles)
________________________________________________________________________
flush()
Descripción:
Borra los bytes del buffer de Process. Espera a que la transmisión de datos de salida se complete.
Sintaxis:
Process.flush()
Parámetros:
Ninguno
Retornos:
Ninguno
No hay comentarios:
Publicar un comentario