Components | All | New | MacOS | Windows | Linux | iOS | ||||
Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old |
MatrixDongle.ReadText
Reads data as text from the Matrix-Dongle.
Component | Version | macOS | Windows | Linux | Server | iOS SDK |
MatrixDongle | 5.2 | ✅ Yes | ✅ Yes | ❌ No | ✅ Yes, on macOS and Windows | ❌ No |
Deprecated
This function was deprecated.
MBS( "MatrixDongle.ReadText"; UserCode; Pos; Count { ; Encoding; DongleNumber; PortNumber } ) More
Parameters
Parameter | Description | Example | Flags |
---|---|---|---|
UserCode | This is your personal UserCode and must correspond with the internal UserCode from the dongle. | ||
Pos | The position to write at. This value is in 4 byte data words, so for 12 bytes offset pass 3. | 0 | |
Count | Number of data words to read. 4 bytes per data word. | 1 | |
Encoding | The text encoding for text parameter. 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 |
DongleNumber | This is the dongle number when several dongles are plugged in one after the other. The maximum number of dongles available can be determined via the MatrixDongle.Count function. A maximum of 99 dongles can be connected to the LPT port and a maximum of 127 dongles to the USB connection. The plugin uses 1 if you don't pass this parameter. |
1 | Optional |
PortNumber | With LPT dongles, this is the number of the LPT port to which the dongles are connected. With LPT dongles, the port number must be between 1 and 3. Example: 1 for LPT1, 2 for LPT2 or 3 for LPT3. With USB, this parameter must be 85. This variable is ignored with network calls. Default for MBS Plugin is 85 for USB. |
85 | Optional |
Result
Returns text or error.
Description
Reads data as text from the Matrix-Dongle.Starts reading at the given position and reads count number of data words.
See also
This function does not need a paid license.
Created 1st August 2015, last changed 31st July 2020