From 54ac874d464071b09dbf3884ba8b502065b3eb5f Mon Sep 17 00:00:00 2001 From: Bart Jablonski Date: Tue, 13 Jan 2026 15:11:05 +0100 Subject: [PATCH] The macroArray package [ver. 1.3.0] The macroArray package [ver. 1.3.0] Changes: - Four new parameters in the `%do_over()` macro: `check`, `rephrase`, `trigger`, and `unq`. - Minor updates in the `%array()` macro. - Documentation updated. SHA256 digest for the latest version macroArray: F*9B51F1B434742F08166F28DE40D64F16E9BC5ED8D1926AE7148A48116F7BDBA0 --- README.md | 2 +- hist/macroarray_1.3.0_.md | 2468 ++++++++++++++++++++++++++++++++++++ hist/macroarray_1.3.0_.zip | Bin 0 -> 56259 bytes macroarray.md | 1246 ++++++++++-------- macroarray.zip | Bin 53447 -> 56259 bytes 5 files changed, 3183 insertions(+), 533 deletions(-) create mode 100644 hist/macroarray_1.3.0_.md create mode 100644 hist/macroarray_1.3.0_.zip diff --git a/README.md b/README.md index 52e0138..1e7fe6f 100644 --- a/README.md +++ b/README.md @@ -22,7 +22,7 @@ The **macroArray** package implements an array, a hash table, and a dictionary c ); ``` -SHA256 digest for the latest version of `macroArray`: F*3F3893F1FCD78719543703E4353F4CC19811D247C016F220FF729B283C1AD790 +SHA256 digest for the latest version of `macroArray`: F*9B51F1B434742F08166F28DE40D64F16E9BC5ED8D1926AE7148A48116F7BDBA0 [**Documentation for macroArray**](./macroarray.md "Documentation for macroArray") diff --git a/hist/macroarray_1.3.0_.md b/hist/macroarray_1.3.0_.md new file mode 100644 index 0000000..c03acda --- /dev/null +++ b/hist/macroarray_1.3.0_.md @@ -0,0 +1,2468 @@ +# Documentation for the `macroArray` package. + +---------------------------------------------------------------- + + *Macroarrays for macro codes* + +---------------------------------------------------------------- + +### Version information: + +- Package: macroArray +- Version: 1.3.0 +- Generated: 2026-01-13T14:47:32 +- Author(s): Bartosz Jablonski (yabwon@gmail.com) +- Maintainer(s): Bartosz Jablonski (yabwon@gmail.com) +- License: MIT +- File SHA256: `F*9B51F1B434742F08166F28DE40D64F16E9BC5ED8D1926AE7148A48116F7BDBA0` for this version +- Content SHA256: `C*BBE7D736D7DF66231C41EEE321E9FE8C50D174C6DC43AFC09F4990894A5E7CBD` for this version + +--- + +# The `macroArray` package, version: `1.3.0`; + +--- + + +The **macroArray** package implements a macroarray facility. + +The set of macros, which emulates classic +data-step-array functionality on the macro +programming level, is provided. + +Some of components are: +- `%array()`, +- `%do_over()`, +- `%make_do_over()`, +- `%deletemacarray()`, +- `%concatarrays()`, +- `%appendcell()`, +- `%mcHashTable()`, +- `%zipArrays()`, +- `%sortMacroArray()`, +- `%mcDictionary()`, +- etc. + +*Note:* +If you are working with BIG macroarrays do not +forget to verify your session setting for macro +memory limits. Run: +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + proc options group = macro; + run; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +to verify the following options: + +| option | description | +|-------------:|:-----------------------------------------------------------------------------------------------| +|`MEXECSIZE=` | specifies the maximum macro size that can be executed in memory. | +|`MSYMTABMAX=` | specifies the maximum amount of memory available to the macro variable symbol table or tables. | +|`MVARSIZE=` | specifies the maximum size for a macro variable that is stored in memory. | + +--- + + +--- + + +--- + +Required SAS Components: + - Base SAS Software + +--- + + +--------------------------------------------------------------------- + +*SAS package generated by SAS Package Framework, version `20251231`,* +*under `WIN`(`X64_10PRO`) operating system,* +*using SAS release: `9.04.01M9P06042025`.* + +--------------------------------------------------------------------- + +# The `macroArray` package content +The `macroArray` package consists of the following content: + +1. [`%appendarray()` macro ](#appendarray-macro-1 ) +2. [`%appendcell()` macro ](#appendcell-macro-2 ) +3. [`%array()` macro ](#array-macro-3 ) +4. [`%concatarrays()` macro ](#concatarrays-macro-4 ) +5. [`%deletemacarray()` macro ](#deletemacarray-macro-5 ) +6. [`%do_over()` macro ](#doover-macro-6 ) +7. [`%do_over2()` macro ](#doover2-macro-7 ) +8. [`%do_over3()` macro ](#doover3-macro-8 ) +9. [`%make_do_over()` macro ](#makedoover-macro-9 ) +10. [`%mcdictionary()` macro ](#mcdictionary-macro-10 ) +11. [`%mchashtable()` macro ](#mchashtable-macro-11 ) +12. [`%qziparrays()` macro ](#qziparrays-macro-12 ) +13. [`%sortmacroarray()` macro ](#sortmacroarray-macro-13 ) +14. [`%ziparrays()` macro ](#ziparrays-macro-14 ) + + +15. [License note](#license) + +--- + +## `%appendarray()` macro ###### + +The `%appendArray()` macro is a macrowrapper +which allows to concatenate two macroarrays +created by `%array()` macro. + +By default values of the second macroarray are *not* removed. + +Dimensions of the first macroarray are extended. + +The `%appendArray()` macro executes like a pure macro code. + +### SYNTAX: ##################################################################### + +The basic syntax is the following, the `<...>` means optional parameters: +~~~~~~~~~~~~~~~~~~~~~~~sas +%appendArray( + first + ,second +) +~~~~~~~~~~~~~~~~~~~~~~~ + +**Arguments description**: + +1. `first` - *Required*, a name of a macroarray created by the `%array()` macro. + +2. `second` - *Required*, a name of a macroarray created by the `%array()` macro. + + +### EXAMPLES AND USECASES: ###################################################### + +**EXAMPLE 1.** Append macroarrays LL and MM. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(ll[2:4] $ 12, + function = quote(put(today() + 10*_I_, yymmdd10.)), + macarray=Y + ) + %array(mm[10:13] $ 1200, + function = quote(repeat("A",12*_I_)), + macarray=Y + ) + %put *%ll(2)*%ll(3)*%ll(4)*; + + %appendArray(ll, mm); + %put *%ll(2)*%ll(3)*%ll(4)*%ll(5)*%ll(6)**%ll(7)*%ll(8)*; + + %put *%mm(10)**%mm(11)*%mm(12)*%mm(13)*; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 2.** Error handling. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %appendArray(ll, ) + %appendArray(, mm) + + %appendArray(noExistA, noExistB) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +--- + + +--- + +## `%appendcell()` macro ###### + +The `%appendCell()` macro allows to append +a macrovariable to a macroarray created by the `%array()` macro. + +Dimensions of the macroarray are extended. + +The `%appendCell()` macro executes like a pure macro code. + +### SYNTAX: #################################################################### + +The basic syntax is the following, the `<...>` means optional parameters: +~~~~~~~~~~~~~~~~~~~~~~~sas +%appendCell( + first + ,second + ,hilo +) +~~~~~~~~~~~~~~~~~~~~~~~ + +**Arguments description**: + +1. `first` - *Required*, a name of a macroarray created by the `%array()` macro. + +2. `second` - *Required*, a name of a macrovariable to be append to the macroarray. + +3. `hilo` - *Required*, if `H` macrovariable is appended at the end + if `L` macrovariable is appended at the beginning + + +### EXAMPLES AND USECASES: #################################################### + +**EXAMPLE 1.** Create two macro wrappers. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %* Macro wrapper to append a macrovariable to the end of a macroarray; + %macro appendHC(array,cell); + %appendCell(&array.,&cell.,H) + %mend appendHC; + + %* macro wrapper to append a macrovariable to the beginning of a macroarray; + %macro appendLC(array,cell); + %appendCell(&array.,&cell.,L) + %mend appendLC; + + + %* create macroarrays X and variables W,Y,Z; + + %array(X[2:4] $ ("AAA", "BBB", "CCC"), macarray=Y) + %let W=1; + %let Y=2; + %let Z=3; + %put *%do_over(X)*&=W*&=Y*&=Z*; + + %put BEFORE *%do_over(X)**&=xLBOUND*&=xHBOUND*&=xN*; + %appendCell(X,Y,H) + %put AFTER1 *%do_over(X)**&=xLBOUND*&=xHBOUND*&=xN*; + + %appendLC(X,W) + %put AFTER2 *%do_over(X)**&=xLBOUND*&=xHBOUND*&=xN*; + + %appendHC(X,Z) + %put AFTER3 *%do_over(X)**&=xLBOUND*&=xHBOUND*&=xN*; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 2.** Error handling +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %appendCell(X,Y,blahblah) + + %appendCell(X,,H) + %appendCell(,Y,H) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**EXAMPLE 3.** Adding variable below lower bound. +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(zero[0:2] $ ("AAA", "BBB", "CCC"), macarray=Y) + %let belowzero=zzz; + + %put BEFORE *%do_over(zero)**&=zeroLBOUND*&=zeroHBOUND*&=zeroN*; + %appendCell(zero,belowzero,L) + %put AFTER *%do_over(zero)**&=zeroLBOUND*&=zeroHBOUND*&=zeroN*; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +--- + + +--- + +## `%array()` macro ###### + +The code of a macro was inspired by +*Ted Clay's* and *David Katz's* macro `%array()`. + +The `%array()` macro version provided in the package +is designed to facilitate +the idea of macroarray concept, i.e. *a list of +macrovariables with common prefix and numerical suffixes*. +Usually such construction is then resolved by +double ampersand syntax, e.g. `&&perfix&i` or similar one. + +What is new/extension to the `%array()` macro concept are: + +0. The syntax is closer to the data step one. +1. It is a pure macro code (it can be executed in any place + of 4GL code), this includes generating macroarrays out + of datasets. +2. When a macroarrray is created it allows also to generate + a new macro (named the same as the array name) and replace + the double ampersand syntax with more array looking one, + i.e. for array ABC user can have `%ABC(1)`, `%ABC(2)`, or `%ABC(&i)` + constructions. +3. The array macro allows to use data step functions to generate + array's entries. + +The `%array()` macro executes like a pure macro code. + +### SYNTAX: ################################################################### + +The basic syntax is the following, the `<...>` means optional parameters: +~~~~~~~~~~~~~~~~~~~~~~~sas +%array( + array + <,function=> + <,before=> + <,after=> + <,vnames=N> + <,macarray=N> + <,ds=> + <,vars=> + <,q=> +) +~~~~~~~~~~~~~~~~~~~~~~~ + +**Arguments description**: + +1. `array` - *Required*, an array name and a declaration/definition of an array,
+ e.g. `myArr[*] x1-x3 (4:6)`
+ or `myBrr[*] $ y1-y3 ("a" "b" "c")`
+ or `myCrr[3] $ ("d d d" "e,e,e" "f;f;f")`
+ or `myDrr p q r s`.
+ Macrovariables created by the macro are *global*. + If an array name is `_` (single underscore) then attached variables + list names are used, a call of the form: + `%array(_[*] p1 q2 r3 s4 (-1 -2 -3 -4))` + will create macrovariables: `p1`, `q2`, `r3`, and `s4` with respective + values: `-1`, `-2`, `-3`, and `-4`.
+ Three additional *global* macrovariables: + `LBOUND`, `HBOUND`, and `N` + are generated with the macroarray. See examples for more use-cases. + +* `function=` - *Optional*, a function or an expression to be applied to all array cells, + `_I_` is as array iterator, e.g. `_I_ + rand("uniform")`. + +* `before=` - *Optional*, a function or an expression to be added before looping through + array, e.g. `call streaminit(123)`. + +* `after=` - *Optional*, a function or an expression to be added after looping through + array, e.g. `call sortn(ABC)`. + +* `vnames=N` - *Optional*, default value `N`, if set to `Y`/`YES` then macroarray is built based + on variables names instead values, e.g. + `%array(myArr[*] x1-x3 (4:6), vnames=Y)` + will use `x1`, `x2`, and `x3` as values instead `4`, `5`, and `6`. + +* `macarray=N` - *Optional*, default value `N`, if set to `Y`/`YES` then a macro, named with the array + name, is compiled to create convenient envelope for multiple ampersands, e.g. + `%array(myArr[*] x1-x3 (4:6), macarray=Y)` + will create `%myArr(J)` macro which will allow to extract "data" + from macroarray like: + `%let x = %myArr(1);` + or when used with second parameter equal `I` (insert) allow to overwrite macroarrays + value: + `%let %myArr(17,i) = 42;` + If set to `M` then for a given array name the macro symbols table is scanned for + macrovariables with prefix like the array name and numeric suffixes, + then the minimum and the maximum index is determined + and all not existing global macrovariables are created and + a macro is generated in the same way as for the `Y` value. + +* `ds=` - *Optional*, use a dataset as a basis for a macroarray data, + if used by default overwrites use of the `array` parameter, honors `macarray=` + argument, dataset options are allowed, e.g. `sashelp.class(obs=5)` + +* `vars=` - *Optional*, a list of variables used to create macroarrays from a dataset, + the list format can be as follows (`<...>` means optional): + `variable1 <... variableN>` + delimiters are hash(`#`) and pipe(`|`), currently only space + is supported as separator, the meaning of `#` and `|` delimiters + will be explained in the following example: + if the `vars = height#h weight weight|w age|` value is provided + then the following macroarrays will be created:
+ 1) macroarray "H" with ALL(`#`) values of variable "height"
+ 2) macroarray "WEIGHT" with ALL(no separator is equivalent to #) + values of variable "weight"
+ 3) macroarray "W" with UNIQUE(|) values of variable "weight" and
+ 4) macroarray "AGE" with UNIQUE(|) values of variable "age". + +* `q=` - *Optional*, indicates (when set to `1` or '2') if the value should be surrounded by quotes. + It uses `quote(cats(...))` combo under the hood. Default value is `0`. + Value `1` is for apostrophes, value `2` is for double quotes. + Ignored for `macarray=M`. + + +### EXAMPLES AND USECASES: #################################################### + + +**EXAMPLE 1.** Basic use-case. + Creating macroarray like in the array statement. + Values not variables names are used by default. + Different types of brackets are allowed. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(a[*] x1-x5 (1:5)) + + %array(b{5} (5*17), q=1) + + %* Mind the $ since it is a character array!; + %array(c(3) $ 10 ("a A" "b,B" "c;C")) + + %array(d x1-x5 (5 4 3 2 1)) + %put _user_; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 2.** Index ranges. + If range starts < 0 then it is shifted to 0. + In case when range is from `1` to `M` + then macrovariable `N` is set to `M` + In case when range is different + the `N` returns number of + elements in the array `(Hbound - Lbound + 1)`. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(d[-2:2] $ ("a" "b" "c" "d" "e")) + %put &=dLBOUND. &=dHBOUND. &=dN.; + %put &=d0. &=d1. &=d2. &=d3. &=d4.; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 3.** Functions. + It is possible to assign value of a function + or an expression to a cell of the array, + e.g. `array[_I_] = function(...)`. + You can use an iterator in a function. + As in case of usual arrays it is `_I_`. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(e[-3:3] $, function = "A" ) + %put &=eLBOUND. &=eHBOUND. &=eN.; + %put &=e0. &=e1. &=e2. &=e3. &=e4. &=e5. &=e6.; + + %array(f[-3:3], function = (2**_I_) ) + %put &=fLBOUND. &=fHBOUND. &=fN.; + %put &=f0. &=f1. &=f2. &=f3. &=f4. &=f5. &=f6.; + + %array(g[0:2], function = ranuni(123) ) + %put &=gLBOUND. &=gHBOUND. &=gN.; + %put &=g0. &=g1. &=g2.; + + %* Or something more complex; + %array(gg[0:11] $ 11, function = put(intnx("MONTH", '1jun2018'd, _I_, "E"), yymmn.), q=1) + %put &=ggLBOUND. &=ggHBOUND. &=ggN.; + %put &=gg0 &=gg1 &=gg2 ... &=gg11; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 4.** Functions cont. + If there is need for set-up something *before* or *after*: + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(h[10:12] + ,function = rand('Uniform') + ,before = call streaminit(123) + ,after = call sortn(of h[*]) + ) + %put &=h10. &=h11. &=h12.; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 5.** Fibonacci series. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(i[1:10] (10*0) + ,function = ifn(_I_ < 2, 1, sum(i[max(_I_-2,1)], i[max(_I_-1,2)]) ) ) + %put &=i1 &=i2 &=i3 &=i4 &=i5 &=i6 &=i7 &=i8 &=i9 &=i10; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 6a.** Quoted "Uppercas Letters" + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(UL[26] $, function = byte(rank("A")+_I_-1) , q=1) + %put &=UL1 &=UL2 ... &=UL25 &=UL26; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 6b.** "Lowercase Letters" + Extended by `macarray=Y` option and + the input mode support (with `I`). + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(ll[26] $, function = byte(rank("a")+_I_-1), macarray=Y) + %put *%ll(&llLBOUND.)*%ll(3)*%ll(4)*%ll(5)*...*%ll(25)*%ll(&llHBOUND.)*; + + %* The range handling, warning; + %put *%ll(265)*; + + %* The input mode; + %put *before:*%ll(2)*; + %let %ll(2,I) = bbbbb; + %put *after: *%ll(2)*; + + %* The range handling, error; + %let %ll(265,I) = bbb; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 7.** The use of `vnames=Y` + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(R R1978-R1982) + %put &=R1 &=R2 &=R3 &=R4 &=R5; + + %array(R R1978-R1982 (78:82)) + %put &=R1 &=R2 &=R3 &=R4 &=R5; + + %array(R R1978-R1982 (78:82), vnames=Y) + %put &=R1 &=R2 &=R3 &=R4 &=R5; + + %array(R R1978-R1982, vnames=Y) + %put &=R1 &=R2 &=R3 &=R4 &=R5; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 8.** A "no name" array i.e. the `_[*]` array + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(_[*] x1-x5 (1:5)) + %put _user_; + + %array(_[*] p q r s (4*42)) + %put _user_; + + %* If no variables names than use _1 _2 ... _N; + %array(_[4] (-1 -2 -3 -4)) + %put &=_1 &=_2 &=_3 &=_4; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 9.** Pure macro code can be used in a data step. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + data test1; + set sashelp.class; + %array(ds[*] d1-d4 (4*17)) + a1 = &ds1.; + a2 = &ds2.; + a3 = &ds3.; + a4 = &ds4.; + run; + + data test2; + set sashelp.class; + %array(_[*] j k l m (4*17)) + a1 = &j.; + a2 = &k.; + a3 = &l.; + a4 = &m.; + run; + + data test3; + set sashelp.class; + %array(alpha[*] j k l m (101 102 103 104), macarray=Y) + a1 = %alpha(1); + a2 = %alpha(2); + a3 = %alpha(3); + a4 = %alpha(4); + a5 = %alpha(555); + run; + + data test4; + set sashelp.class; + %array(beta[*] j k l m (101 102 103 104), vnames=Y, macarray=Y) + a1 = "%beta(1)"; + a2 = "%beta(2)"; + a3 = "%beta(3)"; + a4 = "%beta(4)"; + a5 = "%beta(555)"; + run; + + data test5; + set sashelp.class; + %array(gamma[4] $ 12 ("101" "102" "103" "104"), macarray=Y) + a1 = "%gamma(1)"; + a2 = "%gamma(2)"; + a3 = "%gamma(3)"; + a4 = "%gamma(4)"; + a5 = "%gamma(555)"; + run; + + data test6; + set sashelp.class; + %array(ds = sashelp.cars, vars = Cylinders|, macarray=Y) + a0 = %Cylinders(0); + a1 = %Cylinders(1); + a2 = %Cylinders(2); + a3 = %Cylinders(3); + a4 = %Cylinders(4); + a5 = %Cylinders(555); + run; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 10.** Creating an array from a dataset, basic case. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(ds = sashelp.class, vars = height weight age) + %put _user_; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 11. Creating an array from a dataset, advanced. + If: `vars = height#h weight weight|w age|` + then create: + 1. macroarray "h" with ALL(#) values of variable "height" + 2. macroarray "weight" with ALL(no separator is equivalent to #) values of variable "weight" + 3. macroarray "w" with UNIQUE(|) values of variable "weight" + 4. macroarray "age" with UNIQUE(|) values of variable "age" + Currently the only separator in VARS is a space. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(ds = sashelp.class, vars = height#h weight weight|w age|, q=1) + %put _user_; + + %array(ds = sashelp.class, vars = height#hght weight weight|wght age|, macarray=Y, q=1) + %put *%hght(&hghtLBOUND.)**%weight(2)**%wght(&wghtHBOUND.)**%age(3)*; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 12.** Creating an array from a dataset with dataset options + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(ds = sashelp.cars(obs=100 where=(Cylinders=6)), vars = Make| Type| Model, macarray=Y) + %put *%make(&makeLBOUND.)*%Model(2)*%Model(3)*%Model(4)*%type(&typeHBOUND.)*; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 13.** Creating an array and macro from existing list of macrovariables + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %let myTest3 = 13; + %let myTest6 = 16; + %let myTest9 = 19; + + %array(myTest, macarray=M, q=1) + %do_over(myTest, phrase = %nrstr(%put *&_I_.*%myTest(&_I_.)*;)) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +--- + + +--- + +## `%concatarrays()` macro ###### + + +The `%concatArrays()` macro allows to concatenate +two macroarrays created by the `%array()` macro. + +By default values of the second macroarray are removed. + +Dimensions of the first macroarray are extended. + +The `%concatArrays()` macro executes like a pure macro code. + +### SYNTAX: ##################################################################### + +The basic syntax is the following, the `<...>` means optional parameters: +~~~~~~~~~~~~~~~~~~~~~~~sas +%concatArrays( + first + ,second + <,removeSecond=Y> +) +~~~~~~~~~~~~~~~~~~~~~~~ + +**Arguments description**: + +1. `first` - *Required*, a name of a macroarray created by the `%array()` macro. + +2. `second` - *Required*, a name of a macroarray created by the `%array()` macro. + +* `removeSecond=Y` - *Optional*, default value `Y`, if set to `Y` then + the second array is removed. + + +### EXAMPLES AND USECASES: #################################################### + +**EXAMPLE 1.** Concatenate macroarrays LL and MM. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(ll[2:4] $ 12, + function = quote(put(today() + 10*_I_, yymmdd10.)), + macarray=Y + ) + %array(mm[10:13] $ 12000, + function = quote(repeat("A",123*_I_)), + macarray=Y + ) + %put *%ll(2)*%ll(3)*%ll(4)*; + + %concatArrays(ll, mm); + %put *%ll(2)*%ll(3)*%ll(4)*%ll(5)*%ll(6)**%ll(7)*%ll(8)*; + + %put *%mm(10)**%mm(11)*%mm(12)*%mm(13)*; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 2.** Error handling. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %concatArrays(ll, ) + %concatArrays(, mm) + + %concatArrays(noExistA, noExistB) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +--- + + +--- + +## `%deletemacarray()` macro ###### + +The `%deleteMacArray()` macro allows to delete +macroarrays created by the `%array()` macro. + +The `%deleteMacArray()` macro executes like a pure macro code. + +### SYNTAX: ##################################################################### + +The basic syntax is the following, the `<...>` means optional parameters: +~~~~~~~~~~~~~~~~~~~~~~~sas +%deleteMacArray( + arrs + <,macarray=N> +) +~~~~~~~~~~~~~~~~~~~~~~~ + +**Arguments description**: + +1. `arrs` - *Required*, a space separated list of manes + of macroarray created by the `%array()` macro. + +* `macarray=N` - *Optional*, indicator should a macro + associated with macroarray to be deleted? + If `Y` or `YES` then the associated macro is deleted. + + +--- + +## `%do_over()` macro ###### + +The code of the macro was inspired by +*Ted Clay's* and *David Katz's* macro `%do_over()`. + +The `%DO_OVER()` macro allows to iterate over macroarray created with +the `macarray=Y` parameter of the `%ARRAY()` macro. + +The `%do_over()` macro executes like a pure macro code. + +### SYNTAX: ##################################################################### + +The basic syntax is the following, the `<...>` means optional parameters: +~~~~~~~~~~~~~~~~~~~~~~~sas +%do_over( + arrays + <,phrase = %nrstr(%&array(&_I_.))> + <,between = %str( )> + <,which = > + <,check = 0> + <,rephrase = > + <,trigger = ?> + <,unq = 1> +) +~~~~~~~~~~~~~~~~~~~~~~~ + +**Arguments description**: + +1. `arrays` - *Required*, a space-separated list of macroarrays names. + The first one identifies the macroarray which metadata + (Lbound, Hbouns, and N) are used to loop in the `%do_over()`. + +* `phrase=` - *Optional*, Default value `%nrstr(%&array(&_I_.))`, + a statement to be called in each iteration + of the internal do_over's loop. Loop iterator is `_I_`, + if you want to use `_I_` or array name + [e.g. `%myArr(&_I_.)`] *enclose it* in the `%NRSTR()` + macro quoting function. + +* `between=` - *Optional*, default value `%str( )` (space), + a statement to be called in between each + iteration of the internal do_over loop. + If macroquoted (e.g. `%str( + )`) then the `%unquote()` + function is automatically applied. + +* `which=` - *Optional*, a space-separated list of indexes which + should be used to iterate over selected macroarray. + Possible special characters are `H` and `L` which means + *high* and *low* bound of an array, list could be set with + colons(`:`) in form of `start:end:by` (*no spaces between!*), + if `by` is omitted the default is `1`. If possible use + `1:5` rather `1 2 3 4 5` since the firs works faster. + +* `check=` - *Optional*, indicates should a check for a macro corresponding + to a macroarray be executed. If the macro does not exist wraning + is issued and the `do_over` stops. + Default value `0` means: do not execute check. + +* `rephrase=` - *Optional*, this parameter allows for an alternative aproach + in providing the phrase to be looped over. The idea is to make + writing the phrase string code more convenient and easy to grasp. + The value is a string containing triggers (symbols) that are + replaced by proper macroarray calls. For example, if a macroarray + `myArr` has 7 values form `varName1` to `varName7` and you want + to use them as arguments in code renaming variables, say + `rename old_varName1=new_varName1 ... ;`, instead typing phrase: + `rename %do_over(myArr,phrase=%nrstr(old_%myArr(&_I_.)=new_%myArr(&_I_.)));` + you can type much easier rephrase: + `rename %do_over(myArr,rephrase=old_?=new_?);`, + and all `?` will be replaced, under the hood, by calls to the macroarray. + For easier debuging the `do_over` macro prints the rephrased string + before and after chnge. + When the `do_over` loops with multiple array, say `myArrA`, `myArrB`, + and `myArrC`, then those arrays should be refered by `?1?`, `?2?`, + and `?3?` respectively. + See `trigger` parameter definition to learn more. + If both `phrase` and `rephrase` are used, the seconf takes precedence. + +* `trigger=` - *Optional*, a single byte character (symbol) used for marking + macroarrays in the newly created phrase. + Default value is `?` symbol. + When one macroarray is used, only the symbol should be used in + `rephrase=` string. When multiple macroarrays are used then the + symbol should surroun a number identifying array, e.g. `?2?`. + See examples below for details. + +* `unq=` - *Optional*, indicates that the `%unquote()` macro function should + be added around every macroarray call. Because of SAS internal + behavior `unq=1` is needed for certain cases when plain 4GL code + is used in `rephrase=`. For example, let macro array `myArr()` + has 3 values: `A1`, `B2`, and `C3`. When the following code + is run: `%do_over(myArr, rephrase=data ?_test; run;)` without + `unq=1`, SAS will create 4 data sets: `A1`, `B2`, `C3`, + and `_test`, instead 3 data sets: `A1_test`, `B2_test`, and `C3_test`. + Default value `1` means: add the `%unquote()`. + See example below to learn more. + + +### EXAMPLES AND USECASES: #################################################### + +**EXAMPLE 1.** Simple looping. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(beta[*] j k l m (101 102 103 104), vnames=Y, macarray=Y) + + %put #%do_over(beta)#; + + %put #%do_over(beta, phrase=%nrstr("%beta(&_I_.)"), between=%str(,))#; + + data test1; + %array(beta[*] j k l m (101 102 103 104), vnames=Y, macarray=Y) + %do_over(beta, phrase=%nrstr(a&_I_. = "%beta(&_I_.)";)) + put _all_; + run; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 2.** Multiple arrays looping. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(alpha[*] j k l m n, vnames=Y, macarray=Y) + %array( beta[5] $ , function = "a", macarray=Y) + %array(gamma[4] (101 102 103 104), macarray=Y) + + data test2; + call streaminit(123); + %do_over(beta + , phrase = %nrstr(%beta(&_I_.) = %gamma(&_I_.) * rand('Uniform'); output;) + , between = put _all_; + ); + put _all_; + run; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 3.** Multiple arrays looping, cont. + Create multiple datasets. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %do_over(beta + , phrase = %nrstr( + data %alpha(&_I_.)2; + call streaminit(123); + %beta(&_I_.)x = %gamma(&_I_.) * rand('Uniform'); + output; + run; + ) + ) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 4.** Multiple arrays looping, cont. + Create multiple datasets using a macro. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %macro doit(ds, var=a, val=1); + data &ds.; + call streaminit(123); + &var. = &val. * rand('Uniform'); + output; + run; + %mend doit; + + %do_over(beta + , phrase = %nrstr( + %DOIT(%alpha(&_I_.)1, var = %beta(&_I_.), val = %gamma(&_I_.)) + ) + ) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 5.** `%do_over()` inside `%array()` + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(test[*] x1-x12 (1:12), macarray=Y) + + %put **%test(1)**%test(12)**; + + %put #%do_over(test)#; + + %array(abc[*] x1-x12 (%do_over(test,phrase=%nrstr(%eval(100-%test(&_I_.))))), macarray=Y) + + %put **%abc(1)**%abc(12)**; + + %put #%do_over(abc)#; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 6.** Looping over array with *macroquoted* separator. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(alpha[11] (5:15), macarray=Y) + + %let x = %do_over(alpha + , between= %str( + ) + ); + %put &=x.; + %put %sysevalf(&x.); +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 7.** Working with the `WHICH=` optional parameter + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(test[*] x01-x12, vnames= Y, macarray=Y) + + %put #%do_over(test)#; + + %put #%do_over(test, which= 1 3 5)#; + + %put #%do_over(test, which= 1:5)#; + + %put #%do_over(test, which= 1:5:2 7 8)#; + + %put #%do_over(test, which= L:H l:h)#; + + %put #%do_over(test, which= L:3 10:h)#; + + %put #%do_over(test, which= L:H h:l:-1 13 14)#; + + %put #%do_over(test, which= %eval(1+1):%eval(5+1))#; + + %put #%do_over(test, which= L:H h:l:-1 13 14, between=%str(,))#; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 8.** Simpler multiple arrays looping with `rephrase=`. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(alpha[*] j k l m n o p, vnames=Y, macarray=Y) + %array( beta[&alphaN.], function = (2**_i_), macarray=Y) + %array(gamma[&alphaN.] (1:&alphaN.), macarray=Y) + + %put >>%do_over(alpha)<<; + %put >>%do_over(beta)<<; + %put >>%do_over(gamma)<<; + + data test8; + call streaminit(123); + + %do_over( alpha beta gamma + , rephrase = ?1? = ?2? + ?3? * rand('Uniform'); output; + , between = put _all_; + ) + put _all_; + run; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 9.** Simpler multiple arrays looping with `rephrase=`, cont. + Create multiple datasets. Array `alpha`, `beta`, and `gamma` are + from the privious example. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %do_over(alpha beta gamma + , rephrase = + data ?1?_2; + call streaminit(?2?); + ?1?X = ?2? + ?3? * rand('Uniform'); + output; + run; + ) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 10.** Simpler multiple arrays looping with `rephrase=`, cont. + Create multiple datasets using a macro. Array `alpha`, `beta`, + and `gamma` are from the privious example. + The `%nrstr()` is required to mask call to the `%doit2()` macro. + Default `?` is replaced with `@`. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %macro doit2(ds, var=a, val1=1, val2=2); + data &ds._3; + call streaminit(&val1.); + &var. = &val1. + &val2. * rand('Uniform'); + output; + run; + %mend doit2; + + %do_over( alpha beta gamma + , rephrase = %nrstr(%doit2(@1@, var = @1@, val1 = @2@, val2 = @3@)) + , trigger = @ + ) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 11.** Simpler multiple arrays looping with `rephrase=`, cont. + Why the `unq=` is needed. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(myArr[3] $ ("A1" "B2" "C3"), macarray=Y) + + %do_over(myArr, rephrase=data ?_testUNQ1; run;, unq=1) + + %do_over(myArr, rephrase=data ?_testUNQ0; run;, unq=0) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + + +**EXAMPLE 12.** Simpler multiple arrays looping with `rephrase=`, cont. + Renaming variables is easy now. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(V[*] a b c d e f g h, vnames=1, macarray=1) + + data test12; + array x{*} %do_over(V) (1:&VN.); + run; + + proc datasets nolist noprint lib=work; + modify test12; + rename + %do_over(V,rephrase = $=new_$,trigger=$) + ; + run; + quit; + + data _null_; + set test12; + put _ALL_; + run; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +--- + +--- + +## `%do_over2()` macro ###### + +The code of the macro was inspired by +*Ted Clay's* and *David Katz's* macro `%do_over()`. + +The `%DO_OVER2()` macro allows to iterate over *two* macroarray created with +the `macarray=Y` parameter of the `%ARRAY()` macro. + +The `%do_over2()` macro executes like a pure macro code. + +### SYNTAX: ##################################################################### + +The basic syntax is the following, the `<...>` means optional parameters: +~~~~~~~~~~~~~~~~~~~~~~~sas +%do_over2( + arrayI + ,arrayJ + <,phrase=%nrstr(%&arrayI(&_I_.) %&arrayJ(&_J_.))> + <,between=%str( )> +) +~~~~~~~~~~~~~~~~~~~~~~~ + +**Arguments description**: + +1. `arrayI` - Required, indicates the first macroarray which metadata (Lbound, Hbouns) + are to be used in the outer loop in the `%do_over2()` + +2. `arrayJ` - Required, indicates the second macroarray which metadata (Lbound, Hbouns) + are to be used in the inner loop in the `%do_over2()` + +* `phrase=` - *Optional*, default value `%nrstr(%&arrayI(&_I_.) %&arrayJ(&_J_.))`, + a statement to be called in each iteration + of the *inner* loop. The outer loop iterator is `_I_`, + the inner loop iterator is `_J_`, + if you want to use `_I_`, `_J_`, or arrays names + [e.g. `%myArr(&_I_.)`] *enclose them* in the `%NRSTR()` + macro quoting function. + +* `between=` - *Optional*, default value `%str( )` (space), + a statement to be called in between each + iteration of the internal do_over2 loop. + If macroquoted (e.g. `%str( + )`) then the `%unquote()` + function is automatically applied. + + +### EXAMPLES AND USECASES: #################################################### + +**EXAMPLE 1.** Looping over two arrays. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(alpha[*] j k l m n, vnames=Y, macarray=Y) + %array( beta[4] (101 102 103 104), macarray=Y) + + %put *%do_over2(alpha, beta + , phrase = %NRSTR((%alpha(&_I_.), %beta(&_J_))) + )*; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 2.** Looping over two arrays with a separator. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(alpha[11] (5:15), macarray=Y) + %array( beta[ 4] (101 102 103 104), macarray=Y) + + %let x = %do_over2(alpha, beta + , phrase = %NRSTR((%alpha(&_I_.) * %beta(&_J_))) + , between= + + ); + %put &=x.; + %put %sysevalf(&x.); +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 3.** Looping over two arrays with *macroquoted* separator. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(alpha[11] (5:15), macarray=Y) + %array( beta[ 4] (101 102 103 104), macarray=Y) + + %let x = %do_over2(alpha, beta + , phrase = %NRSTR((%alpha(&_I_.) * %beta(&_J_))) + , between= %str( + ) + ); + %put &=x.; + %put %sysevalf(&x.); +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +--- + +--- + +## `%do_over3()` macro ###### + +The code of the macro was inspired by +*Ted Clay's* and *David Katz's* macro `%do_over()`. + +The `%DO_OVER3()` macro allows to iterate over *three* macroarray created with +the `macarray=Y` parameter of the `%ARRAY()` macro. + +The `%do_over3()` macro executes like a pure macro code. + +### SYNTAX: ##################################################################### + +The basic syntax is the following, the `<...>` means optional parameters: +~~~~~~~~~~~~~~~~~~~~~~~sas +%do_over2( + arrayI + ,arrayJ + ,arrayK + <,phrase=%nrstr(%&arrayI(&_I_.) %&arrayJ(&_J_.) %&arrayK(&_K_.))> + <,between=%str( )> +) +~~~~~~~~~~~~~~~~~~~~~~~ + +**Arguments description**: + +1. `arrayI` - *Required*, indicates the first macroarray which metadata (Lbound, Hbouns) + are to be used in the outer loop in the `%do_over3()` + +2. `arrayJ` - *Required*, indicates the second macroarray which metadata (Lbound, Hbouns) + are to be used in the inner loop in the `%do_over3()` + +3. `arrayK` - *Required*, indicates the third macroarray which metadata (Lbound, Hbouns) + are to be used in the inner loop in the `%do_over3()` + +* `phrase=` - *Optional*, default value `%nrstr(%&arrayI(&_I_.) %&arrayJ(&_J_.) %&arrayK(&_K_.))`, + a statement to be called in each iteration + of the *inner* loop. The *outer* loop iterator is `_I_`, + the *middle* loop iterator is `_J_`, the *inner* loop iterator is `_K_`, + if you want to use `_I_`, `_J_`, `_K_`, or arrays names + [e.g. `%myArr(&_I_.)`] *enclose them* in the `%NRSTR()` + macro quoting function. + +* `between=` - *Optional*, default value `%str( )` (space), + a statement to be called in between each + iteration of the internal do_over2 loop. + If macroquoted (e.g. `%str( + )`) then the `%unquote()` + function is automatically applied. + + +### EXAMPLES AND USECASES: #################################################### + +**EXAMPLE 1.** Looping over 3 macroarrays. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(a1_[2] (0 1), macarray=Y) + %array(a2_[2] (2 3), macarray=Y) + %array(a3_[2] (4 5), macarray=Y) + + %do_over3(a1_, a2_, a3_ + , phrase = %NRSTR(%put (%a1_(&_I_.), %a2_(&_J_), %a3_(&_K_));) + ) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**EXAMPLE 2.** Looping 3 times over a macroarray. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(a[0:2] (0 1 2), macarray=Y) + + %do_over3(a, a, a + , phrase = %NRSTR(%put (%a(&_I_.), %a(&_J_), %a(&_K_));) + ) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +--- + +--- + +## `%make_do_over()` macro ###### + +The code of the macro was inspired by +*Ted Clay's* and *David Katz's* macro `%do_over()`. + +The `%make_do_over()` macro allows to generate +the `%DO_OVER()` macros. It works *only* for *n>3*! + +The `%make_do_over()` macro does *not* executes like a pure macro code. + +### SYNTAX: ##################################################################### + +The basic syntax is the following, the `<...>` means optional parameters: +~~~~~~~~~~~~~~~~~~~~~~~sas +%make_do_over( + size +) +~~~~~~~~~~~~~~~~~~~~~~~ + +**Arguments description**: + +1. `size` - *Required*, indicates the number of dimensions + (i.e. inner loops) of the `%DO_OVER()` macro. + + +### EXAMPLES AND USECASES: #################################################### + +**EXAMPLE 1.** Code of created "4-loop" `%DO_OVER4()` macro + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %macro do_over4( + arrayI1, + arrayI2, + arrayI3, + arrayI4, + phrase=%nrstr( + %&arrayI1(&_I1_.) + %&arrayI2(&_I2_.) + %&arrayI3(&_I3_.) + %&arrayI3(&_I4_.) + ), + between=%str( ) + ); + %local _I1_ _I2_ _I3_ _I4_; + %do _I1_ = &&&arrayI1.LBOUND %to &&&arrayI1.HBOUND; + %do _I2_ = &&&arrayI2.LBOUND %to &&&arrayI2.HBOUND; + %do _I3_ = &&&arrayI3.LBOUND %to &&&arrayI3.HBOUND; + %do _I4_ = &&&arrayI4.LBOUND %to &&&arrayI4.HBOUND; + %if not ( + &_I1_. = &&&arrayI1.LBOUND + AND &_I2_. = &&&arrayI2.LBOUND + AND &_I3_. = &&&arrayI3.LBOUND + AND &_I4_. = &&&arrayI4.LBOUND + ) + %then %do;%unquote(&between.)%end;%unquote(%unquote(&phrase.)) + %end; + %end; + %end; + %end; + %mend do_over4; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 2.** Create a "4-loop" `%DO_OVER4()` macro + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %make_do_over(4); + + %array(a1_[2] (0 1), macarray=Y) + + %do_over4(a1_, a1_, a1_, a1_ + , phrase = %NRSTR(%put (%a1_(&_I1_.), %a1_(&_I2_), %a1_(&_I3_), %a1_(&_I4_));) + ) + + %put *%do_over4(a1_, a1_, a1_, a1_ + , between = * + )*; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**EXAMPLE 3.** Create a "5-loop" `%DO_OVER5()` macro + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %make_do_over(5); + + %array(a1_[2] (0 1), macarray=Y) + + %do_over5(a1_, a1_, a1_, a1_, a1_ + , phrase = %NRSTR(%put (%a1_(&_I1_.), %a1_(&_I2_), %a1_(&_I3_), %a1_(&_I4_), %a1_(&_I5_));) + ) + + %put *%do_over5(a1_, a1_, a1_, a1_, a1_ + , between = * + )* + ; + + options nomprint; + data test2; + %do_over5(a1_, a1_, a1_, a1_, a1_ + , phrase = %NRSTR(x1 = %a1_(&_I1_.); x2 = %a1_(&_I2_); x3 = %a1_(&_I3_); x4 = %a1_(&_I4_); x5 = %a1_(&_I5_);) + , between = output; + ) + output; + run; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 4.** Create all from 6 to 10 "do_overs" + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(loop[6:10] (6:10), macarray=Y) + %do_over(loop + , phrase = %nrstr( + %make_do_over(%loop(&_I_.)) + ) + ); +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +--- + +--- + +## `%mcdictionary()` macro ###### + +The `%mcDictionary()` macro provided in the package +is designed to facilitate the idea of a "macro dictionary" +concept, i.e. *a list of macrovariables with common prefix +and suffixes generated as a hash digest* which allows +to use values other than integers as indexes. + +The `%mcDictionary()` macro allows to generate other macros +which behaves like a dictionary. See examples below. + +The `%mcDictionary()` macro executes like a pure macro code. + +### SYNTAX: ################################################################### + +The basic syntax is the following, the `<...>` means optional parameters: +~~~~~~~~~~~~~~~~~~~~~~~sas +%mcDictionary( + H + <,METHOD> + <,DS=> + <,K=Key> + <,D=Data> +) +~~~~~~~~~~~~~~~~~~~~~~~ + +**Arguments description**: + +1. `H` - *Required*, a dictionary macro name and a declaration/definition, + e.g. `mcDictionary(HT)`. It names a macro which is generated by + the `%mcDictionary()` macro. Provided name cannot be empty + or an underscore (`_`). No longer than *13* characters. + +2. `METHOD` - *Optional*, if empty (or DECLARE or DCL) then the code of + a macro dictionary is compiled. + If `DELETE` then the macro dictionary named by `H` and all + macrovariables named like "`&H._`" are deleted. + +* `DS=` - *Optional*, if NOT empty then the `&DS.` dataset is used to + populate dictionary with keys from variable `&K.` and data + from variable `&D.` Works only during declaration. + +* `K=` - *Optional*, if the `&DS.` is NOT empty then `&K.` holds a name of + a variable which keeps or an expression which generates keys values. + Default is `Key`. + +* `D=` - *Optional*, if the `&DS.` is NOT empty then `&D.` holds a name of + a variable which keeps or an expression which generates data values. + Default is `Data`. + +--- + +### THE CREATED MACRO `%&H.()`: #################################################### + +The created macro imitates behaviour of a dictionary. + +The basic syntax is the following, the `<...>` means optional parameters: +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%&H.( + METHOD + <,KEY=> + <,DATA=> +) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Arguments description**: + +1. `METHOD` - *Required*, indicate what behaviour should be executed. + Allowed values are: + - `ADD`, adds key and data portion to the macro dictionary, + *multiple data portions* are NOT available for one key. + - `FIND`, tests if given key exists in the macro dictionary + and, if yes, returns data value associated with the key. + For multiple data portions see the `data=` parameter. + - `CHECK`, returns indicator if the key exists in dictionary. + - `DEL`, removes key and data portion from the macro dictionary. + - `LIST`, prints out a dictionary to the log. + - `CLEAR` removes all data and keys values. + +* `KEY=` - *Optional*, provides key value for `ADD`, `FIND`, `CHECK` + and `DEL` methods. + Leading and trimming spaces are removed from the value. + The `MD5(...)` function is used to generate the hash. + Default value is `_`. + +* `DATA=` - *Optional*, provides data value for the `ADD` method. + Default value is blank. + + +When macro is executed and when data are added the following types of +*global* macrovariables are created: +- `&H._########_K`, +- `&H._########_V`, +- `&H._KEYSNUM`. + +The `#` represents value generated by the `MD5(...)` function for the given key. + +The first type keeps information about the key. + +The second type keeps information about the value of a given key + +The third type keeps the number of unique values of the key. + +See examples below to see use cases. + +--- + +### EXAMPLES AND USECASES: #################################################### + + +**EXAMPLE 1.** Basic use-case. + Creating macro dictionary, macro `Dict` is generated. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%mcDictionary(Dict) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Add elements to the `Dict`. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%Dict(ADD,key=x,data=17) +%Dict(ADD,key=y y,data=42) +%Dict(ADD,key=z z z,data=303) + +%put _user_; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Add some duplicates for the key x. + See macrovariables created. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%Dict(ADD,key=x,data=18) + +%put _user_; + +%Dict(ADD,key=x,data=19) + +%put _user_; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Check for the key `x` and non existing key `t`. +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%put ##%Dict(CHECK,key=x)##; +%put ##%Dict(CHECK,key=t)##; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Prints data values for various keys. + Key `t` does not exist in the macrodictionary. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%put #%Dict(FIND,key=x)#; +%put #%Dict(FIND,key=y y)#; +%put #%Dict(FIND,key=z z z)#; +%put #%Dict(FIND,key=t)#; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + List dictionary content to the log. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%Dict(LIST); +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Delete keys. + Key `t` does not exist in the macrodictionary. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%put #%Dict(DEL,key=z z z)#; +%put _user_; +%put #%Dict(DEL,key=t)#; +%put _user_; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Clear and delete macro dictionary `Dict`. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%Dict(CLEAR) +%put _user_; + +%mcDictionary(Dict,DELETE) +%put _user_; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 2A.** Populate macro dictionary from a dataset "by hand". + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%mcDictionary(CLASS) +%let t = %sysfunc(datetime()); +data _null_; + set sashelp.class; + call execute('%CLASS(ADD,key=' !! name !! ',data=' !! age !! ')'); +run; +%put t = %sysevalf(%sysfunc(datetime()) - &t.); +%put &=Class_KEYSNUM.; +%put _user_; +%CLASS(CLEAR) + + +%mcDictionary(CARS) +%let t = %sysfunc(datetime()); +data _null_; + set sashelp.cars(obs=42); + call execute('%CARS(ADD,key=' !! catx("|",make,model,type) !! ',data=' !! put(MPG_CITY*10,dollar10.2) !! ')'); +run; +%put t = %sysevalf(%sysfunc(datetime()) - &t.); +%put &=CARS_KEYSNUM.; +%CARS(LIST); + +%put %CARS(F,key=Audi|TT 3.2 coupe 2dr (convertible)|Sports); + +%CARS(CLEAR) +%put &=CARS_KEYSNUM.; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 2B.** Populate macro dictionary from a dataset "automatically". + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%let t = %sysfunc(datetime()); +%mcDictionary(CLASS,DCL,DS=sashelp.class,k=name,d=_N_) +%put t = %sysevalf(%sysfunc(datetime()) - &t.); +%put &=CLASS_KEYSNUM.; +%put _user_; +%CLASS(CLEAR) + + +%let t = %sysfunc(datetime()); +%mcDictionary(CARS,DCL,DS=sashelp.cars(obs=42),k=catx("|",make,model,type),d=put(MPG_CITY*10,dollar10.2)) +%put t = %sysevalf(%sysfunc(datetime()) - &t.); +%put &=CARS_KEYSNUM.; +%CARS(LIST); + +%put %CARS(F,key=Audi|TT 3.2 coupe 2dr (convertible)|Sports); + +%CARS(CLEAR) +%put &=CARS_KEYSNUM.; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 3.** Data portion may require quoting and un-quoting. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%mcDictionary(CODE) +%CODE(CLEAR) +%CODE(ADD,key=data, data=%str(data test; x = 42; run;)) +%CODE(ADD,key=proc, data=%str(proc print; run;)) +%CODE(ADD,key=macro,data=%nrstr(%put *1*2*3*4*;)) + +%CODE(FIND,key=data) +%CODE(FIND,key=proc) +%unquote(%CODE(FIND,key=macro)) + +%CODE(LIST); + +%mcDictionary(CODE,DELETE) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 4.** Longer lists. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%let size = 1000; + +%mcDictionary(AAA) + +%let t = %sysfunc(datetime()); +data _null_; + do i = 1 to &size.; + call execute(cats('%AAA(ADD,key=A', i, ',data=', i, ')')); + end; +run; +%put t = %sysevalf(%sysfunc(datetime()) - &t.); +%put %AAA(F,key=A555) %AAA(CHECK,key=A555); +%put &=AAA_KEYSNUM; +%AAA(CLEAR) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 5.** Forbidden names. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%mcDictionary() +%mcDictionary(_) + +%mcDictionary(ABCDEFGHIJKLMN) %* bad; +%mcDictionary(ABCDEFGHIJKLM) %* good; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 6.** More fun with datasets. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + +data work.metadata; + input key :$16. data :$128.; +cards; +ID ABC-123-XYZ +path /path/to/study/data +cutoffDT 2023-01-01 +startDT 2020-01-01 +endDT 2024-12-31 +MedDRA v26.0 +; +run; +proc print; +run; + +%mcDictionary(Study,dcl,DS=work.metadata) + +%put _user_; + +%put *%Study(F,key=ID)**%Study(C,key=ID)*; + +title1 "Study %Study(F,key=ID) is located at %Study(F,key=path)"; +title2 "it starts %Study(F,key=startDT) and ends %Study(F,key=endDT)"; +footnote "MedDRA version: %Study(F,key=MedDRA)"; + +proc print data=sashelp.class(obs=7); +run; + +title; +footnote; + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + + +--- + +--- + +## `%mchashtable()` macro ###### + +The `%mcHashTable()` macro provided in the package +is designed to facilitate the idea of a "macro hash table" +concept, i.e. *a list of macrovariables with common prefix +and suffixes generated as a hash digest* which allows +to use values other than integers as indexes. + +The `%mcHashTable()` macro allows to generate other macros +which behaves like hash tables or dictionaries. See examples below. + +The `%mcHashTable()` macro executes like a pure macro code. + +### SYNTAX: ################################################################### + +The basic syntax is the following, the `<...>` means optional parameters: +~~~~~~~~~~~~~~~~~~~~~~~sas +%mcHashTable( + H + <,METHOD> + <,HASH=> +) +~~~~~~~~~~~~~~~~~~~~~~~ + +**Arguments description**: + +1. `H` - *Required*, a hash table macro name and a declaration/definition, + e.g. `mcHashTable(HT)`. It names a macro which is generated by + the `%mcHashTable()` macro. Provided name cannot be empty + or an underscore (`_`). No longer than *10* characters. + +2. `METHOD` - *Optional*, if empty (or DECLARE or DCL) then the code of + a macro hash table is compiled. + If `DELETE` then the macro hash table named by `H` and all + macrovariables named like "`&H._`" are deleted. + +* `HASH=` - *Optional*, indicates which hashing algorithms should be used, + available values are `CRC32` or `MD5`, the `CRC32` is the default. + +--- + +### THE CREATED MACRO `%&H.()`: #################################################### + +The created macro imitates behaviour of a hash table or a dictionary. +It is *not* dedicated for "long-ish" lists (above 1000 elements) since +the performance may be poor. + +The basic syntax is the following, the `<...>` means optional parameters: +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%&H.( + METHOD + <,KEY=> + <,DATA=> +) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Arguments description**: + +1. `METHOD` - *Required*, indicate what behaviour should be executed. + Allowed values are: + - `ADD`, adds key and data portion to the macro hash table, + *multiple data portions* are available for one key. + - `FIND`, tests if given key exists in the macro hash table + and, if yes, returns data value associated with the key. + For multiple data portions see the `data=` parameter. + - `DP` (data portion) or `CHECK`, returns the number of data + portions for a given key. + - `CLEAR` removes all data and keys values. + - `KEYIDX`, allows to get data by the key index rather than value. + - `KEYVAL`, returns key value for a given key index. + - `CHECKIDX`, returns the number of data portions for + a given key index. + +* `KEY=` - *Optional*, provides key value for `ADD`, `FIND`,`DP`, `CHECK` + `CHECKIDX`, `KEYIDX`, and `KEYVAL` methods. Leading and trimming + spaces are removed from the value. + The `hashing(CRC32,...)` function or the `MD5(...)` function is + used to generate the hash. + +* `DATA=` - *Optional*, provides data value for the `ADD` method and + for the`FIND` method provides data portion number to be + extracted. Default value is `1` (used by the `FIND` method). + + +When macro is executed and when data are added the following types of +*global* macrovariables are created: +- `&H._########`, +- `&H._########_Xk`, +- `&H._########_Xi`, +- `&H._########_Xi_j`, +- `&H._KEYNUM`, +- and `&H._KEY_i`. + +The `#` represents value generated by the `hashing(CRC32,...)` function +or the `MD5(...)` function for the given key. + +The first type keeps information about possible collision for the key. + +The second type keeps information about value of a given key, +the `X` keeps the track of other colliding keys. + +The third type keeps information about number of data portions +for given key, the `X` keeps the track of other colliding keys. + +The fourth type keeps the data portion, the `j` indicates data portion number. + +The fifth type keeps the number of unique values of the key. + +The sixth type keeps the list of unique values of the key, +the `i` indicates key number. + +See examples below to see use cases. + +--- + +### EXAMPLES AND USECASES: #################################################### + + +**EXAMPLE 1.** Basic use-case. + Creating macro hash table, macro `HT` is generated. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%mcHashTable(HT) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Add elements to the `HT`. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%HT(ADD,key=x,data=17) +%HT(ADD,key=y,data=42) +%HT(ADD,key=z,data=303) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Add some duplicates for the key x. + See macrovariables created. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%HT(ADD,key=x,data=18) +%HT(ADD,key=x,data=19) + +%put _user_; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Check the number od data portions in macrohash + for the key `x` and non existing key `t`. +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%put ##%HT(DP,key=x)##; +%put ##%HT(DP,key=t)##; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Check the number od data portions in macrohash + for the key index 1 and 4. +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%put ##%HT(CHECKIDX,key=1)##; +%put ##%HT(CHECKIDX,key=4)##; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Prints first data values for various keys. + Key `t` does not exist in the macrohash. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%put #%HT(FIND,key=x)#; +%put #%HT(FIND,key=y)#; +%put #%HT(FIND,key=z)#; +%put #%HT(FIND,key=t)#; + +%put #%HT(FIND,key=x,data=2)#; +%put #%HT(FIND,key=x,data=3)#; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Print first and subsequent data values + for a given KeyIDX. Index `4` does not exist. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%put #%HT(KEYIDX,key=1)#; +%put #%HT(KEYIDX,key=2)#; +%put #%HT(KEYIDX,key=3)#; +%put #%HT(KEYIDX,key=4)#; + +%put #%HT(KEYIDX,key=1,data=2)#; +%put #%HT(KEYIDX,key=1,data=3)#; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Print the key values for a given KeyIDX. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%put #%HT(KEYVAL,key=1)#; +%put #%HT(KEYVAL,key=2)#; +%put #%HT(KEYVAL,key=3)#; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Clear and delete macro hash table `HT`. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%HT(CLEAR) +%mcHashTable(HT,DELETE) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 2.** Combine `CHECK` and `FIND` methods + with macros `%array()` and `%do_over()` + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%mcHashTable(H) +%H(ADD,key=x,data=17) +%H(ADD,key=x,data=18) +%H(ADD,key=x,data=19) + +%array(A[%H(CHECK,key=x)]); + +%put %do_over(A, phrase=%nrstr( + %H(FIND,key=x,data=&_i_) +), between = %str(,)); + +%mcHashTable(H,delete) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 3.** Populate macro hash table from a dataset. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%mcHashTable(CLASS) +%let t = %sysfunc(datetime()); +data _null_; + set sashelp.class; + call execute('%CLASS(ADD,key=' !! name !! ',data=' !! age !! ')'); + call execute('%CLASS(ADD,key=' !! name !! ',data=' !! weight !! ')'); + call execute('%CLASS(ADD,key=' !! name !! ',data=' !! height !! ')'); +run; +%put t = %sysevalf(%sysfunc(datetime()) - &t.); +%put _user_; +%CLASS(CLEAR) + + +%mcHashTable(CARS) +%let t = %sysfunc(datetime()); +data _null_; + set sashelp.cars; + call execute('%CARS(ADD,key=' !! catx("|",make,model) !! ',data=' !! MPG_CITY !! ')'); +run; +%put t = %sysevalf(%sysfunc(datetime()) - &t.); +%* %put _user_; +%CARS(CLEAR) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 4.** Data portion may require quoting and un-quoting.. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%mcHashTable(CODE) +%CODE(CLEAR) +%CODE(ADD,key=data, data=%str(data test; x = 42; run;)) +%CODE(ADD,key=proc, data=%str(proc print; run;)) +%CODE(ADD,key=macro,data=%nrstr(%put *****;)) + +%CODE(FIND,key=data) +%CODE(FIND,key=proc) +%unquote(%CODE(FIND,key=macro)) + +%mcHashTable(CODE,DELETE) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 5.** Longer lists. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%let size = 1000; + +%mcHashTable(AAA) +%mcHashTable(BBB) +%mcHashTable(CCC) +%mcHashTable(DDD) + +%let t = %sysfunc(datetime()); +data _null_; + do i = 1 to &size.; + call execute(cats('%AAA(ADD,key=A', i, ',data=', i, ')')); + end; +run; +%put t = %sysevalf(%sysfunc(datetime()) - &t.); +%put &=AAA_KEYSNUM; +%AAA(CLEAR) + +%let t = %sysfunc(datetime()); +data _null_; + do i = 1 to &size.; + call execute(cats('%BBB(ADD,key=B', i, ',data=', i, ')')); + call execute(cats('%BBB(ADD,key=B', i, ',data=', i+1, ')')); + end; +run; +%put t = %sysevalf(%sysfunc(datetime()) - &t.); +%put &=BBB_KEYSNUM; +%BBB(CLEAR) + +%let t = %sysfunc(datetime()); +data _null_; + t= datetime(); + do i = 1 to &size.; + call execute(cats('%CCC(ADD,key=C', i, ',data=', i, ')')); + end; + t = datetime() - t; + put t=; + t= datetime(); + do i = 1 to &size.; + call execute(cats('%CCC(ADD,key=C', i, ',data=', i+1, ')')); + end; + t = datetime() - t; + put t=; +run; +%put t = %sysevalf(%sysfunc(datetime()) - &t.); + +%let t = %sysfunc(datetime()); +data test; + do i = 1 to &size.; + x = resolve(cats('%CCC(FIND,key=C', i, ',data=1)')); + y = resolve(cats('%CCC(FIND,key=C', i, ',data=2)')); + output; + end; +run; +%put t = %sysevalf(%sysfunc(datetime()) - &t.); +%put &=CCC_KEYSNUM; +%CCC(CLEAR) + +%let t = %sysfunc(datetime()); +data _null_; + do i = 1 to &size.; + call execute(cats('%DDD(ADD,key=D,data=', i, ')')); + end; +run; +%put t = %sysevalf(%sysfunc(datetime()) - &t.); +%put &=DDD_KEYSNUM; +%put %DDD(CHECK,key=D); +%DDD(CLEAR) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 6.** Forbidden names. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%mcHashTable() +%mcHashTable(_) + +%mcHashTable(ABCDEFGHIJK) %* bad; +%mcHashTable(ABCDEFGHIJ) %* good; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**EXAMPLE 7.** Hashing algorithms. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%mcHashTable(H1,DCL,HASH=MD5) +%mcHashTable(H2,DECLARE,HASH=CRC32) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +--- + +--- + +## `%qziparrays()` macro ###### + +The zipArrays() and QzipArrays() macros +allow to use a function on elements of pair of +macro arrays. + +For two macroarrays the corresponding +elements are taken and the macro applies a function, provided by user, +to calculate result of the function on taken elements. + +When one of the arrays is shorter then elements are, by default, +"reused" starting from the beginning. But this behaviour can be altered. +See examples for the details. + +By default newly created macroarray name is concatenation +of first 13 characters of names of arrays used to create the new one, +e.g. if arrays names are `abc` and `def` then the result name is `abcdef`, +if arrays names are `abcd1234567890` and `efgh1234567890` then the result +name is `abcd123456789efgh123456789` + +The `zipArrays()` returns unquoted value [by `%unquote()`]. +The `QzipArrays()` returns quoted value [by `%superq()`]. + +See examples below for the details. + +The `%QzipArrays()` macro executes like a pure macro code. + +### SYNTAX: ################################################################### + +The basic syntax is the following, the `<...>` means optional parameters: +~~~~~~~~~~~~~~~~~~~~~~~sas +%QzipArrays( + first + ,second + <,function=> + <,operator=> + <,argBf=> + <,argMd=> + <,argAf=> + <,format=> + <,result=> + <,macarray=> + <,reuse=> +) +~~~~~~~~~~~~~~~~~~~~~~~ + +**Arguments description**: + +1. `first` - *Required*, a space separated list of texts. + +2. `second` - *Required*, a space separated list of texts. + +* `function = cat` - *Optional*, default value is `cat`, + a function which will be applied + to corresponding pairs of elements of + the first and the second list. + +* `operator =` - *Optional*, default value is empty, + arithmetic infix operator used with elements + the first and the second list. The first + list is used on the left side of the operator + the second list is used on the right side + of the operator. + +* `argBf =` - *Optional*, default value is empty, + arguments of the function inserted + *before* elements the first list. + If multiple should be comma separated. + +* `argMd =` - *Optional*, default value is empty, + arguments of the function inserted + *between* elements the first list and + the second list. + If multiple should be comma separated. + +* `argAf =` - *Optional*, default value is empty, + arguments of the function inserted + *after* elements the second list. + If multiple should be comma separated. + +* `format=` - *Optional*, default value is empty, + indicates a format which should be used + to format the result, does not work when + the `operator=` is used. + +* `result=` - *Optional*, default value is empty, + indicates a name of newly created macroarray, + by default created macroarray name is concatenation + of first 13 characters of names of arrays used + to create the new one. + +* `macarray=N` - *Optional*, default value is `N`, + if set to `Y`/`YES` then a macro, named with + the array name, is compiled to create convenient + envelope for multiple ampersands, see the + `%array()` macro for details. + +* `reuse=Y` - *Optional*, default value is `Y`, + when one of the arrays is shorter then elements + are *reused* starting from the beginning. + If `CP` then function is executed on the *Cartesian + product* of arrays elements. Any other value will + cut the process with the end of the shorter array. + See examples for the details. + + +### EXAMPLES AND USECASES: #################################################### + +See examples in `%zipArrays()` help for the details. + +--- + +--- + +## `%sortmacroarray()` macro ###### + +The sortMacroArray() macro +allow to sort elements of a macro array. + +The **limitation** is that sorted values are limited to 32767 bytes of length. + +See examples below for the details. + +### SYNTAX: ################################################################### + +The basic syntax is the following, the `<...>` means optional parameters: +~~~~~~~~~~~~~~~~~~~~~~~sas +%sortMacroArray( + array + <,valLength=> + <,outSet=> + <,sortseq=> +) +~~~~~~~~~~~~~~~~~~~~~~~ + +**Arguments description**: + +1. `array` - *Required*, name of an array generated by the `%array()` macro. + +* `valLength = 32767` - *Optional*, default value is `32767`, + maximum length of a variable storing macrovariable data. + (the reason of 32767 limitation) + +* `outSet = _NULL_` - *Optional*, default value is `_NULL_`, + an optional output dataset name. + +* `sortseq =` - *Optional*, default value is `LINGUISTIC(NUMERIC_COLLATION = ON)`, + sorting options for use in an internal `Proc SORT`. + + +### EXAMPLES AND USECASES: #################################################### + + +**EXAMPLE 1.** Basic use-case. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + +options mprint; +ods html; +ods listing close; + + +%array(hij [4:9] $ 512 ("C33" "B22" "A11" "A01" "A02" "X42"), macarray=Y) + +%put NOTE: %do_over(hij); + +%sortMacroArray(hij, valLength=3, outSet = A_NULL_(compress=char)) + +%put NOTE: %do_over(hij); + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 2.** Basic use-case. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + +options mprint; +ods html; +ods listing close; + + +%array(ds = sashelp.class, vars = name|NNN height|h, macarray=Y) +%array(ds = sashelp.cars, vars = model|, macarray=Y) + +%put NOTE: %do_over(NNN); +%put NOTE: %do_over(H); +%put NOTE: %do_over(model); + +%sortMacroArray(NNN, valLength=30, outSet = A_NULL_(compress=char)) +%sortMacroArray(H, valLength=32) +%sortMacroArray(model, valLength=120) + +%put NOTE: %do_over(NNN); +%put NOTE: %do_over(H); +%put NOTE: %do_over(model); + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +--- + + +--- + +## `%ziparrays()` macro ###### + +The zipArrays() and QzipArrays() macros +allow to use a function on elements of pair of +macro arrays. + +For two macroarrays the corresponding +elements are taken and the macro applies a function, provided by user, +to calculate result of the function on taken elements. + +When one of the arrays is shorter then elements are, by default, +"reused" starting from the beginning. But this behaviour can be altered. +See examples for the details. + +By default newly created macroarray name is concatenation +of first 13 characters of names of arrays used to create the new one, +e.g. if arrays names are `abc` and `def` then the result name is `abcdef`, +if arrays names are `abcd1234567890` and `efgh1234567890` then the result +name is `abcd123456789efgh123456789` + +The `zipArrays()` returns unquoted value [by `%unquote()`]. +The `QzipArrays()` returns quoted value [by `%superq()`]. + +See examples below for the details. + +The `%zipArrays()` macro executes like a pure macro code. + +### SYNTAX: ################################################################### + +The basic syntax is the following, the `<...>` means optional parameters: +~~~~~~~~~~~~~~~~~~~~~~~sas +%zipArrays( + first + ,second + <,function=> + <,operator=> + <,argBf=> + <,argMd=> + <,argAf=> + <,format=> + <,result=> + <,macarray=> + <,reuse=> +) +~~~~~~~~~~~~~~~~~~~~~~~ + +**Arguments description**: + +1. `first` - *Required*, a space separated list of texts. + +2. `second` - *Required*, a space separated list of texts. + +* `function = cat` - *Optional*, default value is `cat`, + a function which will be applied + to corresponding pairs of elements of + the first and the second list. + +* `operator =` - *Optional*, default value is empty, + arithmetic infix operator used with elements + the first and the second list. The first + list is used on the left side of the operator + the second list is used on the right side + of the operator. + +* `argBf =` - *Optional*, default value is empty, + arguments of the function inserted + *before* elements the first list. + If multiple should be comma separated. + +* `argMd =` - *Optional*, default value is empty, + arguments of the function inserted + *between* elements the first list and + the second list. + If multiple should be comma separated. + +* `argAf =` - *Optional*, default value is empty, + arguments of the function inserted + *after* elements the second list. + If multiple should be comma separated. + +* `format=` - *Optional*, default value is empty, + indicates a format which should be used + to format the result, does not work when + the `operator=` is used. + +* `result=` - *Optional*, default value is empty, + indicates a name of newly created macroarray, + by default created macroarray name is concatenation + of first 13 characters of names of arrays used + to create the new one. + +* `macarray=N` - *Optional*, default value is `N`, + if set to `Y`/`YES` then a macro, named with + the array name, is compiled to create convenient + envelope for multiple ampersands, see the + `%array()` macro for details. + +* `reuse=Y` - *Optional*, default value is `Y`, + when one of the arrays is shorter then elements + are *reused* starting from the beginning. + If `CP` then function is executed on the *Cartesian + product* of arrays elements. Any other value will + cut the process with the end of the shorter array. + See examples for the details. + + +### EXAMPLES AND USECASES: #################################################### + +**EXAMPLE 1.** Simple concatenation of elements: +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%array(a[*] x1-x3 (1:3)) +%array(b[*] x1-x5 (11:15)) + +%put _user_; + +%zipArrays(a, b); +%put _user_; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 2.** Shorter list is "reused": +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%array(a[6] (1:6)) +%array(b[3] (10 20 30)) + +%zipArrays(a, b, result=A_and_B, macarray=Y); +%put %do_over(A_and_B); +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 3.** Use of the `operator=`: +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%array(c[0:4] (000 100 200 300 400)) +%array(d[2:16] (1002:1016)) + +%zipArrays(c, d, operator=+, result=C_plus_D, macarray=Y); +%put (%do_over(C_plus_D)); + +%put %C_plus_D(1); +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 4.** If one of array names is empty or an array does not exist: +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%array(a[6] (1:6)) +%array(b[3] (10 20 30)) + +%zipArrays(a, ); +%zipArrays(, b); + +%zipArrays(a, z); +%zipArrays(z, b); +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 5.** Use of the `function=`: +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%array(one[3] A B C, vnames=Y) +%array(two[5] p q r s t, vnames=Y) + +%zipArrays( + one +,two +,function = catx +,argBf = %str( ) +,format = $quote. +,macarray=Y +) +%put %do_over(onetwo); +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 6.** To reuse or not to reuse, or maybe Cartesian product: +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%array(e[3] (10 20 30)) +%array(f[2] (5:6)) + +%zipArrays(e, f, reuse=n, operator=+, macarray=Y, result=_noReuse); +%zipArrays(e, f, reuse=y, operator=+, macarray=Y, result=_yesReuse); +%zipArrays(e, f, reuse=cp, operator=+, macarray=Y, result=_cartProdReuse); + +%put %do_over(_noReuse); +%put %do_over(_yesReuse); +%put %do_over(_cartProdReuse); +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 7.** Use middle argument: +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%array(yr[3] (2018:2020)) +%array(mth[12] (1:12)) + +%zipArrays(mth, yr, argMd=5, function=MDY, format=date11., macarray=Y); +%put %do_over(mthyr); + +%zipArrays(mth, yr, argMd=5, function=MDY, format=date11., macarray=Y, reuse=cp); +%put %do_over(mthyr); +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +--- + +--- + + +--- + +# License ###### + +Copyright (c) Bartosz Jablonski, 2019 - 2026 + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +--- + diff --git a/hist/macroarray_1.3.0_.zip b/hist/macroarray_1.3.0_.zip new file mode 100644 index 0000000000000000000000000000000000000000..88d9e4781fd30104562d5aa8d1a380693c4ce97b GIT binary patch literal 56259 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 literal 0 HcmV?d00001 diff --git a/macroarray.md b/macroarray.md index 58b4192..c03acda 100644 --- a/macroarray.md +++ b/macroarray.md @@ -1,27 +1,36 @@ -- [The macroArray package](#macroarray) -- [Content description](#content-description) - * [`%appendArray()` macro](#appendarray-macro) - * [`%appendCell()` macro](#appendcell-macro) - * [`%array()` macro](#array-macro) - * [`%concatArrays()` macro](#concatarrays-macro) - * [`%deleteMacArray()` macro](#deletemacarray-macro) - * [`%do_over()` macro](#do-over-macro) - * [`%do_over2()` macro](#do-over2-macro) - * [`%do_over3()` macro](#do-over3-macro) - * [`%make_do_over()` macro](#make-do-over-macro) - * [`%mcHashTable()` macro](#mchashtable-macro) - * [`%mcDictionary()` macro](#mcdictionary-macro) - * [`%QzipArrays()` macro](#qziparrays-macro) - * [`%zipArrays()` macro](#ziparrays-macro) - * [`%sortMacroArray()` macro](#sortmacroarray-macro) +# Documentation for the `macroArray` package. + +---------------------------------------------------------------- + + *Macroarrays for macro codes* + +---------------------------------------------------------------- + +### Version information: + +- Package: macroArray +- Version: 1.3.0 +- Generated: 2026-01-13T14:47:32 +- Author(s): Bartosz Jablonski (yabwon@gmail.com) +- Maintainer(s): Bartosz Jablonski (yabwon@gmail.com) +- License: MIT +- File SHA256: `F*9B51F1B434742F08166F28DE40D64F16E9BC5ED8D1926AE7148A48116F7BDBA0` for this version +- Content SHA256: `C*BBE7D736D7DF66231C41EEE321E9FE8C50D174C6DC43AFC09F4990894A5E7CBD` for this version - * [License](#license) - --- + +# The `macroArray` package, version: `1.3.0`; + +--- + -# The macroArray package [ver. 1.2.6] ############################################### +The **macroArray** package implements a macroarray facility. -The **macroArray** package implements a macroarray facility: +The set of macros, which emulates classic +data-step-array functionality on the macro +programming level, is provided. + +Some of components are: - `%array()`, - `%do_over()`, - `%make_do_over()`, @@ -34,10 +43,6 @@ The **macroArray** package implements a macroarray facility: - `%mcDictionary()`, - etc. -The set of macros, which emulates classic -data-step-array functionality on the macro -programming level, is provided. - *Note:* If you are working with BIG macroarrays do not forget to verify your session setting for macro @@ -56,35 +61,51 @@ to verify the following options: --- -Package contains: - 1. macro appendarray - 2. macro appendcell - 3. macro array - 4. macro concatarrays - 5. macro deletemacarray - 6. macro do_over - 7. macro do_over2 - 8. macro do_over3 - 9. macro make_do_over - 10. macro mcdictionary - 11. macro mchashtable - 12. macro qziparrays - 13. macro sortmacroarray - 14. macro ziparrays - -Required SAS Components: - *Base SAS Software* - -*SAS package generated by generatePackage, version 20231123* - -The SHA256 hash digest for package macroArray: -`F*3F3893F1FCD78719543703E4353F4CC19811D247C016F220FF729B283C1AD790` - + --- -# Content description ############################################################################################ -## >>> `%appendArray()` macro: <<< ############ - + +--- + +Required SAS Components: + - Base SAS Software + +--- + + +--------------------------------------------------------------------- + +*SAS package generated by SAS Package Framework, version `20251231`,* +*under `WIN`(`X64_10PRO`) operating system,* +*using SAS release: `9.04.01M9P06042025`.* + +--------------------------------------------------------------------- + +# The `macroArray` package content +The `macroArray` package consists of the following content: + +1. [`%appendarray()` macro ](#appendarray-macro-1 ) +2. [`%appendcell()` macro ](#appendcell-macro-2 ) +3. [`%array()` macro ](#array-macro-3 ) +4. [`%concatarrays()` macro ](#concatarrays-macro-4 ) +5. [`%deletemacarray()` macro ](#deletemacarray-macro-5 ) +6. [`%do_over()` macro ](#doover-macro-6 ) +7. [`%do_over2()` macro ](#doover2-macro-7 ) +8. [`%do_over3()` macro ](#doover3-macro-8 ) +9. [`%make_do_over()` macro ](#makedoover-macro-9 ) +10. [`%mcdictionary()` macro ](#mcdictionary-macro-10 ) +11. [`%mchashtable()` macro ](#mchashtable-macro-11 ) +12. [`%qziparrays()` macro ](#qziparrays-macro-12 ) +13. [`%sortmacroarray()` macro ](#sortmacroarray-macro-13 ) +14. [`%ziparrays()` macro ](#ziparrays-macro-14 ) + + +15. [License note](#license) + +--- + +## `%appendarray()` macro ###### + The `%appendArray()` macro is a macrowrapper which allows to concatenate two macroarrays created by `%array()` macro. @@ -111,9 +132,7 @@ The basic syntax is the following, the `<...>` means optional parameters: 2. `second` - *Required*, a name of a macroarray created by the `%array()` macro. - - - + ### EXAMPLES AND USECASES: ###################################################### **EXAMPLE 1.** Append macroarrays LL and MM. @@ -146,10 +165,11 @@ The basic syntax is the following, the `<...>` means optional parameters: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ --- - + +--- + +## `%appendcell()` macro ###### -## >>> `%appendCell()` macro: <<< ############## - The `%appendCell()` macro allows to append a macrovariable to a macroarray created by the `%array()` macro. @@ -176,10 +196,8 @@ The basic syntax is the following, the `<...>` means optional parameters: 3. `hilo` - *Required*, if `H` macrovariable is appended at the end if `L` macrovariable is appended at the beginning -); - - + ### EXAMPLES AND USECASES: #################################################### **EXAMPLE 1.** Create two macro wrappers. @@ -235,10 +253,11 @@ The basic syntax is the following, the `<...>` means optional parameters: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ --- - - -## >>> `%array()` macro: <<< ####################### - + +--- + +## `%array()` macro ###### + The code of a macro was inspired by *Ted Clay's* and *David Katz's* macro `%array()`. @@ -351,8 +370,6 @@ The basic syntax is the following, the `<...>` means optional parameters: Value `1` is for apostrophes, value `2` is for double quotes. Ignored for `macarray=M`. - ---- ### EXAMPLES AND USECASES: #################################################### @@ -611,9 +628,11 @@ The basic syntax is the following, the `<...>` means optional parameters: --- - + +--- + +## `%concatarrays()` macro ###### -## >>> `%concatArrays()` macro: <<< ########### The `%concatArrays()` macro allows to concatenate two macroarrays created by the `%array()` macro. @@ -644,9 +663,7 @@ The basic syntax is the following, the `<...>` means optional parameters: * `removeSecond=Y` - *Optional*, default value `Y`, if set to `Y` then the second array is removed. - - - + ### EXAMPLES AND USECASES: #################################################### **EXAMPLE 1.** Concatenate macroarrays LL and MM. @@ -679,10 +696,11 @@ The basic syntax is the following, the `<...>` means optional parameters: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ --- - + +--- + +## `%deletemacarray()` macro ###### -## >>> `%deleteMacArray()` macro: <<< ####### - The `%deleteMacArray()` macro allows to delete macroarrays created by the `%array()` macro. @@ -702,15 +720,15 @@ The basic syntax is the following, the `<...>` means optional parameters: 1. `arrs` - *Required*, a space separated list of manes of macroarray created by the `%array()` macro. - + * `macarray=N` - *Optional*, indicator should a macro associated with macroarray to be deleted? If `Y` or `YES` then the associated macro is deleted. - - + +--- -## >>> `%do_over()` macro: <<< ###################### +## `%do_over()` macro ###### The code of the macro was inspired by *Ted Clay's* and *David Katz's* macro `%do_over()`. @@ -725,17 +743,22 @@ The `%do_over()` macro executes like a pure macro code. The basic syntax is the following, the `<...>` means optional parameters: ~~~~~~~~~~~~~~~~~~~~~~~sas %do_over( - array - <,phrase=%nrstr(%&array(&_I_.))> - <,between=%str( )> + arrays + <,phrase = %nrstr(%&array(&_I_.))> + <,between = %str( )> <,which = > + <,check = 0> + <,rephrase = > + <,trigger = ?> + <,unq = 1> ) ~~~~~~~~~~~~~~~~~~~~~~~ **Arguments description**: -1. `array` - *Required*, indicates a macroarray which metadata (Lbound, Hbouns) - are to be used to loop in the `%do_over()` +1. `arrays` - *Required*, a space-separated list of macroarrays names. + The first one identifies the macroarray which metadata + (Lbound, Hbouns, and N) are used to loop in the `%do_over()`. * `phrase=` - *Optional*, Default value `%nrstr(%&array(&_I_.))`, a statement to be called in each iteration @@ -750,7 +773,7 @@ The basic syntax is the following, the `<...>` means optional parameters: If macroquoted (e.g. `%str( + )`) then the `%unquote()` function is automatically applied. -* `which=` - *Optional*, a _SPACE_ separated list of indexes which +* `which=` - *Optional*, a space-separated list of indexes which should be used to iterate over selected macroarray. Possible special characters are `H` and `L` which means *high* and *low* bound of an array, list could be set with @@ -758,15 +781,58 @@ The basic syntax is the following, the `<...>` means optional parameters: if `by` is omitted the default is `1`. If possible use `1:5` rather `1 2 3 4 5` since the firs works faster. +* `check=` - *Optional*, indicates should a check for a macro corresponding + to a macroarray be executed. If the macro does not exist wraning + is issued and the `do_over` stops. + Default value `0` means: do not execute check. +* `rephrase=` - *Optional*, this parameter allows for an alternative aproach + in providing the phrase to be looped over. The idea is to make + writing the phrase string code more convenient and easy to grasp. + The value is a string containing triggers (symbols) that are + replaced by proper macroarray calls. For example, if a macroarray + `myArr` has 7 values form `varName1` to `varName7` and you want + to use them as arguments in code renaming variables, say + `rename old_varName1=new_varName1 ... ;`, instead typing phrase: + `rename %do_over(myArr,phrase=%nrstr(old_%myArr(&_I_.)=new_%myArr(&_I_.)));` + you can type much easier rephrase: + `rename %do_over(myArr,rephrase=old_?=new_?);`, + and all `?` will be replaced, under the hood, by calls to the macroarray. + For easier debuging the `do_over` macro prints the rephrased string + before and after chnge. + When the `do_over` loops with multiple array, say `myArrA`, `myArrB`, + and `myArrC`, then those arrays should be refered by `?1?`, `?2?`, + and `?3?` respectively. + See `trigger` parameter definition to learn more. + If both `phrase` and `rephrase` are used, the seconf takes precedence. +* `trigger=` - *Optional*, a single byte character (symbol) used for marking + macroarrays in the newly created phrase. + Default value is `?` symbol. + When one macroarray is used, only the symbol should be used in + `rephrase=` string. When multiple macroarrays are used then the + symbol should surroun a number identifying array, e.g. `?2?`. + See examples below for details. + +* `unq=` - *Optional*, indicates that the `%unquote()` macro function should + be added around every macroarray call. Because of SAS internal + behavior `unq=1` is needed for certain cases when plain 4GL code + is used in `rephrase=`. For example, let macro array `myArr()` + has 3 values: `A1`, `B2`, and `C3`. When the following code + is run: `%do_over(myArr, rephrase=data ?_test; run;)` without + `unq=1`, SAS will create 4 data sets: `A1`, `B2`, `C3`, + and `_test`, instead 3 data sets: `A1_test`, `B2_test`, and `C3_test`. + Default value `1` means: add the `%unquote()`. + See example below to learn more. + + ### EXAMPLES AND USECASES: #################################################### **EXAMPLE 1.** Simple looping. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas %array(beta[*] j k l m (101 102 103 104), vnames=Y, macarray=Y) - + %put #%do_over(beta)#; %put #%do_over(beta, phrase=%nrstr("%beta(&_I_.)"), between=%str(,))#; @@ -856,7 +922,6 @@ The basic syntax is the following, the `<...>` means optional parameters: %array(alpha[11] (5:15), macarray=Y) %let x = %do_over(alpha - , phrase = %NRSTR(%alpha(&_I_.)) , between= %str( + ) ); %put &=x.; @@ -887,12 +952,113 @@ The basic syntax is the following, the `<...>` means optional parameters: %put #%do_over(test, which= L:H h:l:-1 13 14, between=%str(,))#; ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 8.** Simpler multiple arrays looping with `rephrase=`. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(alpha[*] j k l m n o p, vnames=Y, macarray=Y) + %array( beta[&alphaN.], function = (2**_i_), macarray=Y) + %array(gamma[&alphaN.] (1:&alphaN.), macarray=Y) + + %put >>%do_over(alpha)<<; + %put >>%do_over(beta)<<; + %put >>%do_over(gamma)<<; + + data test8; + call streaminit(123); + + %do_over( alpha beta gamma + , rephrase = ?1? = ?2? + ?3? * rand('Uniform'); output; + , between = put _all_; + ) + put _all_; + run; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 9.** Simpler multiple arrays looping with `rephrase=`, cont. + Create multiple datasets. Array `alpha`, `beta`, and `gamma` are + from the privious example. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %do_over(alpha beta gamma + , rephrase = + data ?1?_2; + call streaminit(?2?); + ?1?X = ?2? + ?3? * rand('Uniform'); + output; + run; + ) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 10.** Simpler multiple arrays looping with `rephrase=`, cont. + Create multiple datasets using a macro. Array `alpha`, `beta`, + and `gamma` are from the privious example. + The `%nrstr()` is required to mask call to the `%doit2()` macro. + Default `?` is replaced with `@`. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %macro doit2(ds, var=a, val1=1, val2=2); + data &ds._3; + call streaminit(&val1.); + &var. = &val1. + &val2. * rand('Uniform'); + output; + run; + %mend doit2; + + %do_over( alpha beta gamma + , rephrase = %nrstr(%doit2(@1@, var = @1@, val1 = @2@, val2 = @3@)) + , trigger = @ + ) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 11.** Simpler multiple arrays looping with `rephrase=`, cont. + Why the `unq=` is needed. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(myArr[3] $ ("A1" "B2" "C3"), macarray=Y) + + %do_over(myArr, rephrase=data ?_testUNQ1; run;, unq=1) + + %do_over(myArr, rephrase=data ?_testUNQ0; run;, unq=0) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + + +**EXAMPLE 12.** Simpler multiple arrays looping with `rephrase=`, cont. + Renaming variables is easy now. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + %array(V[*] a b c d e f g h, vnames=1, macarray=1) + + data test12; + array x{*} %do_over(V) (1:&VN.); + run; + + proc datasets nolist noprint lib=work; + modify test12; + rename + %do_over(V,rephrase = $=new_$,trigger=$) + ; + run; + quit; + + data _null_; + set test12; + put _ALL_; + run; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +--- + --- - - -## >>> `%do_over2()` macro: <<< #################### - +## `%do_over2()` macro ###### + The code of the macro was inspired by *Ted Clay's* and *David Katz's* macro `%do_over()`. @@ -935,9 +1101,7 @@ The basic syntax is the following, the `<...>` means optional parameters: If macroquoted (e.g. `%str( + )`) then the `%unquote()` function is automatically applied. - - - + ### EXAMPLES AND USECASES: #################################################### **EXAMPLE 1.** Looping over two arrays. @@ -981,11 +1145,11 @@ The basic syntax is the following, the `<...>` means optional parameters: %put %sysevalf(&x.); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ --- - - + +--- + +## `%do_over3()` macro ###### -## >>> `%do_over3()` macro: <<< #################### - The code of the macro was inspired by *Ted Clay's* and *David Katz's* macro `%do_over()`. @@ -1032,9 +1196,7 @@ The basic syntax is the following, the `<...>` means optional parameters: If macroquoted (e.g. `%str( + )`) then the `%unquote()` function is automatically applied. - - - + ### EXAMPLES AND USECASES: #################################################### **EXAMPLE 1.** Looping over 3 macroarrays. @@ -1059,11 +1221,11 @@ The basic syntax is the following, the `<...>` means optional parameters: ) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ --- - - + +--- + +## `%make_do_over()` macro ###### -## >>> `%make_do_over()` macro: <<< ########### - The code of the macro was inspired by *Ted Clay's* and *David Katz's* macro `%do_over()`. @@ -1086,9 +1248,7 @@ The basic syntax is the following, the `<...>` means optional parameters: 1. `size` - *Required*, indicates the number of dimensions (i.e. inner loops) of the `%DO_OVER()` macro. - - - + ### EXAMPLES AND USECASES: #################################################### **EXAMPLE 1.** Code of created "4-loop" `%DO_OVER4()` macro @@ -1181,9 +1341,342 @@ The basic syntax is the following, the `<...>` means optional parameters: ); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ --- + +--- + +## `%mcdictionary()` macro ###### + +The `%mcDictionary()` macro provided in the package +is designed to facilitate the idea of a "macro dictionary" +concept, i.e. *a list of macrovariables with common prefix +and suffixes generated as a hash digest* which allows +to use values other than integers as indexes. -## >>> `%mcHashTable()` macro: <<< ####################### +The `%mcDictionary()` macro allows to generate other macros +which behaves like a dictionary. See examples below. +The `%mcDictionary()` macro executes like a pure macro code. + +### SYNTAX: ################################################################### + +The basic syntax is the following, the `<...>` means optional parameters: +~~~~~~~~~~~~~~~~~~~~~~~sas +%mcDictionary( + H + <,METHOD> + <,DS=> + <,K=Key> + <,D=Data> +) +~~~~~~~~~~~~~~~~~~~~~~~ + +**Arguments description**: + +1. `H` - *Required*, a dictionary macro name and a declaration/definition, + e.g. `mcDictionary(HT)`. It names a macro which is generated by + the `%mcDictionary()` macro. Provided name cannot be empty + or an underscore (`_`). No longer than *13* characters. + +2. `METHOD` - *Optional*, if empty (or DECLARE or DCL) then the code of + a macro dictionary is compiled. + If `DELETE` then the macro dictionary named by `H` and all + macrovariables named like "`&H._`" are deleted. + +* `DS=` - *Optional*, if NOT empty then the `&DS.` dataset is used to + populate dictionary with keys from variable `&K.` and data + from variable `&D.` Works only during declaration. + +* `K=` - *Optional*, if the `&DS.` is NOT empty then `&K.` holds a name of + a variable which keeps or an expression which generates keys values. + Default is `Key`. + +* `D=` - *Optional*, if the `&DS.` is NOT empty then `&D.` holds a name of + a variable which keeps or an expression which generates data values. + Default is `Data`. + +--- + +### THE CREATED MACRO `%&H.()`: #################################################### + +The created macro imitates behaviour of a dictionary. + +The basic syntax is the following, the `<...>` means optional parameters: +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%&H.( + METHOD + <,KEY=> + <,DATA=> +) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Arguments description**: + +1. `METHOD` - *Required*, indicate what behaviour should be executed. + Allowed values are: + - `ADD`, adds key and data portion to the macro dictionary, + *multiple data portions* are NOT available for one key. + - `FIND`, tests if given key exists in the macro dictionary + and, if yes, returns data value associated with the key. + For multiple data portions see the `data=` parameter. + - `CHECK`, returns indicator if the key exists in dictionary. + - `DEL`, removes key and data portion from the macro dictionary. + - `LIST`, prints out a dictionary to the log. + - `CLEAR` removes all data and keys values. + +* `KEY=` - *Optional*, provides key value for `ADD`, `FIND`, `CHECK` + and `DEL` methods. + Leading and trimming spaces are removed from the value. + The `MD5(...)` function is used to generate the hash. + Default value is `_`. + +* `DATA=` - *Optional*, provides data value for the `ADD` method. + Default value is blank. + + +When macro is executed and when data are added the following types of +*global* macrovariables are created: +- `&H._########_K`, +- `&H._########_V`, +- `&H._KEYSNUM`. + +The `#` represents value generated by the `MD5(...)` function for the given key. + +The first type keeps information about the key. + +The second type keeps information about the value of a given key + +The third type keeps the number of unique values of the key. + +See examples below to see use cases. + +--- + +### EXAMPLES AND USECASES: #################################################### + + +**EXAMPLE 1.** Basic use-case. + Creating macro dictionary, macro `Dict` is generated. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%mcDictionary(Dict) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Add elements to the `Dict`. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%Dict(ADD,key=x,data=17) +%Dict(ADD,key=y y,data=42) +%Dict(ADD,key=z z z,data=303) + +%put _user_; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Add some duplicates for the key x. + See macrovariables created. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%Dict(ADD,key=x,data=18) + +%put _user_; + +%Dict(ADD,key=x,data=19) + +%put _user_; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Check for the key `x` and non existing key `t`. +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%put ##%Dict(CHECK,key=x)##; +%put ##%Dict(CHECK,key=t)##; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Prints data values for various keys. + Key `t` does not exist in the macrodictionary. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%put #%Dict(FIND,key=x)#; +%put #%Dict(FIND,key=y y)#; +%put #%Dict(FIND,key=z z z)#; +%put #%Dict(FIND,key=t)#; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + List dictionary content to the log. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%Dict(LIST); +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Delete keys. + Key `t` does not exist in the macrodictionary. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%put #%Dict(DEL,key=z z z)#; +%put _user_; +%put #%Dict(DEL,key=t)#; +%put _user_; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Clear and delete macro dictionary `Dict`. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%Dict(CLEAR) +%put _user_; + +%mcDictionary(Dict,DELETE) +%put _user_; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 2A.** Populate macro dictionary from a dataset "by hand". + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%mcDictionary(CLASS) +%let t = %sysfunc(datetime()); +data _null_; + set sashelp.class; + call execute('%CLASS(ADD,key=' !! name !! ',data=' !! age !! ')'); +run; +%put t = %sysevalf(%sysfunc(datetime()) - &t.); +%put &=Class_KEYSNUM.; +%put _user_; +%CLASS(CLEAR) + + +%mcDictionary(CARS) +%let t = %sysfunc(datetime()); +data _null_; + set sashelp.cars(obs=42); + call execute('%CARS(ADD,key=' !! catx("|",make,model,type) !! ',data=' !! put(MPG_CITY*10,dollar10.2) !! ')'); +run; +%put t = %sysevalf(%sysfunc(datetime()) - &t.); +%put &=CARS_KEYSNUM.; +%CARS(LIST); + +%put %CARS(F,key=Audi|TT 3.2 coupe 2dr (convertible)|Sports); + +%CARS(CLEAR) +%put &=CARS_KEYSNUM.; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 2B.** Populate macro dictionary from a dataset "automatically". + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%let t = %sysfunc(datetime()); +%mcDictionary(CLASS,DCL,DS=sashelp.class,k=name,d=_N_) +%put t = %sysevalf(%sysfunc(datetime()) - &t.); +%put &=CLASS_KEYSNUM.; +%put _user_; +%CLASS(CLEAR) + + +%let t = %sysfunc(datetime()); +%mcDictionary(CARS,DCL,DS=sashelp.cars(obs=42),k=catx("|",make,model,type),d=put(MPG_CITY*10,dollar10.2)) +%put t = %sysevalf(%sysfunc(datetime()) - &t.); +%put &=CARS_KEYSNUM.; +%CARS(LIST); + +%put %CARS(F,key=Audi|TT 3.2 coupe 2dr (convertible)|Sports); + +%CARS(CLEAR) +%put &=CARS_KEYSNUM.; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 3.** Data portion may require quoting and un-quoting. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%mcDictionary(CODE) +%CODE(CLEAR) +%CODE(ADD,key=data, data=%str(data test; x = 42; run;)) +%CODE(ADD,key=proc, data=%str(proc print; run;)) +%CODE(ADD,key=macro,data=%nrstr(%put *1*2*3*4*;)) + +%CODE(FIND,key=data) +%CODE(FIND,key=proc) +%unquote(%CODE(FIND,key=macro)) + +%CODE(LIST); + +%mcDictionary(CODE,DELETE) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 4.** Longer lists. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%let size = 1000; + +%mcDictionary(AAA) + +%let t = %sysfunc(datetime()); +data _null_; + do i = 1 to &size.; + call execute(cats('%AAA(ADD,key=A', i, ',data=', i, ')')); + end; +run; +%put t = %sysevalf(%sysfunc(datetime()) - &t.); +%put %AAA(F,key=A555) %AAA(CHECK,key=A555); +%put &=AAA_KEYSNUM; +%AAA(CLEAR) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 5.** Forbidden names. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas +%mcDictionary() +%mcDictionary(_) + +%mcDictionary(ABCDEFGHIJKLMN) %* bad; +%mcDictionary(ABCDEFGHIJKLM) %* good; +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 6.** More fun with datasets. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + +data work.metadata; + input key :$16. data :$128.; +cards; +ID ABC-123-XYZ +path /path/to/study/data +cutoffDT 2023-01-01 +startDT 2020-01-01 +endDT 2024-12-31 +MedDRA v26.0 +; +run; +proc print; +run; + +%mcDictionary(Study,dcl,DS=work.metadata) + +%put _user_; + +%put *%Study(F,key=ID)**%Study(C,key=ID)*; + +title1 "Study %Study(F,key=ID) is located at %Study(F,key=path)"; +title2 "it starts %Study(F,key=startDT) and ends %Study(F,key=endDT)"; +footnote "MedDRA version: %Study(F,key=MedDRA)"; + +proc print data=sashelp.class(obs=7); +run; + +title; +footnote; + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + + +--- + +--- + +## `%mchashtable()` macro ###### + The `%mcHashTable()` macro provided in the package is designed to facilitate the idea of a "macro hash table" concept, i.e. *a list of macrovariables with common prefix @@ -1296,7 +1789,7 @@ the `i` indicates key number. See examples below to see use cases. --- - + ### EXAMPLES AND USECASES: #################################################### @@ -1524,8 +2017,8 @@ run; %mcHashTable() %mcHashTable(_) -%mcHashTable(ABCDEFGHIJKLMNOPQ) %* bad; -%mcHashTable(ABCDEFGHIJKLMNOP) %* good; +%mcHashTable(ABCDEFGHIJK) %* bad; +%mcHashTable(ABCDEFGHIJ) %* good; ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ **EXAMPLE 7.** Hashing algorithms. @@ -1536,339 +2029,14 @@ run; ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ --- - -## >>> `%mcDictionary()` macro: <<< ####################### - -The `%mcDictionary()` macro provided in the package -is designed to facilitate the idea of a "macro dictionary" -concept, i.e. *a list of macrovariables with common prefix -and suffixes generated as a hash digest* which allows -to use values other than integers as indexes. - -The `%mcDictionary()` macro allows to generate other macros -which behaves like a dictionary. See examples below. - -The `%mcDictionary()` macro executes like a pure macro code. - -### SYNTAX: ################################################################### - -The basic syntax is the following, the `<...>` means optional parameters: -~~~~~~~~~~~~~~~~~~~~~~~sas -%mcDictionary( - H - <,METHOD> - <,DS=> - <,K=Key> - <,D=Data> -) -~~~~~~~~~~~~~~~~~~~~~~~ - -**Arguments description**: - -1. `H` - *Required*, a dictionary macro name and a declaration/definition, - e.g. `mcDictionary(HT)`. It names a macro which is generated by - the `%mcDictionary()` macro. Provided name cannot be empty - or an underscore (`_`). No longer than *13* characters. - -2. `METHOD` - *Optional*, if empty (or DECLARE or DCL) then the code of - a macro dictionary is compiled. - If `DELETE` then the macro dictionary named by `H` and all - macrovariables named like "`&H._`" are deleted. - -* `DS=` - *Optional*, if NOT empty then the `&DS.` dataset is used to - populate dictionary with keys from variable `&K.` and data - from variable `&D.` Works only during declaration. - -* `K=` - *Optional*, if the `&DS.` is NOT empty then `&K.` holds a name of - a variable which keeps or an expression which generates keys values. - Default is `Key`. - -* `D=` - *Optional*, if the `&DS.` is NOT empty then `&D.` holds a name of - a variable which keeps or an expression which generates data values. - Default is `Data`. - ---- - -### THE CREATED MACRO `%&H.()`: #################################################### - -The created macro imitates behaviour of a dictionary. - -The basic syntax is the following, the `<...>` means optional parameters: -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas -%&H.( - METHOD - <,KEY=> - <,DATA=> -) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Arguments description**: - -1. `METHOD` - *Required*, indicate what behaviour should be executed. - Allowed values are: - - `ADD`, adds key and data portion to the macro dictionary, - *multiple data portions* are NOT available for one key. - - `FIND`, tests if given key exists in the macro dictionary - and, if yes, returns data value associated with the key. - For multiple data portions see the `data=` parameter. - - `CHECK`, returns indicator if the key exists in dictionary. - - `DEL`, removes key and data portion from the macro dictionary. - - `LIST`, prints out a dictionary to the log. - - `CLEAR` removes all data and keys values. - -* `KEY=` - *Optional*, provides key value for `ADD`, `FIND`, `CHECK` - and `DEL` methods. - Leading and trimming spaces are removed from the value. - The `MD5(...)` function is used to generate the hash. - Default value is `_`. - -* `DATA=` - *Optional*, provides data value for the `ADD` method. - Default value is blank. - - -When macro is executed and when data are added the following types of -*global* macrovariables are created: -- `&H._########_K`, -- `&H._########_V`, -- `&H._KEYSNUM`. - -The `#` represents value generated by the `MD5(...)` function for the given key. - -The first type keeps information about the key. - -The second type keeps information about the value of a given key - -The third type keeps the number of unique values of the key. - -See examples below to see use cases. - ---- - -### EXAMPLES AND USECASES: #################################################### - - -**EXAMPLE 1.** Basic use-case. - Creating macro dictionary, macro `Dict` is generated. - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas -%mcDictionary(Dict) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - Add elements to the `Dict`. - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas -%Dict(ADD,key=x,data=17) -%Dict(ADD,key=y y,data=42) -%Dict(ADD,key=z z z,data=303) - -%put _user_; -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - Add some duplicates for the key x. - See macrovariables created. - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas -%Dict(ADD,key=x,data=18) - -%put _user_; - -%Dict(ADD,key=x,data=19) - -%put _user_; -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - Check for the key `x` and non existing key `t`. -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas -%put ##%Dict(CHECK,key=x)##; -%put ##%Dict(CHECK,key=t)##; -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - Prints data values for various keys. - Key `t` does not exist in the macrodictionary. - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas -%put #%Dict(FIND,key=x)#; -%put #%Dict(FIND,key=y y)#; -%put #%Dict(FIND,key=z z z)#; -%put #%Dict(FIND,key=t)#; -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - List dictionary content to the log. -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas -%Dict(LIST); -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - Delete keys. - Key `t` does not exist in the macrodictionary. - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas -%put #%Dict(DEL,key=z z z)#; -%put _user_; -%put #%Dict(DEL,key=t)#; -%put _user_; -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - Clear and delete macro dictionary `Dict`. - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas -%Dict(CLEAR) -%put _user_; - -%mcDictionary(Dict,DELETE) -%put _user_; -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - -**EXAMPLE 2A.** Populate macro dictionary from a dataset "by hand". - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas -%mcDictionary(CLASS) -%let t = %sysfunc(datetime()); -data _null_; - set sashelp.class; - call execute('%CLASS(ADD,key=' !! name !! ',data=' !! age !! ')'); -run; -%put t = %sysevalf(%sysfunc(datetime()) - &t.); -%put &=Class_KEYSNUM.; -%put _user_; -%CLASS(CLEAR) - - -%mcDictionary(CARS) -%let t = %sysfunc(datetime()); -data _null_; - set sashelp.cars(obs=42); - call execute('%CARS(ADD,key=' !! catx("|",make,model,type) !! ',data=' !! put(MPG_CITY*10,dollar10.2) !! ')'); -run; -%put t = %sysevalf(%sysfunc(datetime()) - &t.); -%put &=CARS_KEYSNUM.; -%CARS(LIST); - -%put %CARS(F,key=Audi|TT 3.2 coupe 2dr (convertible)|Sports); - -%CARS(CLEAR) -%put &=CARS_KEYSNUM.; -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - -**EXAMPLE 2B.** Populate macro dictionary from a dataset "automatically". - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas -%let t = %sysfunc(datetime()); -%mcDictionary(CLASS,DCL,DS=sashelp.class,k=name,d=_N_) -%put t = %sysevalf(%sysfunc(datetime()) - &t.); -%put &=CLASS_KEYSNUM.; -%put _user_; -%CLASS(CLEAR) - - -%let t = %sysfunc(datetime()); -%mcDictionary(CARS,DCL,DS=sashelp.cars(obs=42),k=catx("|",make,model,type),d=put(MPG_CITY*10,dollar10.2)) -%put t = %sysevalf(%sysfunc(datetime()) - &t.); -%put &=CARS_KEYSNUM.; -%CARS(LIST); - -%put %CARS(F,key=Audi|TT 3.2 coupe 2dr (convertible)|Sports); - -%CARS(CLEAR) -%put &=CARS_KEYSNUM.; -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - -**EXAMPLE 3.** Data portion may require quoting and un-quoting. - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas -%mcDictionary(CODE) -%CODE(CLEAR) -%CODE(ADD,key=data, data=%str(data test; x = 42; run;)) -%CODE(ADD,key=proc, data=%str(proc print; run;)) -%CODE(ADD,key=macro,data=%nrstr(%put *1*2*3*4*;)) - -%CODE(FIND,key=data) -%CODE(FIND,key=proc) -%unquote(%CODE(FIND,key=macro)) - -%CODE(LIST); - -%mcDictionary(CODE,DELETE) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - -**EXAMPLE 4.** Longer lists. - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas -%let size = 1000; - -%mcDictionary(AAA) - -%let t = %sysfunc(datetime()); -data _null_; - do i = 1 to &size.; - call execute(cats('%AAA(ADD,key=A', i, ',data=', i, ')')); - end; -run; -%put t = %sysevalf(%sysfunc(datetime()) - &t.); -%put %AAA(F,key=A555) %AAA(CHECK,key=A555); -%put &=AAA_KEYSNUM; -%AAA(CLEAR) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - -**EXAMPLE 5.** Forbidden names. - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas -%mcDictionary() -%mcDictionary(_) - -%mcDictionary(ABCDEFGHIJKLMNOPQ) %* bad; -%mcDictionary(ABCDEFGHIJKLMNOP) %* good; -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - -**EXAMPLE 6.** More fun with datasets. - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas - -data work.metadata; - input key :$16. data :$128.; -cards; -ID ABC-123-XYZ -path /path/to/study/data -cutoffDT 2023-01-01 -startDT 2020-01-01 -endDT 2024-12-31 -MedDRA v26.0 -; -run; -proc print; -run; - -%mcDictionary(Study,dcl,DS=work.metadata) - -%put _user_; - -%put *%Study(F,key=ID)**%Study(C,key=ID)*; - -title1 "Study %Study(F,key=ID) is located at %Study(F,key=path)"; -title2 "it starts %Study(F,key=startDT) and ends %Study(F,key=endDT)"; -footnote "MedDRA version: %Study(F,key=MedDRA)"; - -proc print data=sashelp.class(obs=7); -run; - -title; -footnote; - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - --- - -## >>> `%QzipArrays()` macro: <<< ####################### - + +## `%qziparrays()` macro ###### + The zipArrays() and QzipArrays() macros allow to use a function on elements of pair of -macroarrays. +macro arrays. For two macroarrays the corresponding elements are taken and the macro applies a function, provided by user, @@ -1969,17 +2137,110 @@ The basic syntax is the following, the `<...>` means optional parameters: cut the process with the end of the shorter array. See examples for the details. + ### EXAMPLES AND USECASES: #################################################### See examples in `%zipArrays()` help for the details. --- + +--- + +## `%sortmacroarray()` macro ###### -## >>> `%zipArrays()` macro: <<< ####################### +The sortMacroArray() macro +allow to sort elements of a macro array. +The **limitation** is that sorted values are limited to 32767 bytes of length. + +See examples below for the details. + +### SYNTAX: ################################################################### + +The basic syntax is the following, the `<...>` means optional parameters: +~~~~~~~~~~~~~~~~~~~~~~~sas +%sortMacroArray( + array + <,valLength=> + <,outSet=> + <,sortseq=> +) +~~~~~~~~~~~~~~~~~~~~~~~ + +**Arguments description**: + +1. `array` - *Required*, name of an array generated by the `%array()` macro. + +* `valLength = 32767` - *Optional*, default value is `32767`, + maximum length of a variable storing macrovariable data. + (the reason of 32767 limitation) + +* `outSet = _NULL_` - *Optional*, default value is `_NULL_`, + an optional output dataset name. + +* `sortseq =` - *Optional*, default value is `LINGUISTIC(NUMERIC_COLLATION = ON)`, + sorting options for use in an internal `Proc SORT`. + + +### EXAMPLES AND USECASES: #################################################### + + +**EXAMPLE 1.** Basic use-case. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + +options mprint; +ods html; +ods listing close; + + +%array(hij [4:9] $ 512 ("C33" "B22" "A11" "A01" "A02" "X42"), macarray=Y) + +%put NOTE: %do_over(hij); + +%sortMacroArray(hij, valLength=3, outSet = A_NULL_(compress=char)) + +%put NOTE: %do_over(hij); + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +**EXAMPLE 2.** Basic use-case. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas + +options mprint; +ods html; +ods listing close; + + +%array(ds = sashelp.class, vars = name|NNN height|h, macarray=Y) +%array(ds = sashelp.cars, vars = model|, macarray=Y) + +%put NOTE: %do_over(NNN); +%put NOTE: %do_over(H); +%put NOTE: %do_over(model); + +%sortMacroArray(NNN, valLength=30, outSet = A_NULL_(compress=char)) +%sortMacroArray(H, valLength=32) +%sortMacroArray(model, valLength=120) + +%put NOTE: %do_over(NNN); +%put NOTE: %do_over(H); +%put NOTE: %do_over(model); + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +--- + + +--- + +## `%ziparrays()` macro ###### + The zipArrays() and QzipArrays() macros allow to use a function on elements of pair of -macroarrays. +macro arrays. For two macroarrays the corresponding elements are taken and the macro applies a function, provided by user, @@ -2080,6 +2341,7 @@ The basic syntax is the following, the `<...>` means optional parameters: cut the process with the end of the shorter array. See examples for the details. + ### EXAMPLES AND USECASES: #################################################### **EXAMPLE 1.** Simple concatenation of elements: @@ -2174,96 +2436,15 @@ The basic syntax is the following, the `<...>` means optional parameters: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ --- - -## >>> `%sortMacroArray()` macro: <<< ####################### - -The sortMacroArray() macro -allow to sort elements of a macroarray. - -The **limitation** is that sorted values are limited to 32767 bytes of length. - -See examples below for the details. - -### SYNTAX: ################################################################### - -The basic syntax is the following, the `<...>` means optional parameters: -~~~~~~~~~~~~~~~~~~~~~~~sas -%sortMacroArray( - array - <,valLength=> - <,outSet=> - <,sortseq=> -) -~~~~~~~~~~~~~~~~~~~~~~~ - -**Arguments description**: - -1. `array` - *Required*, name of an array generated by the `%array()` macro. - -* `valLength = 32767` - *Optional*, default value is `32767`, - maximum length of a variable storing macrovariable data. - (the reason of 32767 limitation) - -* `outSet = _NULL_` - *Optional*, default value is `_NULL_`, - an optional output dataset name. - -* `sortseq =` - *Optional*, default value is `LINGUISTIC(NUMERIC_COLLATION = ON)`, - sorting options for use in an internal `Proc SORT`. - -### EXAMPLES AND USECASES: #################################################### - - -**EXAMPLE 1.** Basic use-case. - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas - -options mprint; -ods html; -ods listing close; - - -%array(hij [4:9] $ 512 ("C33" "B22" "A11" "A01" "A02" "X42"), macarray=Y) - -%put NOTE: %do_over(hij); - -%sortMacroArray(hij, valLength=3, outSet = A_NULL_(compress=char)) - -%put NOTE: %do_over(hij); - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - -**EXAMPLE 2.** Basic use-case. - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas - -options mprint; -ods html; -ods listing close; - - -%array(ds = sashelp.class, vars = name|NNN height|h, macarray=Y) -%array(ds = sashelp.cars, vars = model|, macarray=Y) - -%put NOTE: %do_over(NNN); -%put NOTE: %do_over(H); -%put NOTE: %do_over(model); - -%sortMacroArray(NNN, valLength=30, outSet = A_NULL_(compress=char)) -%sortMacroArray(H, valLength=32) -%sortMacroArray(model, valLength=120) - -%put NOTE: %do_over(NNN); -%put NOTE: %do_over(H); -%put NOTE: %do_over(model); - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - + --- - -## License #################################################################### - -Copyright (c) Bartosz Jablonski, since January 2019 + + +--- + +# License ###### + +Copyright (c) Bartosz Jablonski, 2019 - 2026 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal @@ -2282,5 +2463,6 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. - + --- + diff --git a/macroarray.zip b/macroarray.zip index c42bf1c8ae42b81882faf91b11b1d9af2fc98297..88d9e4781fd30104562d5aa8d1a380693c4ce97b 100644 GIT binary patch literal 56259 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 literal 53447 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