X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_print.3x.html;h=24c62d2e59cb75c553c939f56d033236214ecf75;hp=fc160e49d0e5dec5eddb447bac489632bc5e670e;hb=HEAD;hpb=a8987e73ec254703634802b4f7ee30d3a485524d diff --git a/doc/html/man/curs_print.3x.html b/doc/html/man/curs_print.3x.html index fc160e49..92fb48d4 100644 --- a/doc/html/man/curs_print.3x.html +++ b/doc/html/man/curs_print.3x.html @@ -1,7 +1,7 @@ - - +
-- -curs_print(3x) curs_print(3x) +curs_print(3x) Library calls curs_print(3x) --
- mcprint - ship binary data to printer +
+ mcprint - write binary data to printer using terminfo capabilities --
+
#include <curses.h> - int mcprint(char *data, int len); + int mcprint(char *data, int len); --
- This function uses the mc5p or mc4 and mc5 capabilities, - if they are present, to ship given data to a printer - attached to the terminal. +
+ This function uses the mc5p or mc4 and mc5 capabilities, if they are + present, to ship given data to a printer attached to the terminal. - Note that the mcprint code has no way to do flow control - with the printer or to know how much buffering it has. - Your application is responsible for keeping the rate of - writes to the printer below its continuous throughput rate - (typically about half of its nominal cps rating). Dot- - matrix printers and 6-page-per-minute lasers can typically - handle 80cps, so a good conservative rule of thumb is to - sleep for a second after shipping each 80-character line. + Note that the mcprint code has no way to do flow control with the + printer or to know how much buffering it has. Your application is + responsible for keeping the rate of writes to the printer below its + continuous throughput rate (typically about half of its nominal cps + rating). Dot-matrix printers and 6-page-per-minute lasers can + typically handle 80cps, so a good conservative rule of thumb is to + sleep for a second after shipping each 80-character line. +
+ The mcprint function returns ERR if the write operation aborted for + some reason. In this case, errno will contain either an error + associated with write(2) or one of the following: --
- The mcprint function returns ERR if the write operation - aborted for some reason. In this case, errno will contain - either an error associated with write(2) or one of the - following: + ENODEV + Capabilities for printer redirection do not exist. - ENODEV - Capabilities for printer redirection don't exist. + ENOMEM + Couldn't allocate sufficient memory to buffer the printer write. - ENOMEM - Couldn't allocate sufficient memory to buffer the - printer write. + When mcprint succeeds, it returns the number of characters actually + sent to the printer. - When mcprint succeeds, it returns the number of char- - acters actually sent to the printer. +
+ mcprint was designed for ncurses(3x), and was not found in SVr4 curses, + 4.4BSD curses, or any other previous curses implementation. --
- The mcprint call was designed for ncurses(3x), and is not - found in SVr4 curses, 4.4BSD curses, or any other previous - version of curses. +
+ Applications employing this ncurses extension should condition its use + on the visibility of the NCURSES_VERSION preprocessor macro. --
- Padding in the mc5p, mc4 and mc5 capabilities will not be - interpreted. +
+ Padding in the mc5p, mc4, and mc5 capabilities is not interpreted. --
+ +
curses(3x) - curs_print(3x) +ncurses 6.5 2024-03-16 curs_print(3x)-