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

CUPS.PrintData

Print a file to a printer or class on the default server.

Component Version macOS Windows Linux Server iOS SDK
CUPS 2.5 ✅ Yes ❌ No ❌ No ✅ Yes, on macOS ❌ No
MBS( "CUPS.PrintData"; Printer; Data { ; Title; Options } )   More

Parameters

Parameter Description Example Flags
Printer The name of the printer.
Please use CUPS printer name with underscore instead of spaces.
"Brother_DCP_8085DN"
Data The file data to print. You can include escapes with backslash. \n gives new line, \r gives return, \\ gives a backslash. \xx with a hex number gives that character. e.g. \41 gives an A. "Hello World\nJust a test!\n"
Title The title of the print job. "FileMaker Printout" Optional
Options List of options. Simply add key and values as string parameters to the function call. "key1"; "value1"; "key2"; "value2" Optional

Result

Returns job number.

Description

Print a file to a printer or class on the default server.
With \xx you can embed any character in the text.
\t gives a tab, \n a LF, \r a newline.

Examples

Print data:

MBS( "CUPS.PrintData"; "Brother_DCP_8085DN"; "Hello World\nJust a test!\n"; "FileMaker Printout" )

Print data with options:

MBS( "CUPS.PrintData"; "Brother_DCP_8085DN"; "Hello World\nJust a test!\n"; "FileMaker Printout";
// first option
"Scaling"; "75";
// second option
"media"; "A4" )

Build Data, send to printer and write a text file for debugging:

Set Variable [$data; Value:"#!A1#DC REM Drucker wird aktiviert¶" & "#IMSR103.87/25.00 REM Etikettenmasse¶" & "#PR5/5/ REM Druckgeschwindigkeit¶" & "#HV70 REM Druckhitze¶" & "#ER¶" & "¶" & "¶" & "¶" & "#T06.5 #J18.7 #YN101/1R/33///\\80#G¶" …]
Set Variable [$data; Value:MBS( "Text.ReplaceNewline"; $data; 3 )]
Set Variable [$r; Value:MBS( "Text.WriteTextFile"; $data; "/tmp/test.txt"; "Dos" )]
Set Variable [$r; Value:MBS( "CUPS.PrintData"; "LabelPrinter"; $data; "Label" )]

See also

Example Databases

Created 18th August 2014, last changed 2nd February 2021


CUPS.LastErrorMessage - CUPS.PrintDataEncoding

Feedback: Report problem or ask question.