Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server (Not)   Client   Old   Guides   Examples
New in version: 6.4   6.5   7.0   7.1   7.2   7.3   7.4   7.5   8.0   8.1    Statistic  


Reads output.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
Shell 7.5 Yes Yes Yes Yes No

MBS( "Shell.ReadOutputText"; ShellRef { ; Encoding } )


Parameter Description Example value
ShellRef The reference number from the shell. $shell
Encoding Optional
The text encoding for result.
Possible encoding names: ANSI, Arabic-Mac, Arabic-Win, Baltic-Win, CentralEurope-Mac, ChineseSimp-Mac, ChineseSimp-Win, ChineseTrad-Mac, ChineseTrad-Win, Cyrillic-Mac, Cyrillic-Win, EasternEurope-Win, Greek-Mac, Greek-Win, Hebrew-Mac, Hebrew-Win, ISO-8859-1, ISO-8859-2, ISO-8859-3, ISO-8859-4, ISO-8859-5, ISO-8859-6, ISO-8859-7, ISO-8859-8, ISO-8859-9, ISO-8859-15, Korean-Johab, Korean-Mac, Korean-Win, Latin1, Mac, Native, ShiftJIS-Mac, ShiftJIS-Win, Turkish-Mac, Turkish-Win, UTF-8, DOS or Windows. Pass native to use the native encoding of the current platform.


Returns OK or error.


Reads output.
When child process writes something to output stream, you can read it here.


Loop and collect messages:

Set Variable [ $error ; Value: "" ]
Set Variable [ $result ; Value: "" ]
# Loop while app runs and collect messages
    # 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

Example Databases

Shell.ReadErrorText   -   Shell.Release

Feedback: Report problem or ask question.

MBS FileMaker tutorial videos