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: 9.5   10.0   10.1   10.2   10.3   10.4   10.5   11.0   11.1   11.2    Statistic    FMM    Blog  

Shell.ReadOutputText

Reads output.

Component Version macOS Windows Linux Server FileMaker 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.

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

  • Version 11.2
    • Changed a couple of internal text functions to recognize that text with UTF-8 as a BOM for UTF-16 or UTF-32 and then reinterpret bytes to handle that. Useful for Shell.ReadOutputText, when a command line tool outputs UTF-16 instead of expected UTF-8.

Example Databases

Blog Entries

Created 11st November 2017, last changed 7th April 2020


Shell.ReadErrorText   -   Shell.Release

Feedback: Report problem or ask question.




Links
MBS Xojo blog

Start Chat