Coverage Report

Created: 2026-05-16 06:52

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/gmp/mpz/export.c
Line
Count
Source
1
/* mpz_export -- create word data from mpz.
2
3
Copyright 2002, 2003, 2012 Free Software Foundation, Inc.
4
5
This file is part of the GNU MP Library.
6
7
The GNU MP Library is free software; you can redistribute it and/or modify
8
it under the terms of either:
9
10
  * the GNU Lesser General Public License as published by the Free
11
    Software Foundation; either version 3 of the License, or (at your
12
    option) any later version.
13
14
or
15
16
  * the GNU General Public License as published by the Free Software
17
    Foundation; either version 2 of the License, or (at your option) any
18
    later version.
19
20
or both in parallel, as here.
21
22
The GNU MP Library is distributed in the hope that it will be useful, but
23
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
24
or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
25
for more details.
26
27
You should have received copies of the GNU General Public License and the
28
GNU Lesser General Public License along with the GNU MP Library.  If not,
29
see https://www.gnu.org/licenses/.  */
30
31
#include <stdio.h>  /* for NULL */
32
#include "gmp-impl.h"
33
#include "longlong.h"
34
35
36
#if HAVE_LIMB_BIG_ENDIAN
37
#define HOST_ENDIAN     1
38
#endif
39
#if HAVE_LIMB_LITTLE_ENDIAN
40
1.43k
#define HOST_ENDIAN     (-1)
41
#endif
42
#ifndef HOST_ENDIAN
43
static const mp_limb_t  endian_test = (CNST_LIMB(1) << (GMP_LIMB_BITS-7)) - 1;
44
#define HOST_ENDIAN     (* (signed char *) &endian_test)
45
#endif
46
47
void *
48
mpz_export (void *data, size_t *countp, int order,
49
      size_t size, int endian, size_t nail, mpz_srcptr z)
