Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 10.1   10.2   10.3   10.4   10.5   11.0   11.1   11.2   11.3   11.4    Statistic    FMM    Blog  

Shell.ReadOutputText

Reads output.

Component Version macOS Windows Linux Server iOS SDK
Shell 7.5 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ❌ No
MBS( "Shell.ReadOutputText"; ShellRef { ; Encoding } )   More

Parameters

Parameter Description Example Flags
ShellRef The reference number from the shell. $shell
Encoding The text encoding for result.
Possible encoding names: ANSI, ISO-8859-1, Latin1, Mac, Native, UTF-8, DOS, Hex, Base64 or Windows. More listed in the FAQ.
UTF8 Optional

Result

Returns text or error.

Description

Reads output.
When child process writes something to output stream, you can read it here.
See also Shell.ReadErrorText for reading error output.

The plugin internally queries Shell.AvailableBytesOutput to see how much to read and return.

Examples

Loop and collect messages:

Set Variable [ $error ; Value: "" ]
Set Variable [ $result ; Value: "" ]
# Loop while app runs and collect messages
Loop
    # Wait a second or till it quits
    Set Variable [ $s ; Value: MBS( "Shell.Wait"; $shell; 1) ]
    # And read output
    Set Variable [ $error ; Value: $error & MBS( "Shell.ReadErrorText"; $shell; "UTF-8") ]
    Set Variable [ $result ; Value: $result & MBS( "Shell.ReadOutputText"; $shell; "UTF-8") ]
    Set Field [ Shell::Error ; MBS( "Text.ReplaceNewline"; $error; 1) ]
    Set Field [ Shell::Output ; MBS( "Text.ReplaceNewline"; $result; 1) ]
    # exit when done
    Exit Loop If [ MBS( "Shell.IsRunning"; $shell) ≠ 1 ]
End Loop

See also

Release notes

Example Databases

Blog Entries

Created 11st November 2017, last changed 22nd April 2021


Shell.ReadErrorText - Shell.Release

Feedback: Report problem or ask question.