RWalib C Array Library User Guide > Array Indexing > alibPutRangeS
  

alibPutRangeS
Replaces values in a contiguous subarray with a scalar. To replace the values with variable values, see alibPutRange. The PV-WAVE API for this routine is array indexing that uses any combination of scalars and range operators.
Prototypes
void alibPutRangeSb( wvlong n, wvlong *d, wvlong *b, wvlong *e, UCHAR *p, UCHAR q )
void alibPutRangeSs( wvlong n, wvlong *d, wvlong *b, wvlong *e, short *p, short q )
void alibPutRangeSi( wvlong n, wvlong *d, wvlong *b, wvlong *e, int *p, int q )
void alibPutRangeSl( wvlong n, wvlong *d, wvlong *b, wvlong *e, wvlong *p, wvlong q )
void alibPutRangeSf( wvlong n, wvlong *d, wvlong *b, wvlong *e, float *p, float q )
void alibPutRangeSd( wvlong n, wvlong *d, wvlong *b, wvlong *e, double *p, double q )
void alibPutRangeSc( wvlong n, wvlong *d, wvlong *b, wvlong *e, COMPLEX *p, COMPLEX q )
void alibPutRangeSz( wvlong n, wvlong *d, wvlong *b, wvlong *e, DCOMPLEX *p, DCOMPLEX q )
Parameters
n — (Input) The number of dimensions in the array containing the subarray to be replaced.
*d — (Input) The n-element array of dimensions for the array containing the subarray to be replaced.
*b — (Input) The n-element array of beginning subscripts defining the "lower-left" corner of the subarray to be replaced.
*e — (Input) The n-element array of ending subscripts defining the "upper-right" corner of the subarray to be replaced. Note that subarrays of dimensionality less than n are prescribed if b[i] = e[i] for some i.
*p — (Input/Output) The array containing the subarray to be replaced. On output, the subarray defined by corners b and e has been replaced.
q — (Input) The scalar value which replaces each value in the subarray.
Example
#include <stdio.h>
#include <stdlib.h>
#include <math.h>
#include "alib.h"
void main() {
   /* array of dimensions to use for one-dimensional, two-dimensional, three-dimensional, and four-dimensional 
      examples */
   wvlong dims[4] = {2,3,4,5};
   /* array of beginning subscripts to use for one-dimensional, two-dimensional, three-dimensional, 
      four-dimensional examples */
   wvlong begs[4] = {0,1,1,1};
   /* array of ending subscripts to use for one-dimensional, two-dimensional, three-dimensional, four-dimensional
      examples */
   wvlong ends[4] = {1,2,2,3};
   /* allocate array big enough for one-dimensional, two-dimensional, three-dimensional, and four-dimensional 
      examples */
   UCHAR    *b;
   b = (UCHAR*)malloc(120*sizeof(UCHAR));
   printf( "\n\n initialize and print one-dimensional array b" );
      alibinit( NULL, NULL, NULL, NULL );
      alibRepb( 5, 0, b );
      alibPrintArrayb( 1, 1, 1, 5, b, NULL );
   printf( "\n\n replace each value in b's interior with a 1" );
      alibPutRangeSb( 1, &dims[3], &begs[3], &ends[3], b, 1 );
      alibPrintArrayb( 1, 1, 1, 5, b, NULL );
   printf( "\n\n initalize and print two-dimensional array b" );
      alibRepb( 20, 0, b );
      alibPrintArrayb( 1, 1, 4, 5, b, NULL );
   printf( "\n\n replace each value in b's interior with a 1" );
      alibPutRangeSb( 2, &dims[2], &begs[2], &ends[2], b, 1 );
      alibPrintArrayb( 1, 1, 4, 5, b, NULL );
   printf( "\n\n initialize and print three-dimensional array b" );
      alibRepb( 60, 0, b );
      alibPrintArrayb( 1, 3, 4, 5, b, NULL );
   printf( "\n\n replace each value in the interior of each of the last\n");
   printf( " two two-dimensional slices through b's leading dimension with a 1" );
      alibPutRangeSb( 3, &dims[1], &begs[1], &ends[1], b, 1 );
      alibPrintArrayb( 1, 3, 4, 5, b, NULL );
   printf( "\n\n initialize and print four-dimensional array b" );
      alibRepb( 120, 0, b );
      alibPrintArrayb( 2, 3, 4, 5, b, NULL );
   printf( "\n\n repeat the three-dimensional example on each \n" );
   printf( " three-dimensional slice of b's leading dimension" );
      alibPutRangeSb( 4, dims, begs, ends, b, 1 );
      alibPrintArrayb( 2, 3, 4, 5, b, NULL );
}
 
Output:
 
 initialize and print one-dimensional array b
 
   0   0   0   0   0
 
 replace each value in b's interior with a 1
 
   0   1   1   1   0
 
 initalize and print two-dimensional array b
 
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
 
 replace each value in b's interior with a 1
 
   0   0   0   0   0
   0   1   1   1   0
   0   1   1   1   0
   0   0   0   0   0
 
 initialize and print three-dimensional array b
 
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
 
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
 
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
 
 replace each value in the interior of each of the last
 two two-dimensional slices through b's leading dimension with a 1
 
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
 
   0   0   0   0   0
   0   1   1   1   0
   0   1   1   1   0
   0   0   0   0   0
 
   0   0   0   0   0
   0   1   1   1   0
   0   1   1   1   0
   0   0   0   0   0
 
 initialize and print four-dimensional array b
 
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
 
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
 
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
 
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
 
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
 
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
 
 repeat the three-dimensional example on each 
 three-dimensional slice of b's leading dimension
 
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
 
   0   0   0   0   0
   0   1   1   1   0
   0   1   1   1   0
   0   0   0   0   0
 
   0   0   0   0   0
   0   1   1   1   0
   0   1   1   1   0
   0   0   0   0   0
 
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
   0   0   0   0   0
 
   0   0   0   0   0
   0   1   1   1   0
   0   1   1   1   0
   0   0   0   0   0
 
   0   0   0   0   0
   0   1   1   1   0
   0   1   1   1   0
   0   0   0   0   0

Version 2017.0
Copyright © 2017, Rogue Wave Software, Inc. All Rights Reserved.