RWSlice Class Reference

Represents an index that can be used for subscripting vectors, matrices, and arrays. More...

#include <rw/rwslice.h>

Inheritance diagram for RWSlice:

Public Member Functions
	RWSlice (const char *s)
	RWSlice (int begin, int length)
	RWSlice (int begin, int length, int stride)

Friends
class	RWRange
class	RWToEnd

Related Symbols
(Note that these are not member symbols.)
const RWSlice &	RWAll

Detailed Description

An RWSlice object is an index which can be used for subscripting vectors, matrices, and arrays. By subscripting with RWSlice objects, you create views of selected elements. These new views are vectors, matrices, or arrays in their own right, rather than simply helper classes. This means that a view created with subscripting can be used as an rvalue, an lvalue, or kept as an object for use later.

The classes RWRange and RWToEnd are derived from RWSlice. RWRange and RWToEnd objects can be used wherever an RWSlice object can be used.

Although they are not declared, the C++ language automatically defines a copy constructor and an assignment operator. These can be useful when passing RWSlice objects as function arguments or using RWSlice objects as class instance variables.

Synopsis

#include <rw/math/mathvec.h>
RWMathVec<double> x(20, 2);
RWMathVec<double> y = x("4:9");  // set y to view
                                 // elements 4 through 9

Example

#include <rw/math/genmat.h>
#include <iostream.h>
 
int main() {
  RWGenMat<int> A(6, 6);
  RWSlice I("0::2");   // indices 0,2,4
  RWSlice J(1, 3, 2);  // indices 1,3,5
  A(I, I) = 1;
  A(I, J) = 2;
  A(J, I) = 3;
  A(J, J) = 4;
  cout << A << endl;
}

Program output:

6x6
[
     1     2     1     2     1     2
     3     4     3     4     3     4
     1     2     1     2     1     2
     3     4     3     4     3     4
     1     2     1     2     1     2
     3     4     3     4     3     4
]

See also

RWRange, RWToEnd, RWMathVec::operator()(), RWGenMat::operator()(), RWMathArray::operator()()

Constructor & Destructor Documentation

RWSlice() [1/3]

RWSlice::RWSlice ( int begin, int length )

inline

Constructs an object that indexes length elements starting at element begin.

RWSlice() [2/3]

RWSlice::RWSlice ( int begin, int length, int stride )

inline

Constructs an object that indexes length elements starting at element begin. The parameter stride is the increment between successive selected elements. If the stride is negative, the new view reverses the indices.

RWSlice() [3/3]

RWSlice::RWSlice

(

const char *

s

)

Constructs an index from the null terminated character string s. The syntax of the character string is x:y:z, where x, y, and z are integers. The resulting index selects elements from x through y, inclusive, with an increment of z between successive selected elements. Any or all of x, y, and z may be left out, in which case they default to 0, the last element, and 1, respectively. If z is omitted, the second colon may also be omitted. The character string * is a synonym for :, which selects all elements.

Friends And Related Symbol Documentation

RWAll

const RWSlice& RWAll

related

This special index selects all the elements.