Home | History | Annotate | Line # | Download | only in generated
      1 /* Specific implementation of the PACK intrinsic
      2    Copyright (C) 2002-2024 Free Software Foundation, Inc.
      3    Contributed by Paul Brook <paul (at) nowt.org>
      4 
      5 This file is part of the GNU Fortran runtime library (libgfortran).
      6 
      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 3 of the License, or (at your option) any later version.
     11 
     12 Ligbfortran is distributed in the hope that it will be useful,
     13 but WITHOUT ANY WARRANTY; without even the implied warranty of
     14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     15 GNU General Public License for more details.
     16 
     17 Under Section 7 of GPL version 3, you are granted additional
     18 permissions described in the GCC Runtime Library Exception, version
     19 3.1, as published by the Free Software Foundation.
     20 
     21 You should have received a copy of the GNU General Public License and
     22 a copy of the GCC Runtime Library Exception along with this program;
     23 see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
     24 <http://www.gnu.org/licenses/>.  */
     25 
     26 #include "libgfortran.h"
     27 #include <string.h>
     28 
     29 
     30 #if defined (HAVE_GFC_COMPLEX_4)
     31 
     32 /* PACK is specified as follows:
     33 
     34    13.14.80 PACK (ARRAY, MASK, [VECTOR])
     35 
     36    Description: Pack an array into an array of rank one under the
     37    control of a mask.
     38 
     39    Class: Transformational function.
     40 
     41    Arguments:
     42       ARRAY   may be of any type. It shall not be scalar.
     43       MASK    shall be of type LOGICAL. It shall be conformable with ARRAY.
     44       VECTOR  (optional) shall be of the same type and type parameters
     45               as ARRAY. VECTOR shall have at least as many elements as
     46               there are true elements in MASK. If MASK is a scalar
     47               with the value true, VECTOR shall have at least as many
     48               elements as there are in ARRAY.
     49 
     50    Result Characteristics: The result is an array of rank one with the
     51    same type and type parameters as ARRAY. If VECTOR is present, the
     52    result size is that of VECTOR; otherwise, the result size is the
     53    number /t/ of true elements in MASK unless MASK is scalar with the
     54    value true, in which case the result size is the size of ARRAY.
     55 
     56    Result Value: Element /i/ of the result is the element of ARRAY
     57    that corresponds to the /i/th true element of MASK, taking elements
     58    in array element order, for /i/ = 1, 2, ..., /t/. If VECTOR is
     59    present and has size /n/ > /t/, element /i/ of the result has the
     60    value VECTOR(/i/), for /i/ = /t/ + 1, ..., /n/.
     61 
     62    Examples: The nonzero elements of an array M with the value
     63    | 0 0 0 |
     64    | 9 0 0 | may be "gathered" by the function PACK. The result of
     65    | 0 0 7 |
     66    PACK (M, MASK = M.NE.0) is [9,7] and the result of PACK (M, M.NE.0,
     67    VECTOR = (/ 2,4,6,8,10,12 /)) is [9,7,6,8,10,12].
     68 
     69 There are two variants of the PACK intrinsic: one, where MASK is
     70 array valued, and the other one where MASK is scalar.  */
     71 
     72 void
     73 pack_c4 (gfc_array_c4 *ret, const gfc_array_c4 *array,
     74 	       const gfc_array_l1 *mask, const gfc_array_c4 *vector)
     75 {
     76   /* r.* indicates the return array.  */
     77   index_type rstride0;
     78   GFC_COMPLEX_4 * restrict rptr;
     79   /* s.* indicates the source array.  */
     80   index_type sstride[GFC_MAX_DIMENSIONS];
     81   index_type sstride0;
     82   const GFC_COMPLEX_4 *sptr;
     83   /* m.* indicates the mask array.  */
     84   index_type mstride[GFC_MAX_DIMENSIONS];
     85   index_type mstride0;
     86   const GFC_LOGICAL_1 *mptr;
     87 
     88   index_type count[GFC_MAX_DIMENSIONS];
     89   index_type extent[GFC_MAX_DIMENSIONS];
     90   int zero_sized;
     91   index_type n;
     92   index_type dim;
     93   index_type nelem;
     94   index_type total;
     95   int mask_kind;
     96 
     97   dim = GFC_DESCRIPTOR_RANK (array);
     98 
     99   sstride[0] = 0; /* Avoid warnings if not initialized.  */
    100   mstride[0] = 0;
    101 
    102   mptr = mask->base_addr;
    103 
    104   /* Use the same loop for all logical types, by using GFC_LOGICAL_1
    105      and using shifting to address size and endian issues.  */
    106 
    107   mask_kind = GFC_DESCRIPTOR_SIZE (mask);
    108 
    109   if (mask_kind == 1 || mask_kind == 2 || mask_kind == 4 || mask_kind == 8
    110 #ifdef HAVE_GFC_LOGICAL_16
    111       || mask_kind == 16
    112 #endif
    113       )
    114     {
    115       /*  Do not convert a NULL pointer as we use test for NULL below.  */
    116       if (mptr)
    117 	mptr = GFOR_POINTER_TO_L1 (mptr, mask_kind);
    118     }
    119   else
    120     runtime_error ("Funny sized logical array");
    121 
    122   zero_sized = 0;
    123   for (n = 0; n < dim; n++)
    124     {
    125       count[n] = 0;
    126       extent[n] = GFC_DESCRIPTOR_EXTENT(array,n);
    127       if (extent[n] <= 0)
    128        zero_sized = 1;
    129       sstride[n] = GFC_DESCRIPTOR_STRIDE(array,n);
    130       mstride[n] = GFC_DESCRIPTOR_STRIDE_BYTES(mask,n);
    131     }
    132   if (sstride[0] == 0)
    133     sstride[0] = 1;
    134   if (mstride[0] == 0)
    135     mstride[0] = mask_kind;
    136 
    137   if (zero_sized)
    138     sptr = NULL;
    139   else
    140     sptr = array->base_addr;
    141 
    142   if (ret->base_addr == NULL || unlikely (compile_options.bounds_check))
    143     {
    144       /* Count the elements, either for allocating memory or
    145 	 for bounds checking.  */
    146 
    147       if (vector != NULL)
    148 	{
    149 	  /* The return array will have as many
    150 	     elements as there are in VECTOR.  */
    151 	  total = GFC_DESCRIPTOR_EXTENT(vector,0);
    152 	  if (total < 0)
    153 	    {
    154 	      total = 0;
    155 	      vector = NULL;
    156 	    }
    157 	}
    158       else
    159         {
    160       	  /* We have to count the true elements in MASK.  */
    161 	  total = count_0 (mask);
    162         }
    163 
    164       if (ret->base_addr == NULL)
    165 	{
    166 	  /* Setup the array descriptor.  */
    167 	  GFC_DIMENSION_SET(ret->dim[0], 0, total-1, 1);
    168 
    169 	  ret->offset = 0;
    170 
    171 	  /* xmallocarray allocates a single byte for zero size.  */
    172 	  ret->base_addr = xmallocarray (total, sizeof (GFC_COMPLEX_4));
    173 
    174 	  if (total == 0)
    175 	    return;
    176 	}
    177       else
    178 	{
    179 	  /* We come here because of range checking.  */
    180 	  index_type ret_extent;
    181 
    182 	  ret_extent = GFC_DESCRIPTOR_EXTENT(ret,0);
    183 	  if (total != ret_extent)
    184 	    runtime_error ("Incorrect extent in return value of PACK intrinsic;"
    185 			   " is %ld, should be %ld", (long int) total,
    186 			   (long int) ret_extent);
    187 	}
    188     }
    189 
    190   rstride0 = GFC_DESCRIPTOR_STRIDE(ret,0);
    191   if (rstride0 == 0)
    192     rstride0 = 1;
    193   sstride0 = sstride[0];
    194   mstride0 = mstride[0];
    195   rptr = ret->base_addr;
    196 
    197   while (sptr && mptr)
    198     {
    199       /* Test this element.  */
    200       if (*mptr)
    201         {
    202           /* Add it.  */
    203 	  *rptr = *sptr;
    204           rptr += rstride0;
    205         }
    206       /* Advance to the next element.  */
    207       sptr += sstride0;
    208       mptr += mstride0;
    209       count[0]++;
    210       n = 0;
    211       while (count[n] == extent[n])
    212         {
    213           /* When we get to the end of a dimension, reset it and increment
    214              the next dimension.  */
    215           count[n] = 0;
    216           /* We could precalculate these products, but this is a less
    217              frequently used path so probably not worth it.  */
    218           sptr -= sstride[n] * extent[n];
    219           mptr -= mstride[n] * extent[n];
    220           n++;
    221           if (n >= dim)
    222             {
    223               /* Break out of the loop.  */
    224               sptr = NULL;
    225               break;
    226             }
    227           else
    228             {
    229               count[n]++;
    230               sptr += sstride[n];
    231               mptr += mstride[n];
    232             }
    233         }
    234     }
    235 
    236   /* Add any remaining elements from VECTOR.  */
    237   if (vector)
    238     {
    239       n = GFC_DESCRIPTOR_EXTENT(vector,0);
    240       nelem = ((rptr - ret->base_addr) / rstride0);
    241       if (n > nelem)
    242         {
    243           sstride0 = GFC_DESCRIPTOR_STRIDE(vector,0);
    244           if (sstride0 == 0)
    245             sstride0 = 1;
    246 
    247           sptr = vector->base_addr + sstride0 * nelem;
    248           n -= nelem;
    249           while (n--)
    250             {
    251 	      *rptr = *sptr;
    252               rptr += rstride0;
    253               sptr += sstride0;
    254             }
    255         }
    256     }
    257 }
    258 
    259 #endif
    260 
    261