Leonid Volnitsky

SCC is C++ snippets evaluator at shell prompt

  • Repo: httpx://github.com/lvv/scc[GitHub], httpx://bitbucket.org/lvv/scc[BitBucket]

  • License: httpx://en.wikipedia.org/wiki/Boost_Software_License[Boost Software License]


At bash prompt - expression evaluated and printed:

scc 2+2

If expression is not terminated with semicolon, it is sent to std::cout. If snippet have bash special characters, it must be in single or double quotes. If expression starts with minus, end-of-options indicator -- must be used:

scc '"hello world"'
hello world

scc -- -42

scc "bitset<8>('a')"

scc 'double x=0.5;  sin(x)'

echo "ABC"  |  scc 'char c;  while (cin>>c)  cout << tolower(c);'

If double semicolon ;; is present, then what come before it is goes before main (into the file scope):

scc 'int f(int i) {return  i+i;} ;;  f(10)'

Snippet is evaluated in environment where most of C++ Standard Library includes are included and most STD entities are imported into default namespace with using std::...;

If you need only plain C++ REPL, that is about all you need to know. You can skip to install section now. SCC optional modules are described below.

Shortcuts and predeclared vars

Shortcuts are typedefs and macros to cut verbosity for REPL 1-liner environment.

str     -->   std::string
vint    -->   std::vector<int>
vfloat  -->   std::vector<float>
lint    -->   std::list<int>
dint    -->   std::deque<int>
WRL     -->   while(read_line())

Some variables are pre-defined. You don’t need to remember these. Predefined variables are defined in external to snippet scope, so you can re-define these to what ever you want.

  • i, j, k, n, m — long, initialized to 0

  • x, y, z —  double, initialized to 0

  • s, w — std::string

  • c — char

  • p — char*

RO Module

Range Operators (headers only library) was recently split off SCC. It can be useful if you use STL containers, strings and want simpler replacement for std::cout.

Some examples of what it can do:

//  Can print ranges, container, tuples, etc directly (vint is vector<int>) :
scc 'vint V{1,2,3};  V'

//  Assign 42 to 2..5
scc 'vint V=range(0,9);   range(V/2, V/5) = 42;  V'
{0, 1, 42, 42, 42, 5, 6, 7, 8, 9}

//  Find (brute force algorithm) maximum of  `cos(x)` in interval: `8 < x < 9`:
scc 'range(8, 9, 0.01) * cos  || max'

//  Integrate sin(x) from 0 to pi.  Object 'plus_' is shortcut for std::plus<T>()
scc 'auto d=0.001;  (range(0,pi,d) * sin || plus_) * d'

//  Concatenate vector of strings
scc 'vstr V{"aaa", "bb", "cccc"};  V || plus_'

//  Total length of strings in vector of strings
scc 'vstr V{"aaa", "bb", "cccc"};  V * size ||  plus_'

//  Assign to c-string, then append `"XYZ"` and then remove `"bc"` substring :
scc 'char s[99];  range(s) = "abc";  (range(s) << "XYZ") - "bc"'

//  Remove non alpha-num characters and convert to upper case
scc '(range("abc-123, xyz/") | isalnum) * toupper'

// Hide phone number:
scc "str S=\"John Q Public  (650)1234567\";  S|isdigit='X';  S"
John Q Public  (XXX)XXXXXXX

Requires: C++11 compiler. Oldest tested compilers: GCC-4.7.2, GCC-4.8, CLANG-3.2

In order to use it, you need to install it, and tell SCC where to look for its include files if it is installed in directory which is not searched by default by compiler.

Options -s / -S can enable/disable this module. Set environment variable scc_RO (to any value) enables it.

If enabled its print operator will be used instead of std::cout to print last statement-expression.

AWK Module

This is module that is bundled with SCC. It can be disabled if for example your compiler can not compile it for some reason. Options -a / -A enable/disable it. Set environment variable scc_AWK (to any value) enables it.

AWK module allows stream processing - similar to real AWK.

Syntax is not exactly AWK’s, it is still C++ , but it is quite similar.

Biggest difference is script layout. AWK’s script have following elements (simplified):

awk 'BEGIN{begin-expr};  {per-record-expr};  END{end-expr}'

SCC have two alternatives for above. First is explicit while-loop:

scc 'begin-expr;  WRL  per-record-expr;   end-expr;'

Shortcut WRL expands to while(read_line()). Function read_line(), reads input line and splits it into fields.

Second alternative is to use options -n and -p. With -n, record is read, split into fields and snippet is evaluated for every record. With -p, additionally all fields are printed after snippet was evaluated. These are equivalent to PERL’s and are convenient when we do not have begin-expr and end-expr.

scc -n 'per-record-expr;'

Fortunately, GCC and CLANG allows use of $ in identifiers, so AWK’s dollar variables ($0, $1, $NF) are valid in SCC.

In SCC, line’s fields are of special string type fld, it is similar to std::string but it can be used in arithmetic expressions - they can be implicitly converted to corresponding numeric type. And it can be assigned a numeric value. That is fld behave like AWK’s vars. Numeric types are any of int, float, etc.

