Scripting Guide - SAS

Chapter 9 Data Tables 291
Row State Operators
for each row(
rowstate()=combine states(color state(row()), marker state(row())));
And now observe the difference between setting one attribute of a row state:
color of(rowstate(1))=3;
And setting every aspect of a row state to a single state:
// makes row 1 red without changing marker
row state(1)=color state(5); // makes row 1 blue and loses its marker
To copy all the current row states into a row state column:
new column("rscol", set formula(rowstate());
for each row(rscol = rowstate());
To copy several but not all the current row states into a row state column, you would use a script like the
following, commenting out or omitting any states that you do not want.
new column("rscol2", set formula(CombineStates(
ColorState( color of() ),
ExcludedState( excluded() ),
HiddenState( hidden() ),
LabeledState( labeled() ),
MarkerState( marker of() ),
SelectedState( selected() ))));
Note: The current row for scripting is not related to rows being selected (highlighted)
in the data table or to the current cursor position in the data table window. The current
row for scripting is defined to be zero (no row) by default. You can set a current row with
Row. For example, Row()=3, but please note that such a setting only lasts for the
duration of that script, and then Row() reverts to its default value, zero, so submitting a
script all at once can produce different results than submitting a script a few lines at a
time.
Another way to establish a current row for a script is to enclose it in For Each Row,
which executes the script once for each row of the current data table.
Throughout this chapter, examples without an explicit current row, such as below,
should be assumed to take place within a context that establishes a current row. For
example, inside For Each Row( ) or after Row()=1.
rowstate()=color state(3);
See “What is the Current Row?” on page 250, for more information.
Combinations of Characteristics
You can get or set many characteristics at once by combining state settings inside Combine States, or you
can get or set each characteristic one at a time, with the ultimate row state being the accumulation of
characteristics. For example, with Big Class, you can set green Y markers for males but for now hide them
in plots, and set red X markers for females and not hide them in plots:
for each row(