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.

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

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

• Shell.Execute
• Shell.IsRunning
• Shell.PeekOutputText
• Shell.ReadErrorText
• Shell.Wait
• Text.ReplaceNewline

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

• Shell/Shell Ping
• Shell/Shell
• Shell/Terminal

Blog Entries

• MBS FileMaker Plugin, version 11.2pr1
• Tip of the day: Shell Execute as one Let statement
• Run fmsadmin from script
• Convert office documents to PDF with LibreOffice
• Tips for FileMaker Data Migration Tool
• Execute defaults command with Shell functions
• Convert to MP3 with new Shell commands and ffmpeg

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

Shell.ReadErrorText   -   Shell.Release

Feedback: Report problem or ask question.