fld   f("1");
int     i;

i = f;          // 1
i = f+1;        // 2
f = 2;          // "2"
f + " m/s"      // "2 m/s"
f + 5           // "7"

SCC supports following AWK’s global variables:

  • $ - derived from std::deque<fld> — line’s fields

  • NF - long, number of fields (set after read_line())

  • NR - long, number of records read so far (set after read_line())

  • OFS - strr, output field separator (another special type - string reference).

  • FS - strr, input field separator.

  • ORS - strr, output record separator

  • RS - strr, input record separator.

  • FILENAME - const char[], current filename being processed

More examples. Sum-up DF(1) used-disk-space column. In AWK and SCC:

df | awk '{n+=$3};  END{print n}'

df | scc 'WRL n+=$3;  n'

We can also replace column number with symbolic name (from df output header):

df | scc -H 'WRL n+=$("Used");  n'

Prepend line number to every line.

echo -e 'aaa\nbbb'   |   scc -p NR
1 aaa
2 bbb

For every line: first NR is printed (notice that there is no semicolon), then $0.

Now lets make comma separated fields out of colon separated. Option -o sets OFS (output field separator), -F - set FS Snippet is empty in this example.

echo 1:2:3 | scc -F: -o, -p

Or equivalent:

echo 1:2:3 | FS=: OFS=, scc -p

OpenCV Module

Provides complete OpenCV environment. SCC with OpenCV module provides similar functionaly to ImageMagick. Off by default. Turn on with --cv o --oc options. Or set environmental vaiable I.

Reads leng.png, and displays it:

scc --cv 'Mat I(imread("lena.png"));  imshow("",I);  waitKey();'

Same but using global enviromental varibale I:

scc --cv 'imshow("",I);  waitKey();'

Same but instead of global, we will use temporary (with scc lifetime) env variable:

unset I    // now global I is not set
I=lean.png   scc --cv  'imshow("",I);  waitKey();'

Same with using SCC’s show() function:

I=lean.png   scc --cv  'show(I);'

Environmental variale I and --cv options enable earch other. If only one is set, second will be set automaticly. When I is set, we don’t need to set --cv too. If --cv is pesent but I is unset, SCC reads lena.png into I. (TODO: frome what dir?)

Convert to TIFF:

scc --cv 'imwrite("lena.tif",I)'

Resize, make x2 times smaller:

scc --cv 'cv::resize(I,I,Size{},0.5,0.5); imwrite("small.png",I);'

Add noise:

scc --cv 'asI(R);  randn(R,0,50);  show(I+R);'

Shortcut asI declares a cv::Mat with the same type and size as I.

Edge detector:

scc --cv 'Mat E; cv::Canny(I,E,10000,35000, 7);  show(E);'


git clone http://github.com/lvv/scc scc
cd scc
echo "PATH+=:$PWD/scc/" >> ~/.profile
. ~/.profile
scc '"SCC is installed"'

With no or empty config, all optional modules will be disabled, and default compiler will be GCC.

There is scc/example_config which you can copy (and edit) into one of: /etc/scc, ~/.scc or .scc.

GCC Pre-compiled headers

For GCC you can enable precompiled headers, which will allow slightly (20%) faster compile. This is not recommended if you are going to update SCC or GCC. Command scc -make-gch will create directory .gch with precompiled headers:

cd path-to-scc-home
scc --make-gch
ls -l .gch

You need re-generate pre-compiled headers if SCC or GCC install was modified. To disable pre-compiled headers, run rm -rf gch.


Parser which extracts last C++ statement from snippet is semi-broken. It sometimes incorrectly parse (to extract last expression) multi-line scripts or expressions with "{}". See u-sed file for details. As workaround terminate every line with semicolon (even comment-line) and do not use print-if-not-terminated-with-semicolon feature.

Regex in RS/FS are currently not supported (but were in v0.1)

AWK module should be fixed to handle white space exactly like AWK.


  • httpx://en.wikipedia.org/wiki/Delimiter[Delimiter]

  • httpx://en.wikipedia.org/wiki/Comma-separated_values[CSV]

  • httpx://home.vrweb.de/~juergen.kahrs/gawk/XML/[XMLgawk]

  • httpx://en.wikipedia.org/wiki/Awk[Awk]

  • httpx://people.cs.uu.nl/piet/docs/nawk/nawk_23.html[Awk: Specifying how Fields are Separated]

  • httpx://gcc.gnu.org/onlinedocs/libstdc/manual/status.html#status.iso.200x[LIBSTDC status C++11]

  • httpx://www.informit.com/guides/content.aspx?g=cplusplus&seqNum=286[Why I Hate Namespaces]

  • httpx://www.gotw.ca/publications/mill17.htm[Why Not Specialize Function Templates?]

  • httpx://richardminerich.com/2012/07/functional-programming-is-dead-long-live-expression-oriented-programming/[Functional Programming is Dead, Long Live Expression-Oriented Programming]