RSUBSTR Function

Chapter Contents

Module Library

RSUBSTR Function

replaces substrings in each entry of a given matrix

RSUBSTR( x, p, l, r)

The inputs to the RSUBSTR subroutine are as follows:

x: is any m ×n character matrix.
p: is an m ×n matrix or a scalar that determines the starting positions for substrings to be replaced.
l: is an m ×n matrix or a scalar that determines the lengths of substrings to be replaced.
r: is an m ×n matrix or a scalar that specifies the replacement strings.

The RSUBSTR function returns an m ×n matrix with substrings replaced. It replaces or substitutes substrings of the input matrix with new strings. If l is zero, the replacement string in r is simply inserted into the input matrix x at the position indicated by p.

For example, the following statements replace the first two characters of each entry in the matrix X with the the corresponding entry in the matrix R:

proc iml;
   x = {abc def ghi,jkl mno pqr};
   r = {z y x, w v u};
   p = 1;
   l = 2;
   c=rsubstr(x,p,l,r);
   print x;
   print c;

Chapter Contents
Previous
Next
Top