50
1.47k
{
51
1.47k
  mp_size_t      zsize;
52
1.47k
  mp_srcptr      zp;
53
1.47k
  size_t         count, dummy;
54
1.47k
  unsigned long  numb;
55
1.47k
  unsigned       align;
56
57
1.47k
  ASSERT (order == 1 || order == -1);
58
1.47k
  ASSERT (endian == 1 || endian == 0 || endian == -1);
59
1.47k
  ASSERT (nail <= 8*size);
60
1.47k
  ASSERT (nail <  8*size || SIZ(z) == 0); /* nail < 8*size+(SIZ(z)==0) */
61
62
1.47k
  if (countp == NULL)
63
0
    countp = &dummy;
64
65
1.47k
  zsize = SIZ(z);
66
1.47k
  if (zsize == 0)
67
32
    {
68
32
      *countp = 0;
69
32
      return data;
70
32
    }
71
72
1.43k
  zsize = ABS (zsize);
73
1.43k
  zp = PTR(z);
74
1.43k
  numb = 8*size - nail;
75
1.43k
  MPN_SIZEINBASE_2EXP (count, zp, zsize, numb);
76
1.43k
  *countp = count;
77
78
1.43k
  if (data == NULL)
79
0
    data = (*__gmp_allocate_func) (count*size);
80
81
1.43k
  if (endian == 0)
82
1.43k
    endian = HOST_ENDIAN;
83
84
1.43k
  align = ((char *) data - (char *) NULL) % sizeof (mp_limb_t);
85
86
1.43k
  if (nail == GMP_NAIL_BITS)
87
1.43k
    {
88
1.43k
      if (size == sizeof (mp_limb_t) && align == 0)
89
0
  {
90
0
    if (order == -1 && endian == HOST_ENDIAN)
91
0
      {
92
0
        MPN_COPY ((mp_ptr) data, zp, (mp_size_t) count);
93
0
        return data;
94
0
      }
95
0
    if (order == 1 && endian == HOST_ENDIAN)
96
0
      {
97
0
        MPN_REVERSE ((mp_ptr) data, zp, (mp_size_t) count);
98
0
        return data;
99
0
      }
100
101
0
    if (order == -1 && endian == -HOST_ENDIAN)
102
0
      {
103
0
        MPN_BSWAP ((mp_ptr) data, zp, (mp_size_t) count);
104
0
        return data;
105
0
      }
106
0
    if (order == 1 && endian == -HOST_ENDIAN)
107
0
      {
108
0
        MPN_BSWAP_REVERSE ((mp_ptr) data, zp, (mp_size_t) count);
109
0
        return data;
110
0
      }
111
0
  }
112
1.43k
    }
113
114
1.43k
  {
115
1.43k
    mp_limb_t      limb, wbitsmask;
116
1.43k
    size_t         i, numb;
117
1.43k
    mp_size_t      j, wbytes, woffset;
118
1.43k
    unsigned char  *dp;
119
1.43k
    int            lbits, wbits;
120
1.43k
    mp_srcptr      zend;
121
122
1.43k
    numb = size * 8 - nail;
123
124
    /* whole bytes per word */
125
1.43k
    wbytes = numb / 8;
126
127
    /* possible partial byte */
128
1.43k
    wbits = numb % 8;
129
1.43k
    wbitsmask = (CNST_LIMB(1) << wbits) - 1;
130
131
    /* offset to get to the next word */
132
1.43k
    woffset = (endian >= 0 ? size : - (mp_size_t) size)
133
1.43k
      + (order < 0 ? size : - (mp_size_t) size);
134
135
    /* least significant byte */
136
1.43k
    dp = (unsigned char *) data
137
1.43k
      + (order >= 0 ? (count-1)*size : 0) + (endian >= 0 ? size-1 : 0);
138
139
1.43k
#define EXTRACT(N, MASK)                                \
140
43.7k
    do {                                                \
141
43.7k
      if (lbits >= (N))                                 \
142
43.7k
        {                                               \
143
38.1k
          *dp = limb MASK;                              \
144
38.1k
          limb >>= (N);                                 \
145
38.1k
          lbits -= (N);                                 \
146
38.1k
        }                                               \
147
43.7k
      else                                              \
148
43.7k
        {                                               \
149
5.59k
          mp_limb_t  newlimb;                           \
150
5.59k
          newlimb = (zp == zend ? 0 : *zp++);           \
151
5.59k
          *dp = (limb | (newlimb << lbits)) MASK;       \
152
5.59k
          limb = newlimb >> ((N)-lbits);                \
153
5.59k
          lbits += GMP_NUMB_BITS - (N);                 \
154
5.59k
        }                                               \
155
43.7k
    } while (0)
156
157
1.43k
    zend = zp + zsize;
158
1.43k
    lbits = 0;
159
1.43k
    limb = 0;
160
45.2k
    for (i = 0; i < count; i++)
161
43.7k
      {
162
87.5k
  for (j = 0; j < wbytes; j++)
163
43.7k
    {
164
43.7k
      EXTRACT (8, + 0);
165
43.7k
      dp -= endian;
166
43.7k
    }
167
43.7k
  if (wbits != 0)
168
0
    {
169
0
      EXTRACT (wbits, & wbitsmask);
170
0
      dp -= endian;
171
0
      j++;
172
0
    }
173
43.7k
  for ( ; j < size; j++)
174
0
    {
175
0
      *dp = '\0';
176
0
      dp -= endian;
177
0
    }
178
43.7k
  dp += woffset;
179
43.7k
      }
180
181
1.43k
    ASSERT (zp == PTR(z) + ABSIZ(z));
182
183
    /* low byte of word after most significant */
184
1.43k
    ASSERT (dp == (unsigned char *) data
185
1.43k
      + (order < 0 ? count*size : - (mp_size_t) size)
186
1.43k
      + (endian >= 0 ? (mp_size_t) size - 1 : 0));
187
1.43k
  }
188
1.43k
  return data;
189
1.43k
}