3 * Miscellaneous multiprecision support functions
5 * (c) 1999 Straylight/Edgeware
8 /*----- Licensing notice --------------------------------------------------*
10 * This file is part of Catacomb.
12 * Catacomb is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU Library General Public License as
14 * published by the Free Software Foundation; either version 2 of the
15 * License, or (at your option) any later version.
17 * Catacomb is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU Library General Public License for more details.
22 * You should have received a copy of the GNU Library General Public
23 * License along with Catacomb; if not, write to the Free
24 * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
28 /*----- Header files ------------------------------------------------------*/
32 /*----- Basic manipulation ------------------------------------------------*/
34 /* --- @mp_shrink@ --- *
36 * Arguments: @mp *m@ = pointer to a multiprecision integer
40 * Use: Reduces the recorded length of an integer. This doesn't
41 * reduce the amount of memory used, although it can improve
42 * performance a bit. To reduce memory, use @mp_minimize@
43 * instead. This can't change the value of an integer, and is
44 * therefore safe to use even when there are multiple
48 void mp_shrink(mp
*m
) { MP_SHRINK(m
); }
50 /* --- @mp_minimize@ --- *
52 * Arguments: @mp *m@ = pointer to a multiprecision integer
56 * Use: Reduces the amount of memory an integer uses. It's best to
57 * do this to numbers which aren't going to change in the
61 void mp_minimize(mp
*m
)
64 MP_RESIZE(m
, MP_LEN(m
));
67 /*----- Bit scanning ------------------------------------------------------*/
69 /* --- @mp_scan@ --- *
71 * Arguments: @mpscan *sc@ = pointer to bitscanner block
72 * @const mp *m@ = pointer to a multiprecision integer
76 * Use: Initializes a bitscanner on a multiprecision integer.
79 void mp_scan(mpscan
*sc
, const mp
*m
) { MP_SCAN(sc
, m
); }
81 /* --- @mp_scan@ --- *
83 * Arguments: @mpscan *sc@ = pointer to bitscanner block
84 * @const mp *m@ = pointer to a multiprecision integer
88 * Use: Initializes a reverse bitscanner on a multiprecision
92 void mp_rscan(mpscan
*sc
, const mp
*m
) { MP_RSCAN(sc
, m
); }
94 /*----- That's all, folks -------------------------------------------------*/