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.3
9.4
9.5
10.0
10.1
10.2
10.3
10.4
10.5
10.6
Statistic
FMM
Blog
SSH.ReadText
Reads bytes from channel and returns them as text.
| Component | Version | macOS | Windows | Linux | Server | FileMaker iOS SDK |
| SSH | 6.3 | Yes | Yes | Yes | Yes | Yes |
Parameters
| Parameter | Description | Example | Flags |
|---|---|---|---|
| SSH | The SSH session reference number from the plugin. | $ssh | |
| length | Maximum number of bytes to read. | 10 | Optional |
| Encoding | The text encoding for result. Default is UTF-8. Possible encoding names: ANSI, ISO-8859-1, Latin1, Mac, Native, UTF-8, DOS, Hex, Base64 or Windows. More listed in the FAQ. |
UTF8 | Optional |
| Stream | Which stream to read. Can be stdout or stderr. Stdout is default if parameter is empty or missing. |
"StdOut" | Optional |
Result
Returns text or error message.
Description
Reads bytes from channel and returns them as text.The text returned may be shorter than length bytes.
Examples
Read all text:
# We read text in several chunks until no new text is coming any more:
Set Variable [$text; Value:""]
Loop
Pause/Resume Script [Duration (seconds): ,1]
# Read some text:
Set Variable [$newtext; Value:MBS( "SSH.ReadText"; $ssh; 10000; "UTF8" )]
If [MBS("iserror") = 0]
If [Length($newText) > 0]
Set Variable [$text; Value:$text & $newText]
End If
Exit Loop If [Length($newText) = 0]
End If
End Loop
Set Field [SSH::Result; $text]
See also
Example Databases
Created 29th May 2016, last changed 27th May 2017
Feedback: Report problem or ask question.
Links
MBS Xojo PDF Plugins
