Run Program

Associated Constructors

Run Program

Syntax: obj = Run Program( Executable( "path/etc.exe" ), < Options( {"/a", "/b etc" } ) >, < Parameter( optParm ) >, < Read Function( Function( {this, optParm}, etc ) | "text" | "blob" ) >, < Write Function( Function( {this, optParm}, etc ) ) >)

Description: Control an external program using stdin and stdout.

RP = Run Program(
    Executable( "PING.EXE"/*path probably not needed*/ ),
    Options( {"-n 5", "localhost"} ),
    ReadFunction( Function( {this}, Write( this << read ) ) )
);

Item Messages

Can Read

Syntax: bool = obj << Can Read

Description: Returns 1 if the RunProgram object can be read from and 0 if not.

value = "";
rp = Run Program( Executable( "ping.exe" ), Options( {"-n 5", "localhost"} ) );
While( !(rp << Is Read EOF), If( rp << Can Read, value ||= rp << Read, Wait( 0.01 ) ) );
Show( value );

Can Write

Syntax: bool = obj << Can Write

Description: Returns boolean for whether or not the RunProgram object can be written to via standard input.

Is Read EOF

Syntax: bool = obj << Is Read EOF

Description: Returns 1 if the program has finished writing to standard output and 0 if not.

value = "";
rp = Run Program( Executable( "ping.exe" ), Options( {"-n 5", "localhost"} ) );
While( !(rp << Is Read EOF), If( rp << Can Read, value ||= rp << Read, Wait( 0.01 ) ) );
Show( value );

Read

Syntax: value = obj << Read( < "blob" > )

Description: Read standard output from executable as text or blob.

value = "";
rp = Run Program(
    Executable( "ping.exe" ),
    Options( {"-n 5", "localhost"} ),
    ReadFunction(
        Function( {this},
            value ||= this << read;
            Show( value );
        )
    )
);

Write

Syntax: obj << Write( string )

Description: Write text to the program's standard input.

Write EOF

Syntax: obj << Write EOF

Description: Write the end of file for the RunProgram object.