source: Dev/trunk/src/client/dojo/regexp.js @ 531

define(["./_base/kernel", "./_base/lang"], function(dojo, lang){

// module:
//              dojo/regexp

var regexp = {
        // summary:
        //              Regular expressions and Builder resources
};
lang.setObject("dojo.regexp", regexp);

regexp.escapeString = function(/*String*/str, /*String?*/except){
        // summary:
        //              Adds escape sequences for special characters in regular expressions
        // except:
        //              a String with special characters to be left unescaped

        return str.replace(/([\.$?*|{}\(\)\[\]\\\/\+^])/g, function(ch){
                if(except && except.indexOf(ch) != -1){
                        return ch;
                }
                return "\\" + ch;
        }); // String
};

regexp.buildGroupRE = function(/*Object|Array*/arr, /*Function*/re, /*Boolean?*/nonCapture){
        // summary:
        //              Builds a regular expression that groups subexpressions
        // description:
        //              A utility function used by some of the RE generators. The
        //              subexpressions are constructed by the function, re, in the second
        //              parameter.  re builds one subexpression for each elem in the array
        //              a, in the first parameter. Returns a string for a regular
        //              expression that groups all the subexpressions.
        // arr:
        //              A single value or an array of values.
        // re:
        //              A function. Takes one parameter and converts it to a regular
        //              expression.
        // nonCapture:
        //              If true, uses non-capturing match, otherwise matches are retained
        //              by regular expression. Defaults to false

        // case 1: a is a single value.
        if(!(arr instanceof Array)){
                return re(arr); // String
        }

        // case 2: a is an array
        var b = [];
        for(var i = 0; i < arr.length; i++){
                // convert each elem to a RE
                b.push(re(arr[i]));
        }

         // join the REs as alternatives in a RE group.
        return regexp.group(b.join("|"), nonCapture); // String
};

regexp.group = function(/*String*/expression, /*Boolean?*/nonCapture){
        // summary:
        //              adds group match to expression
        // nonCapture:
        //              If true, uses non-capturing match, otherwise matches are retained
        //              by regular expression.
        return "(" + (nonCapture ? "?:":"") + expression + ")"; // String
};

return regexp;
});