Coverage Report

Created: 2026-02-14 06:49

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.71k
#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.73k
{
51
1.73k
  mp_size_t      zsize;
52
1.73k
  mp_srcptr      zp;
53
1.73k
  size_t         count, dummy;
54
1.73k
  unsigned long  numb;
55
1.73k
  unsigned       align;
56
57
1.73k
  ASSERT (order == 1 || order == -1);
58
1.73k
  ASSERT (endian == 1 || endian == 0 || endian == -1);
59
1.73k
  ASSERT (nail <= 8*size);
60
1.73k
  ASSERT (nail <  8*size || SIZ(z) == 0); /* nail < 8*size+(SIZ(z)==0) */
61
62
1.73k
  if (countp == NULL)
63
0
    countp = &dummy;
64
65
1.73k
  zsize = SIZ(z);
66
1.73k
  if (zsize == 0)
67
23
    {
68
23
      *countp = 0;
69
23
      return data;
70
23
    }
71
72
1.71k
  zsize = ABS (zsize);
73
1.71k
  zp = PTR(z);
74
1.71k
  numb = 8*size - nail;
75
1.71k
  MPN_SIZEINBASE_2EXP (count, zp, zsize, numb);
76
1.71k
  *countp = count;
77
78
1.71k
  if (data == NULL)
79
0
    data = (*__gmp_allocate_func) (count*size);
80
81
1.71k
  if (endian == 0)
82
1.71k
    endian = HOST_ENDIAN;
83
84
1.71k
  align = ((char *) data - (char *) NULL) % sizeof (mp_limb_t);
85
86
1.71k
  if (nail == GMP_NAIL_BITS)
87
1.71k
    {
88
1.71k
      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.71k
    }
113
114
1.71k
  {
115
1.71k
    mp_limb_t      limb, wbitsmask;
116
1.71k
    size_t         i, numb;
117
1.71k
    mp_size_t      j, wbytes, woffset;
118
1.71k
    unsigned char  *dp;
119
1.71k
    int            lbits, wbits;
120
1.71k
    mp_srcptr      zend;
121
122
1.71k
    numb = size * 8 - nail;
123
124
    /* whole bytes per word */
125
1.71k
    wbytes = numb / 8;
126
127
    /* possible partial byte */
128
1.71k
    wbits = numb % 8;
129
1.71k
    wbitsmask = (CNST_LIMB(1) << wbits) - 1;
130
131
    /* offset to get to the next word */
132
1.71k
    woffset = (endian >= 0 ? size : - (mp_size_t) size)
133
1.71k
      + (order < 0 ? size : - (mp_size_t) size);
134
135
    /* least significant byte */
136
1.71k
    dp = (unsigned char *) data
137
1.71k
      + (order >= 0 ? (count-1)*size : 0) + (endian >= 0 ? size-1 : 0);
138
139
1.71k
#define EXTRACT(N, MASK)                                \
140
51.8k
    do {                                                \
141
51.8k
      if (lbits >= (N))                                 \
142
51.8k
        {                                               \
143
45.2k
          *dp = limb MASK;                              \
144
45.2k
          limb >>= (N);                                 \
145
45.2k
          lbits -= (N);                                 \
146
45.2k
        }                                               \
147
51.8k
      else                                              \
148
51.8k
        {                                               \
149
6.65k
          mp_limb_t  newlimb;                           \
150
6.65k
          newlimb = (zp == zend ? 0 : *zp++);           \
151
6.65k
          *dp = (limb | (newlimb << lbits)) MASK;       \
152
6.65k
          limb = newlimb >> ((N)-lbits);                \
153
6.65k
          lbits += GMP_NUMB_BITS - (N);                 \
154
6.65k
        }                                               \
155
51.8k
    } while (0)
156
157
1.71k
    zend = zp + zsize;
158
1.71k
    lbits = 0;
159
1.71k
    limb = 0;
160
53.5k
    for (i = 0; i < count; i++)
161
51.8k
      {
162
103k
  for (j = 0; j < wbytes; j++)
163
51.8k
    {
164
51.8k
      EXTRACT (8, + 0);
165
51.8k
      dp -= endian;
166
51.8k
    }
167
51.8k
  if (wbits != 0)
168
0
    {
169
0
      EXTRACT (wbits, & wbitsmask);
170
0
      dp -= endian;
171
0
      j++;
172
0
    }
173
51.8k
  for ( ; j < size; j++)
174
0
    {
175
0
      *dp = '\0';
176
0
      dp -= endian;
177
0
    }
178
51.8k
  dp += woffset;
179
51.8k
      }
180
181
1.71k
    ASSERT (zp == PTR(z) + ABSIZ(z));
182
183
    /* low byte of word after most significant */
184
1.71k
    ASSERT (dp == (unsigned char *) data
185
1.71k
      + (order < 0 ? count*size : - (mp_size_t) size)
186
1.71k
      + (endian >= 0 ? (mp_size_t) size - 1 : 0));
187
1.71k
  }
188
1.71k
  return data;
189
1.71k
}