Merge -r 127928:132243 from trunk
[official-gcc.git] / libgfortran / intrinsics / pack_generic.c
blob61b41e53e65feae0fc84f938310290812163d521
1 /* Generic implementation of the PACK intrinsic
2 Copyright (C) 2002, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
3 Contributed by Paul Brook <paul@nowt.org>
5 This file is part of the GNU Fortran 95 runtime library (libgfortran).
7 Libgfortran is free software; you can redistribute it and/or
8 modify it under the terms of the GNU General Public
9 License as published by the Free Software Foundation; either
10 version 2 of the License, or (at your option) any later version.
12 In addition to the permissions in the GNU General Public License, the
13 Free Software Foundation gives you unlimited permission to link the
14 compiled version of this file into combinations with other programs,
15 and to distribute those combinations without any restriction coming
16 from the use of this file. (The General Public License restrictions
17 do apply in other respects; for example, they cover modification of
18 the file, and distribution when not linked into a combine
19 executable.)
21 Ligbfortran is distributed in the hope that it will be useful,
22 but WITHOUT ANY WARRANTY; without even the implied warranty of
23 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
24 GNU General Public License for more details.
26 You should have received a copy of the GNU General Public
27 License along with libgfortran; see the file COPYING. If not,
28 write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
29 Boston, MA 02110-1301, USA. */
31 #include "libgfortran.h"
32 #include <stdlib.h>
33 #include <assert.h>
34 #include <string.h>
36 /* PACK is specified as follows:
38 13.14.80 PACK (ARRAY, MASK, [VECTOR])
40 Description: Pack an array into an array of rank one under the
41 control of a mask.
43 Class: Transformational function.
45 Arguments:
46 ARRAY may be of any type. It shall not be scalar.
47 MASK shall be of type LOGICAL. It shall be conformable with ARRAY.
48 VECTOR (optional) shall be of the same type and type parameters
49 as ARRAY. VECTOR shall have at least as many elements as
50 there are true elements in MASK. If MASK is a scalar
51 with the value true, VECTOR shall have at least as many
52 elements as there are in ARRAY.
54 Result Characteristics: The result is an array of rank one with the
55 same type and type parameters as ARRAY. If VECTOR is present, the
56 result size is that of VECTOR; otherwise, the result size is the
57 number /t/ of true elements in MASK unless MASK is scalar with the
58 value true, in which case the result size is the size of ARRAY.
60 Result Value: Element /i/ of the result is the element of ARRAY
61 that corresponds to the /i/th true element of MASK, taking elements
62 in array element order, for /i/ = 1, 2, ..., /t/. If VECTOR is
63 present and has size /n/ > /t/, element /i/ of the result has the
64 value VECTOR(/i/), for /i/ = /t/ + 1, ..., /n/.
66 Examples: The nonzero elements of an array M with the value
67 | 0 0 0 |
68 | 9 0 0 | may be "gathered" by the function PACK. The result of
69 | 0 0 7 |
70 PACK (M, MASK = M.NE.0) is [9,7] and the result of PACK (M, M.NE.0,
71 VECTOR = (/ 2,4,6,8,10,12 /)) is [9,7,6,8,10,12].
73 There are two variants of the PACK intrinsic: one, where MASK is
74 array valued, and the other one where MASK is scalar. */
76 static void
77 pack_internal (gfc_array_char *ret, const gfc_array_char *array,
78 const gfc_array_l1 *mask, const gfc_array_char *vector,
79 index_type size)
81 /* r.* indicates the return array. */
82 index_type rstride0;
83 char *rptr;
84 /* s.* indicates the source array. */
85 index_type sstride[GFC_MAX_DIMENSIONS];
86 index_type sstride0;
87 const char *sptr;
88 /* m.* indicates the mask array. */
89 index_type mstride[GFC_MAX_DIMENSIONS];
90 index_type mstride0;
91 const GFC_LOGICAL_1 *mptr;
93 index_type count[GFC_MAX_DIMENSIONS];
94 index_type extent[GFC_MAX_DIMENSIONS];
95 int zero_sized;
96 index_type n;
97 index_type dim;
98 index_type nelem;
99 index_type total;
100 int mask_kind;
102 dim = GFC_DESCRIPTOR_RANK (array);
104 sptr = array->data;
105 mptr = mask->data;
107 /* Use the same loop for all logical types, by using GFC_LOGICAL_1
108 and using shifting to address size and endian issues. */
110 mask_kind = GFC_DESCRIPTOR_SIZE (mask);
112 if (mask_kind == 1 || mask_kind == 2 || mask_kind == 4 || mask_kind == 8
113 #ifdef HAVE_GFC_LOGICAL_16
114 || mask_kind == 16
115 #endif
118 /* Don't convert a NULL pointer as we use test for NULL below. */
119 if (mptr)
120 mptr = GFOR_POINTER_TO_L1 (mptr, mask_kind);
122 else
123 runtime_error ("Funny sized logical array");
125 zero_sized = 0;
126 for (n = 0; n < dim; n++)
128 count[n] = 0;
129 extent[n] = array->dim[n].ubound + 1 - array->dim[n].lbound;
130 if (extent[n] <= 0)
131 zero_sized = 1;
132 sstride[n] = array->dim[n].stride * size;
133 mstride[n] = mask->dim[n].stride * mask_kind;
135 if (sstride[0] == 0)
136 sstride[0] = size;
137 if (mstride[0] == 0)
138 mstride[0] = mask_kind;
140 if (ret->data == NULL || compile_options.bounds_check)
142 /* Count the elements, either for allocating memory or
143 for bounds checking. */
145 if (vector != NULL)
147 /* The return array will have as many
148 elements as there are in VECTOR. */
149 total = vector->dim[0].ubound + 1 - vector->dim[0].lbound;
151 else
153 /* We have to count the true elements in MASK. */
155 /* TODO: We could speed up pack easily in the case of only
156 few .TRUE. entries in MASK, by keeping track of where we
157 would be in the source array during the initial traversal
158 of MASK, and caching the pointers to those elements. Then,
159 supposed the number of elements is small enough, we would
160 only have to traverse the list, and copy those elements
161 into the result array. In the case of datatypes which fit
162 in one of the integer types we could also cache the
163 value instead of a pointer to it.
164 This approach might be bad from the point of view of
165 cache behavior in the case where our cache is not big
166 enough to hold all elements that have to be copied. */
168 const GFC_LOGICAL_1 *m = mptr;
170 total = 0;
171 if (zero_sized)
172 m = NULL;
174 while (m)
176 /* Test this element. */
177 if (*m)
178 total++;
180 /* Advance to the next element. */
181 m += mstride[0];
182 count[0]++;
183 n = 0;
184 while (count[n] == extent[n])
186 /* When we get to the end of a dimension, reset it
187 and increment the next dimension. */
188 count[n] = 0;
189 /* We could precalculate this product, but this is a
190 less frequently used path so probably not worth
191 it. */
192 m -= mstride[n] * extent[n];
193 n++;
194 if (n >= dim)
196 /* Break out of the loop. */
197 m = NULL;
198 break;
200 else
202 count[n]++;
203 m += mstride[n];
209 if (ret->data == NULL)
211 /* Setup the array descriptor. */
212 ret->dim[0].lbound = 0;
213 ret->dim[0].ubound = total - 1;
214 ret->dim[0].stride = 1;
216 ret->offset = 0;
217 if (total == 0)
219 /* In this case, nothing remains to be done. */
220 ret->data = internal_malloc_size (1);
221 return;
223 else
224 ret->data = internal_malloc_size (size * total);
226 else
228 /* We come here because of range checking. */
229 index_type ret_extent;
231 ret_extent = ret->dim[0].ubound + 1 - ret->dim[0].lbound;
232 if (total != ret_extent)
233 runtime_error ("Incorrect extent in return value of PACK intrinsic;"
234 " is %ld, should be %ld", (long int) total,
235 (long int) ret_extent);
239 rstride0 = ret->dim[0].stride * size;
240 if (rstride0 == 0)
241 rstride0 = size;
242 sstride0 = sstride[0];
243 mstride0 = mstride[0];
244 rptr = ret->data;
246 while (sptr && mptr)
248 /* Test this element. */
249 if (*mptr)
251 /* Add it. */
252 memcpy (rptr, sptr, size);
253 rptr += rstride0;
255 /* Advance to the next element. */
256 sptr += sstride0;
257 mptr += mstride0;
258 count[0]++;
259 n = 0;
260 while (count[n] == extent[n])
262 /* When we get to the end of a dimension, reset it and increment
263 the next dimension. */
264 count[n] = 0;
265 /* We could precalculate these products, but this is a less
266 frequently used path so probably not worth it. */
267 sptr -= sstride[n] * extent[n];
268 mptr -= mstride[n] * extent[n];
269 n++;
270 if (n >= dim)
272 /* Break out of the loop. */
273 sptr = NULL;
274 break;
276 else
278 count[n]++;
279 sptr += sstride[n];
280 mptr += mstride[n];
285 /* Add any remaining elements from VECTOR. */
286 if (vector)
288 n = vector->dim[0].ubound + 1 - vector->dim[0].lbound;
289 nelem = ((rptr - ret->data) / rstride0);
290 if (n > nelem)
292 sstride0 = vector->dim[0].stride * size;
293 if (sstride0 == 0)
294 sstride0 = size;
296 sptr = vector->data + sstride0 * nelem;
297 n -= nelem;
298 while (n--)
300 memcpy (rptr, sptr, size);
301 rptr += rstride0;
302 sptr += sstride0;
308 extern void pack (gfc_array_char *, const gfc_array_char *,
309 const gfc_array_l1 *, const gfc_array_char *);
310 export_proto(pack);
312 void
313 pack (gfc_array_char *ret, const gfc_array_char *array,
314 const gfc_array_l1 *mask, const gfc_array_char *vector)
316 pack_internal (ret, array, mask, vector, GFC_DESCRIPTOR_SIZE (array));
319 extern void pack_char (gfc_array_char *, GFC_INTEGER_4, const gfc_array_char *,
320 const gfc_array_l1 *, const gfc_array_char *,
321 GFC_INTEGER_4, GFC_INTEGER_4);
322 export_proto(pack_char);
324 void
325 pack_char (gfc_array_char *ret,
326 GFC_INTEGER_4 ret_length __attribute__((unused)),
327 const gfc_array_char *array, const gfc_array_l1 *mask,
328 const gfc_array_char *vector, GFC_INTEGER_4 array_length,
329 GFC_INTEGER_4 vector_length __attribute__((unused)))
331 pack_internal (ret, array, mask, vector, array_length);
334 static void
335 pack_s_internal (gfc_array_char *ret, const gfc_array_char *array,
336 const GFC_LOGICAL_4 *mask, const gfc_array_char *vector,
337 index_type size)
339 /* r.* indicates the return array. */
340 index_type rstride0;
341 char *rptr;
342 /* s.* indicates the source array. */
343 index_type sstride[GFC_MAX_DIMENSIONS];
344 index_type sstride0;
345 const char *sptr;
347 index_type count[GFC_MAX_DIMENSIONS];
348 index_type extent[GFC_MAX_DIMENSIONS];
349 index_type n;
350 index_type dim;
351 index_type ssize;
352 index_type nelem;
354 dim = GFC_DESCRIPTOR_RANK (array);
355 ssize = 1;
356 for (n = 0; n < dim; n++)
358 count[n] = 0;
359 extent[n] = array->dim[n].ubound + 1 - array->dim[n].lbound;
360 sstride[n] = array->dim[n].stride * size;
361 ssize *= extent[n];
363 if (sstride[0] == 0)
364 sstride[0] = size;
366 sstride0 = sstride[0];
367 sptr = array->data;
369 if (ret->data == NULL)
371 /* Allocate the memory for the result. */
372 int total;
374 if (vector != NULL)
376 /* The return array will have as many elements as there are
377 in vector. */
378 total = vector->dim[0].ubound + 1 - vector->dim[0].lbound;
380 else
382 if (*mask)
384 /* The result array will have as many elements as the input
385 array. */
386 total = extent[0];
387 for (n = 1; n < dim; n++)
388 total *= extent[n];
390 else
391 /* The result array will be empty. */
392 total = 0;
395 /* Setup the array descriptor. */
396 ret->dim[0].lbound = 0;
397 ret->dim[0].ubound = total - 1;
398 ret->dim[0].stride = 1;
399 ret->offset = 0;
401 if (total == 0)
403 ret->data = internal_malloc_size (1);
404 return;
406 else
407 ret->data = internal_malloc_size (size * total);
410 rstride0 = ret->dim[0].stride * size;
411 if (rstride0 == 0)
412 rstride0 = size;
413 rptr = ret->data;
415 /* The remaining possibilities are now:
416 If MASK is .TRUE., we have to copy the source array into the
417 result array. We then have to fill it up with elements from VECTOR.
418 If MASK is .FALSE., we have to copy VECTOR into the result
419 array. If VECTOR were not present we would have already returned. */
421 if (*mask && ssize != 0)
423 while (sptr)
425 /* Add this element. */
426 memcpy (rptr, sptr, size);
427 rptr += rstride0;
429 /* Advance to the next element. */
430 sptr += sstride0;
431 count[0]++;
432 n = 0;
433 while (count[n] == extent[n])
435 /* When we get to the end of a dimension, reset it and
436 increment the next dimension. */
437 count[n] = 0;
438 /* We could precalculate these products, but this is a
439 less frequently used path so probably not worth it. */
440 sptr -= sstride[n] * extent[n];
441 n++;
442 if (n >= dim)
444 /* Break out of the loop. */
445 sptr = NULL;
446 break;
448 else
450 count[n]++;
451 sptr += sstride[n];
457 /* Add any remaining elements from VECTOR. */
458 if (vector)
460 n = vector->dim[0].ubound + 1 - vector->dim[0].lbound;
461 nelem = ((rptr - ret->data) / rstride0);
462 if (n > nelem)
464 sstride0 = vector->dim[0].stride * size;
465 if (sstride0 == 0)
466 sstride0 = size;
468 sptr = vector->data + sstride0 * nelem;
469 n -= nelem;
470 while (n--)
472 memcpy (rptr, sptr, size);
473 rptr += rstride0;
474 sptr += sstride0;
480 extern void pack_s (gfc_array_char *ret, const gfc_array_char *array,
481 const GFC_LOGICAL_4 *, const gfc_array_char *);
482 export_proto(pack_s);
484 void
485 pack_s (gfc_array_char *ret, const gfc_array_char *array,
486 const GFC_LOGICAL_4 *mask, const gfc_array_char *vector)
488 pack_s_internal (ret, array, mask, vector, GFC_DESCRIPTOR_SIZE (array));
491 extern void pack_s_char (gfc_array_char *ret, GFC_INTEGER_4,
492 const gfc_array_char *array, const GFC_LOGICAL_4 *,
493 const gfc_array_char *, GFC_INTEGER_4,
494 GFC_INTEGER_4);
495 export_proto(pack_s_char);
497 void
498 pack_s_char (gfc_array_char *ret,
499 GFC_INTEGER_4 ret_length __attribute__((unused)),
500 const gfc_array_char *array, const GFC_LOGICAL_4 *mask,
501 const gfc_array_char *vector, GFC_INTEGER_4 array_length,
502 GFC_INTEGER_4 vector_length __attribute__((unused)))
504 pack_s_internal (ret, array, mask, vector, array_length);