3 * $Id: mptext.h,v 1.5 2000/10/08 12:04:58 mdw Exp $
5 * Textual representation of multiprecision numbers
7 * (c) 1999 Straylight/Edgeware
10 /*----- Licensing notice --------------------------------------------------*
12 * This file is part of Catacomb.
14 * Catacomb is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU Library General Public License as
16 * published by the Free Software Foundation; either version 2 of the
17 * License, or (at your option) any later version.
19 * Catacomb is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 * GNU Library General Public License for more details.
24 * You should have received a copy of the GNU Library General Public
25 * License along with Catacomb; if not, write to the Free
26 * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
30 /*----- Revision history --------------------------------------------------*
33 * Revision 1.5 2000/10/08 12:04:58 mdw
34 * (MP_DOFPRINTFR): cope with null pointers.
36 * Revision 1.4 2000/06/17 11:46:58 mdw
37 * Convenience macros for producing debugging output containing MP
40 * Revision 1.3 1999/12/22 15:56:30 mdw
41 * Make the buffer passed to `put' op constant.
43 * Revision 1.2 1999/12/10 23:29:48 mdw
44 * Change header file guard names.
46 * Revision 1.1 1999/11/17 18:02:16 mdw
47 * New multiprecision integer arithmetic suite.
51 #ifndef CATACOMB_MPTEXT_H
52 #define CATACOMB_MPTEXT_H
58 /*----- Header files ------------------------------------------------------*/
64 /*----- Data structures ---------------------------------------------------*/
66 typedef struct mptext_ops
{
67 int (*get
)(void */
*p*/
);
68 void (*unget
)(int /*ch*/, void */
*p*/
);
69 int (*put
)(const char */
*s*/
, size_t /*len*/, void */
*p*/
);
72 /*----- Functions provided ------------------------------------------------*/
74 /* --- @mp_read@ --- *
76 * Arguments: @mp *m@ = destination multiprecision number
77 * @int radix@ = base to assume for data (or zero to guess)
78 * @const mptext_ops *ops@ = pointer to operations block
79 * @void *p@ = data for the operations block
81 * Returns: The integer read, or zero if it didn't work.
83 * Use: Reads an integer from some source. If the @radix@ is
84 * specified, the number is assumed to be given in that radix,
85 * with the letters `a' (either upper- or lower-case) upwards
86 * standing for digits greater than 9. Otherwise, base 10 is
87 * assumed unless the number starts with `0' (octal), `0x' (hex)
88 * or `nnn_' (base `nnn'). An arbitrary amount of whitespace
89 * before the number is ignored.
92 extern mp
*mp_read(mp */
*m*/
, int /*radix*/,
93 const mptext_ops */
*ops*/
, void */
*p*/
);
95 /* --- @mp_write@ --- *
97 * Arguments: @mp *m@ = pointer to a multi-precision integer
98 * @int radix@ = radix to use when writing the number out
99 * @const mptext_ops *ops@ = pointer to an operations block
100 * @void *p@ = data for the operations block
102 * Returns: Zero if it worked, nonzero otherwise.
104 * Use: Writes a large integer in textual form.
107 extern int mp_write(mp */
*m*/
, int /*radix*/,
108 const mptext_ops */
*ops*/
, void */
*p*/
);
110 /*----- File I/O ----------------------------------------------------------*/
114 /* --- Operations table --- *
116 * The @mptext_fileops@ expect the pointer argument to be a @FILE *@.
119 extern const mptext_ops mptext_fileops
;
121 /* --- Convenience functions --- */
123 extern mp
*mp_readfile(mp */
*m*/
, FILE */
*fp*/
, int /*radix*/);
124 extern int mp_writefile(mp */
*m*/
, FILE */
*fp*/
, int /*radix*/);
126 #define MP_DOFPRINTFR(fp, args, m, r) do { \
129 mp_writefile(m, fp, r); \
131 fputs("<null>", fp); \
135 #define MP_DOFPRINTR(fp, name, m, r) \
136 MP_DOFPRINTFR(fp, (fp, "%s = ", name), m, r)
138 #define MP_PRINT(name, m) MP_DOFPRINTR(stdout, name, m, 10)
139 #define MP_EPRINT(name, m) MP_DOFPRINTR(stderr, name, m, 10)
140 #define MP_PRINTX(name, m) MP_DOFPRINTR(stdout, name, m, 16)
141 #define MP_EPRINTX(name, m) MP_DOFPRINTR(stderr, name, m, 16)
143 #define MP_FPRINTF(fp, args, m) MP_DOFPRINTFR(fp, args, m, 10)
144 #define MP_FPRINTFX(fp, args, m) MP_DOFPRINTFR(fp, args, m, 16)
146 /*----- String I/O --------------------------------------------------------*/
148 /* --- Context format --- */
150 typedef struct mptext_stringctx
{
155 /* --- Operations table --- */
157 extern const mptext_ops mptext_stringops
;
159 /* --- Convenience functions --- */
161 extern mp
*mp_readstring(mp */
*m*/
, const char */
*p*/
, char **/
*end*/
,
163 extern int mp_writestring(mp */
*m*/
, char */
*p*/
, size_t /*sz*/,
166 /*----- Dynamic string I/O ------------------------------------------------*/
168 #include <mLib/dstr.h>
170 /* --- Context format --- */
172 typedef struct mptext_dstrctx
{
177 /* --- Operations table --- */
179 extern const mptext_ops mptext_dstrops
;
181 /* --- Convenience functions --- */
183 extern mp
*mp_readdstr(mp */
*m*/
, dstr */
*d*/
, size_t */
*off*/
,
185 extern int mp_writedstr(mp */
*m*/
, dstr */
*d*/
, int /*radix*/);
187 /*----- That's all, folks -------------------------------------------------*/