basic.%wait C Function/BASIC Program

basic.%wait

Command basic.%wait C Function/BASIC Program
Applicable release versions: AP/Unix
Category BASIC Program (486)
Description returns the exit code of the child process(es) created by the current process.
The "status" is returned in the integer "status", passed by its address.
Note that even though "status" is an integer, only the lower 16 bits are updated by the system call. See the Unix Programmer's Reference Manual for more details on the format of the returned status.
Syntax variable=%wait( &status)
Options
Example
status=0
(void)%wait( &status )
high$status=int(status/256)
low$status=mod(status,256)
begin case
  case low$status=255
  * Child stopped due to a signal
  case low$status=0
  * Child stopped by calling exit()
  case high$status=0
  * Child was terminated due to a signal
end case
Purpose
Related basic.cfunc
basic.cfunction