Module Library: RSUBSTR Function

RSUBSTR Function

replaces substrings in each entry of a given matrix

RSUBSTR( $\text{[math]}$ , $\text{[math]}$ , $\text{[math]}$ , $\text{[math]}$ ) ;

The inputs to the RSUBSTR subroutine are as follows:

$\text{[math]}$: is any $\text{[math]}$ character matrix.
$\text{[math]}$: is an $\text{[math]}$ matrix or a scalar that determines the starting positions for substrings to be replaced.
$\text{[math]}$: is an $\text{[math]}$ matrix or a scalar that determines the lengths of substrings to be replaced.
$\text{[math]}$: is an $\text{[math]}$ matrix or a scalar that specifies the replacement strings.

The RSUBSTR function returns an $\text{[math]}$ matrix with substrings replaced. It replaces or substitutes substrings of the input matrix with new strings. If $\text{[math]}$ is zero, the replacement string in $\text{[math]}$ is simply inserted into the input matrix $\text{[math]}$ at the position indicated by $\text{[math]}$ .

For example, the following statements replace the first two characters of each entry in the matrix X with 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;