1texprintf(1.1.0)                                              texprintf(1.1.0)
2
3
4

NAME

6       texprintf,  stexprintf,  ftexprintf,  texlistsymbols,  texboxtree - Ex‐
7       tended formatted output functions
8

SYNOPSIS

10       #include <texprintf.h>
11
12       int texprintf(const char *format, ...);
13       char * stexprintf(const char *format, ...);
14       int ftexprintf(const char *format, ...);
15       void texlistsymbols();
16       void texboxtree(const char *format, ...);
17       void texlistsymbols();
18       void texerrors();
19
20       In adition to the above functions <texprintf.h> defines  several  vari‐
21       ables:
22
23       int TEXPRINTF_LW;
24       char * TEXPRINTF_FONT;
25       int TEXPRINTF_ERR;
26

DESCRIPTION

28       The functions in the texprintf family provide formatted output like the
29       printf family of functions extended with a tex-like syntax.  The  func‐
30       tions  generate  UTF-8  encoded strings and assume that monospace fonts
31       are used (also for symbols, beware of non-monospace fallback fonts).
32
33       Please refer to the utftex man page for details on the tex-like  syntax
34       provided  by these functions. Refer to the man page of printf for a de‐
35       scription of the format.
36
37       Upon successful return the functions texprintf, and  ftexprintf  return
38       the  number  of characters printed (excluding the null byte used to end
39       output to strings). The stexprintf function returns an allocated string
40       containing the result.
41
42       With  the  integer TEXPRINTF_LW, the line width may be limited. Per de‐
43       fault the line width is not limited (TEXPRINTF_LW=0).  If  TEXPRINTF_LW
44       is set to a positive integer, the texprintf functions will try to limit
45       the line width to this number of characters, i.e., tt tries to break up
46       the  equation  over more than one line. To this end the texprinf engine
47       must find suitable places to break the equation.  As it is not  guaran‐
48       teed a suitable location is found, the line width is not guaranteed.
49
50       The  string TEXPRINTF_FONT can be used to specify the default font. The
51       available fonts are
52       mathsfbfit
53       mathsfbf
54       mathfrak
55       mathbfit
56       mathsfit
57       mathcal
58       mathscr
59       mathbf
60       mathbb
61       mathsf
62       mathtt
63       mathnormal
64       text (default)
65       The integer TEXPRINTF_ERR is an error flag. If its value  is  non  zero
66       after  a  call to any of the texprintf functions, an error has occurred
67       in parsing the input. A call to texerrors() will print the  correspond‐
68       ing error messages.  A call to texerrors() will print the related error
69       messages.
70       The function texlistsymbols() prints all symbols the  texprintf  system
71       knows.
72       The  texboxtree(const char *format, ...) is for debugginbg purposes. It
73       takes the same arguments as texprintf, however, its  output  is  a  de‐
74       scription of the resulting internal box datastructures.
75
76
77

SEE ALSO

79       printf(3), utftex(1)
80
81
82
83
84                                  05 Jul 2022                 texprintf(1.1.0)
Impressum