Scripting Guide - SAS

292 Data Tables Chapter 9
Row State Operators
if(sex=="M",
/*then*/ row state()=combine states(
color state(4), marker state(6), hidden state(1)),
/*else*/ row state()=combine states(
color state(3), marker state(2), hidden state(0))));
Get the row state for one row, such as the 6th:
row state(6);
Combine States(Hidden State(1), Color State(4), Marker State(6))
Notice that JMP returns a Combine State combination. This is because a row state datum is not just the
state of one characteristic, such as color, but the cumulative state of all the characteristics that have been set:
exclusion, hiding, labeling, selection, markers, colors, hues, and shades. A list of such characteristics is called
a row state combination.
Just as there can be many row state characteristics in effect, a row state column can have
multiple-characteristic row states as its values.
Some Operators set one Characteristic and Clear Others
In addition to the overall Row State operator for getting or setting all the characteristics of a row state, there
are separate operators to get or set one characteristic at a time preemptively. That is, to give a row one
characteristic, canceling any other characteristics that might be in effect. These operators are Color State,
Combine States, Excluded State, Hidden State, Hue State, Labeled State, Marker State,
Selected State, Shade State.
For example, to make row 4 be hidden only:
rowstate(4)=hidden state(1);
Other Operators set or get one Characteristic at a Time
As seen above, a row state is not just one characteristic but many. To work with just one thing at a time, use
one of the L-value operators with Row State on either side of the equal sign, depending on whether you
want to get or set. There is an L-value operator for each of the characteristics: Color Of, Excluded,
Hidden, Labeled, Marker Of, Selected.
Get Row States
// hide row 4 without affecting other characteristics:
hidden(rowstate(4))=1;
// store color of row 3 without getting other characteristics:
::color = color of(rowstate(3));
To access a row state, place the row state expression on the right side of an assignment:
x = rowstate(i); // puts row state of row i into x
x = rowstate(); // row state of current row