DiffString | SuperCollider 3.13.0 Help

Description

A wrapper for the unix diff command line program.

NOTE: Sometimes, the commandline program fails for unknown reasons. DiffString throws an error before it calls any function then.

Class Methods

.new

Arguments:

insertFunc	Specify what to do when a new element is inserted in the result. As arguments are passed: newToken, index, oldToken.d = DiffString(insertFunc: { \|new\| "Please say hello to: %\n".postf(new) }); d.value("abc"); d.value("bcd");
removeFunc	Specify what to do when an element is removed. As arguments are passed: oldToken, index.d = DiffString(removeFunc: { \|new\| "Please say good bye to: %\n".postf(new) }); d.value("abc"); d.value("bcd");
swapFunc	Specify what to do when an element is replaced by a new one. As arguments are passed: newToken, index, oldToken.d = DiffString(swapFunc: { \|new, i, old\| "Hello, I used to be %, but now I am %.\n".postf(old, new) }); d.value("abc"); d.value("apc");
keepFunc	Specify what to do when an element is kept as it was. As arguments are passed: oldToken, index.d = DiffString(keepFunc: { \|old, i\| "% says: 'I am still here, at index %'\n".postf(old, i); }); d.value("abc"); d.value("xxxabc");
beginFunc	Specify what to do before the string is compared. As arguments are passed: oldToken, index.( var new; d = DiffString(beginFunc: { new = List.new }, insertFunc: { \|x\| new.add(x) }, returnFunc: { new }); ) d.("abc"); d.("abcxyz");
returnFunc	Specify what to return from `diff.value` As arguments are passed the result of the functions for each line as an array.
testFunc	A global test functions that is called before calling any of the above (apart from beginFunc and returnFunc). As arguments are passed: index, operator, oldToken, newToken.

Instance Methods

.parse

Compare two arrays of tokens. A token can be a String or anything that can be converted to a string consistently (e.g. Char, Symbol, Integer, but also an Array of these).

Arguments:

newTokens, oldTokens

Examples

(
var index = 0;
var prevChar = "...";

~list= Array.new;

d = DiffString(
    insertFunc: { |char, i|
        ("adding % after %:\n").postf(char, prevChar);
        prevChar = char;
        ~list= ~list.insert(index, char);
        index = index + 1;
    },
    removeFunc: { |char, i|
        ("removing" + char).postln;
        ~list.removeAt(index);
    },
    swapFunc: { |char, i, oldChar|
        ("swapping % with %:\n").postf(oldChar, char);
        prevChar = char;
        ~list.put(index, char);
        index = index + 1;
    },
    keepFunc: { |char, i|
        ("keeping" + char).postln;
        prevChar = char;
        index = index + 1;
    },
    beginFunc:{ index = 0 },
    returnFunc: { ~list }
);
);

d.value("hello word");
d.value("hello world");
d.value("hello");

// or make a separate routine:
(
r = Routine { |inval|
    var prev, outval;
    loop {
        inval = inval.as(Array);
        outval = d.parse(inval, prev);
        prev = inval;
        inval = outval.yield
    }
};
);

r.next("hello");
r.next("hello world");
r.next("hello word");

helpfile source: HelpSource/Classes/DiffString.schelp
link::Steno/Classes/DiffString::

DiffStringExtension

Description

Class Methods

.new

Arguments:

Instance Methods

.parse

Arguments:

Examples

DiffString
Extension