Process (gb)

Questa classe viene utilizzata per la gestione dei processi avviati dalle istruzioni EXEC o SHELL.

Poiché questa classe è uno stream, è possibile utilizzare le istruzioni di input/output per leggere l'output standard del processo o scrivere nel suo input standard.

Per leggere l'output dell'errore di processo, è necessario utilizzare l'evento Error.

Questa classe eredita Stream.

Questa classe non è creabile.

Costanti
Crashed   Costante utilizzata dalla proprietà State per indicare un processo bloccato.
Running   Costante utilizzata dalla proprietà State per indicare un processo in esecuzione.
Signaled   Un sinonimo per la costante Crashed.
Stopped   Costante utilizzata dalla proprietà State per indicare un processo arrestato.

Proprietà statiche
LastState   Restituisce lo stato dell'ultimo processo terminato.
LastValue   Restituisce il valore di ritorno dell'ultimo processo terminato.

Proprietà
Handle   Restituisce l'identificatore del processo (alias pid) dell'oggetto processo.
Id   Un sinonimo di Handle.
Ignore   Restituisce o imposta se il processo viene ignorato.
State   Restituisce lo stato corrente dell'oggetto processo:
Value   Ritorna il valore restituito dal processo al momento dell'uscita o il numero del segnale emesso in caso di crash.

Proprietà ereditate
Blocking   Restituisce o imposta se lo stream è bloccato.
ByteOrder   Restituisce o imposta il byte order utilizzato per leggere o scrivere dati binari nello stream.
EndOfFile   Questa proprietà permette di sapere se l'ultimo utilizzo di LINE INPUT ha raggiunto la fine del file invece di leggere una riga completa con un carattere di end-of-line.
EndOfLine   Restituisce o imposta il separatore di nuova riga utilizzato dallo stream.
Eof   Ritorna se uno stream ha raggiunto la fine.
IsTerm   Ritorna se un flusso è associato a un terminale.
Lines   Restituisce un oggetto virtuale che consente di enumerare uno stream riga per riga.
NoShare  
NullTerminatedString  
Tag   Restituisce o imposta il tag associato allo stream.
Term   Restituisce un oggetto virtuale che consente di gestire il terminale associato allo stream.

Metodi
CloseInput   Chiude lo stream di input del processo.
Kill   Termina immediatamente il processo.
Signal   Invia un segnale dell'utente al processo.
Wait   Attende la fine del processo, come l'opzione WAIT nelle istruzioni SHELL e EXEC.

Metodi ereditati
Begin   Inizia a bufferizzare i dati scritti nello stream, in modo che tutto venga inviato quando viene chiamato il metodo Send.
Close   Chiude lo stream.
Drop   Libera i dati che sono stati memorizzati nel buffer dall'ultima chiamata al metodo Begin.
ReadLine   Legge una riga di testo dallo stream, come l'istruzione LINE INPUT.
Send   Invia tutti i dati, in un'unica volta, dall'ultima chiamata a Begin.
Watch   Avvia o interrompe la visione del descrittore del file di stream per la lettura o la scrittura, dopo che questo è stato aperto.

Eventi
Error   Viene generato quando sono presenti dati da leggere sull'output di errore standard del processo.
Kill   Viene generato quando il processo è terminato, normalmente o in modo anomalo.
Read   Viene generato quando ci sono dati da leggere dall'output standard del processo.

Se è necessario inviare un CTRL+D a un processo in esecuzione, come se fosse stato eseguito in una shell, chiudere semplicemente lo stream di processo.

Questo comportamento è deprecato da Gambas 3.9. Ora la chiusura di uno stream di processo lo rende inutilizzabile e al suo posto è necessario utilizzare il nuovo metodo CloseInput.