GZ/nwyj/.svn/pristine/95/95cf0a09937e6fca0316fe9e1af31bcd0dbb9673.svn-base

if (!dojo._hasResource["dojox.validate.regexp"]) { // _hasResource checks added
													// by build. Do not use
													// _hasResource directly in
													// your code.
	dojo._hasResource["dojox.validate.regexp"] = true;
	dojo.provide("dojox.validate.regexp");

	dojo.require("dojo.regexp");

	// *** Regular Expression Generator does not entirely live here ***
	// FIXME: is this useful enough to be in /dojox/regexp/_base.js, or
	// should it respect namespace and be dojox.validate.regexp?
	// some say a generic regexp to match zipcodes and urls would be useful
	// others would say it's a spare tire.
	dojox.regexp = {
		ca : {},
		us : {}
	};

	dojox.regexp.tld = function(/* Object? */flags) {
		// summary: Builds a RE that matches a top-level domain
		//
		// flags:
		// flags.allowCC Include 2 letter country code domains. Default is true.
		// flags.allowGeneric Include the generic domains. Default is true.
		// flags.allowInfra Include infrastructure domains. Default is true.

		// assign default values to missing paramters
		flags = (typeof flags == "object") ? flags : {};
		if (typeof flags.allowCC != "boolean") {
			flags.allowCC = true;
		}
		if (typeof flags.allowInfra != "boolean") {
			flags.allowInfra = true;
		}
		if (typeof flags.allowGeneric != "boolean") {
			flags.allowGeneric = true;
		}

		// Infrastructure top-level domain - only one at present
		var infraRE = "arpa";

		// Generic top-level domains RE.
		var genericRE = "aero|biz|com|coop|edu|gov|info|int|mil|museum|name|net|org|pro|travel|xxx|jobs|mobi|post";

		// Country Code top-level domains RE
		var ccRE = "ac|ad|ae|af|ag|ai|al|am|an|ao|aq|ar|as|at|au|aw|az|ba|bb|bd|be|bf|bg|bh|bi|bj|bm|bn|bo|br|"
				+ "bs|bt|bv|bw|by|bz|ca|cc|cd|cf|cg|ch|ci|ck|cl|cm|cn|co|cr|cu|cv|cx|cy|cz|de|dj|dk|dm|do|dz|"
				+ "ec|ee|eg|er|eu|es|et|fi|fj|fk|fm|fo|fr|ga|gd|ge|gf|gg|gh|gi|gl|gm|gn|gp|gq|gr|gs|gt|gu|gw|"
				+ "gy|hk|hm|hn|hr|ht|hu|id|ie|il|im|in|io|ir|is|it|je|jm|jo|jp|ke|kg|kh|ki|km|kn|kr|kw|ky|kz|"
				+ "la|lb|lc|li|lk|lr|ls|lt|lu|lv|ly|ma|mc|md|mg|mh|mk|ml|mm|mn|mo|mp|mq|mr|ms|mt|mu|mv|mw|mx|"
				+ "my|mz|na|nc|ne|nf|ng|ni|nl|no|np|nr|nu|nz|om|pa|pe|pf|pg|ph|pk|pl|pm|pn|pr|ps|pt|pw|py|qa|"
				+ "re|ro|ru|rw|sa|sb|sc|sd|se|sg|sh|si|sk|sl|sm|sn|sr|st|su|sv|sy|sz|tc|td|tf|tg|th|tj|tk|tm|"
				+ "tn|to|tr|tt|tv|tw|tz|ua|ug|uk|us|uy|uz|va|vc|ve|vg|vi|vn|vu|wf|ws|ye|yt|yu|za|zm|zw";

		// Build top-level domain RE
		var a = [];
		if (flags.allowInfra) {
			a.push(infraRE);
		}
		if (flags.allowGeneric) {
			a.push(genericRE);
		}
		if (flags.allowCC) {
			a.push(ccRE);
		}

		var tldRE = "";
		if (a.length > 0) {
			tldRE = "(" + a.join("|") + ")";
		}

		return tldRE; // String
	}

	dojox.regexp.ipAddress = function(/* Object? */flags) {
		// summary: Builds a RE that matches an IP Address
		//
		// description:
		// Supports 5 formats for IPv4: dotted decimal, dotted hex, dotted
		// octal, decimal and hexadecimal.
		// Supports 2 formats for Ipv6.
		//
		// flags An object. All flags are boolean with default = true.
		// flags.allowDottedDecimal Example, 207.142.131.235. No zero padding.
		// flags.allowDottedHex Example, 0x18.0x11.0x9b.0x28. Case insensitive.
		// Zero padding allowed.
		// flags.allowDottedOctal Example, 0030.0021.0233.0050. Zero padding
		// allowed.
		// flags.allowDecimal Example, 3482223595. A decimal number between
		// 0-4294967295.
		// flags.allowHex Example, 0xCF8E83EB. Hexadecimal number between
		// 0x0-0xFFFFFFFF.
		// Case insensitive. Zero padding allowed.
		// flags.allowIPv6 IPv6 address written as eight groups of four
		// hexadecimal digits.
		// FIXME: ipv6 can be written multiple ways IIRC
		// flags.allowHybrid IPv6 address written as six groups of four
		// hexadecimal digits
		// followed by the usual 4 dotted decimal digit notation of IPv4.
		// x:x:x:x:x:x:d.d.d.d

		// assign default values to missing paramters
		flags = (typeof flags == "object") ? flags : {};
		if (typeof flags.allowDottedDecimal != "boolean") {
			flags.allowDottedDecimal = true;
		}
		if (typeof flags.allowDottedHex != "boolean") {
			flags.allowDottedHex = true;
		}
		if (typeof flags.allowDottedOctal != "boolean") {
			flags.allowDottedOctal = true;
		}
		if (typeof flags.allowDecimal != "boolean") {
			flags.allowDecimal = true;
		}
		if (typeof flags.allowHex != "boolean") {
			flags.allowHex = true;
		}
		if (typeof flags.allowIPv6 != "boolean") {
			flags.allowIPv6 = true;
		}
		if (typeof flags.allowHybrid != "boolean") {
			flags.allowHybrid = true;
		}

		// decimal-dotted IP address RE.
		var dottedDecimalRE =
		// Each number is between 0-255. Zero padding is not allowed.
		"((\\d|[1-9]\\d|1\\d\\d|2[0-4]\\d|25[0-5])\\.){3}(\\d|[1-9]\\d|1\\d\\d|2[0-4]\\d|25[0-5])";

		// dotted hex IP address RE. Each number is between 0x0-0xff. Zero
		// padding is allowed, e.g. 0x00.
		var dottedHexRE = "(0[xX]0*[\\da-fA-F]?[\\da-fA-F]\\.){3}0[xX]0*[\\da-fA-F]?[\\da-fA-F]";

		// dotted octal IP address RE. Each number is between 0000-0377.
		// Zero padding is allowed, but each number must have at least 4
		// characters.
		var dottedOctalRE = "(0+[0-3][0-7][0-7]\\.){3}0+[0-3][0-7][0-7]";

		// decimal IP address RE. A decimal number between 0-4294967295.
		var decimalRE = "(0|[1-9]\\d{0,8}|[1-3]\\d{9}|4[01]\\d{8}|42[0-8]\\d{7}|429[0-3]\\d{6}|"
				+ "4294[0-8]\\d{5}|42949[0-5]\\d{4}|429496[0-6]\\d{3}|4294967[01]\\d{2}|42949672[0-8]\\d|429496729[0-5])";

		// hexadecimal IP address RE.
		// A hexadecimal number between 0x0-0xFFFFFFFF. Case insensitive. Zero
		// padding is allowed.
		var hexRE = "0[xX]0*[\\da-fA-F]{1,8}";

		// IPv6 address RE.
		// The format is written as eight groups of four hexadecimal digits,
		// x:x:x:x:x:x:x:x,
		// where x is between 0000-ffff. Zero padding is optional. Case
		// insensitive.
		var ipv6RE = "([\\da-fA-F]{1,4}\\:){7}[\\da-fA-F]{1,4}";

		// IPv6/IPv4 Hybrid address RE.
		// The format is written as six groups of four hexadecimal digits,
		// followed by the 4 dotted decimal IPv4 format. x:x:x:x:x:x:d.d.d.d
		var hybridRE = "([\\da-fA-F]{1,4}\\:){6}"
				+ "((\\d|[1-9]\\d|1\\d\\d|2[0-4]\\d|25[0-5])\\.){3}(\\d|[1-9]\\d|1\\d\\d|2[0-4]\\d|25[0-5])";

		// Build IP Address RE
		var a = [];
		if (flags.allowDottedDecimal) {
			a.push(dottedDecimalRE);
		}
		if (flags.allowDottedHex) {
			a.push(dottedHexRE);
		}
		if (flags.allowDottedOctal) {
			a.push(dottedOctalRE);
		}
		if (flags.allowDecimal) {
			a.push(decimalRE);
		}
		if (flags.allowHex) {
			a.push(hexRE);
		}
		if (flags.allowIPv6) {
			a.push(ipv6RE);
		}
		if (flags.allowHybrid) {
			a.push(hybridRE);
		}

		var ipAddressRE = "";
		if (a.length > 0) {
			ipAddressRE = "(" + a.join("|") + ")";
		}
		return ipAddressRE; // String
	}

	dojox.regexp.host = function(/* Object? */flags) {
		// summary: Builds a RE that matches a host
		// description: A host is a domain name or an IP address, possibly
		// followed by a port number.
		// flags: An object.
		// flags.allowIP Allow an IP address for hostname. Default is true.
		// flags.allowLocal Allow the host to be "localhost". Default is false.
		// flags.allowPort Allow a port number to be present. Default is true.
		// flags in regexp.ipAddress can be applied.
		// flags in regexp.tld can be applied.

		// assign default values to missing paramters
		flags = (typeof flags == "object") ? flags : {};
		if (typeof flags.allowIP != "boolean") {
			flags.allowIP = true;
		}
		if (typeof flags.allowLocal != "boolean") {
			flags.allowLocal = false;
		}
		if (typeof flags.allowPort != "boolean") {
			flags.allowPort = true;
		}

		// Domain names can not end with a dash.
		var domainNameRE = "([0-9a-zA-Z]([-0-9a-zA-Z]{0,61}[0-9a-zA-Z])?\\.)+"
				+ dojox.regexp.tld(flags);

		// port number RE
		var portRE = (flags.allowPort) ? "(\\:" + dojox.regexp.integer({
					signed : false
				}) + ")?" : "";

		// build host RE
		var hostNameRE = domainNameRE;
		if (flags.allowIP) {
			hostNameRE += "|" + dojox.regexp.ipAddress(flags);
		}
		if (flags.allowLocal) {
			hostNameRE += "|localhost";
		}

		return "(" + hostNameRE + ")" + portRE; // String
	}

	dojox.regexp.url = function(/* Object? */flags) {
		// summary: Builds a regular expression that matches a URL
		//
		// flags: An object
		// flags.scheme Can be true, false, or [true, false].
		// This means: required, not allowed, or match either one.
		// flags in regexp.host can be applied.
		// flags in regexp.ipAddress can be applied.
		// flags in regexp.tld can be applied.

		// assign default values to missing paramters
		flags = (typeof flags == "object") ? flags : {};
		if (typeof flags.scheme == "undefined") {
			flags.scheme = [true, false];
		}

		// Scheme RE
		var protocolRE = dojo.regexp.buildGroupRE(flags.scheme, function(q) {
					if (q) {
						return "(https?|ftps?)\\://";
					}
					return "";
				});

		// Path and query and anchor RE
		var pathRE = "(/([^?#\\s/]+/)*)?([^?#\\s/]+(\\?[^?#\\s/]*)?(#[A-Za-z][\\w.:-]*)?)?";

		return protocolRE + dojox.regexp.host(flags) + pathRE;
	}

	dojox.regexp.emailAddress = function(/* Object? */flags) {

		// summary: Builds a regular expression that matches an email address
		//
		// flags: An object
		// flags.allowCruft Allow address like <mailto:foo@yahoo.com>. Default
		// is false.
		// flags in regexp.host can be applied.
		// flags in regexp.ipAddress can be applied.
		// flags in regexp.tld can be applied.

		// assign default values to missing paramters
		flags = (typeof flags == "object") ? flags : {};
		if (typeof flags.allowCruft != "boolean") {
			flags.allowCruft = false;
		}
		flags.allowPort = false; // invalid in email addresses

		// user name RE - apostrophes are valid if there's not 2 in a row
		var usernameRE = "([\\da-zA-Z]+[-._+&'])*[\\da-zA-Z]+";

		// build emailAddress RE
		var emailAddressRE = usernameRE + "@" + dojox.regexp.host(flags);

		// Allow email addresses with cruft
		if (flags.allowCruft) {
			emailAddressRE = "<?(mailto\\:)?" + emailAddressRE + ">?";
		}

		return emailAddressRE; // String
	}

	dojox.regexp.emailAddressList = function(/* Object? */flags) {
		// summary: Builds a regular expression that matches a list of email
		// addresses.
		//
		// flags: An object.
		// flags.listSeparator The character used to separate email addresses.
		// Default is ";", ",", "\n" or " ".
		// flags in regexp.emailAddress can be applied.
		// flags in regexp.host can be applied.
		// flags in regexp.ipAddress can be applied.
		// flags in regexp.tld can be applied.

		// assign default values to missing paramters
		flags = (typeof flags == "object") ? flags : {};
		if (typeof flags.listSeparator != "string") {
			flags.listSeparator = "\\s;,";
		}

		// build a RE for an Email Address List
		var emailAddressRE = dojox.regexp.emailAddress(flags);
		var emailAddressListRE = "(" + emailAddressRE + "\\s*["
				+ flags.listSeparator + "]\\s*)*" + emailAddressRE + "\\s*["
				+ flags.listSeparator + "]?\\s*";

		return emailAddressListRE; // String
	}

	dojox.regexp.us.state = function(/* Object? */flags) {
		// summary: A regular expression to match US state and territory
		// abbreviations
		//
		// flags An object.
		// flags.allowTerritories Allow Guam, Puerto Rico, etc. Default is true.
		// flags.allowMilitary Allow military 'states', e.g. Armed Forces Europe
		// (AE). Default is true.

		// assign default values to missing paramters
		flags = (typeof flags == "object") ? flags : {};
		if (typeof flags.allowTerritories != "boolean") {
			flags.allowTerritories = true;
		}
		if (typeof flags.allowMilitary != "boolean") {
			flags.allowMilitary = true;
		}

		// state RE
		var statesRE = "AL|AK|AZ|AR|CA|CO|CT|DE|DC|FL|GA|HI|ID|IL|IN|IA|KS|KY|LA|ME|MD|MA|MI|MN|MS|MO|MT|"
				+ "NE|NV|NH|NJ|NM|NY|NC|ND|OH|OK|OR|PA|RI|SC|SD|TN|TX|UT|VT|VA|WA|WV|WI|WY";

		// territories RE
		var territoriesRE = "AS|FM|GU|MH|MP|PW|PR|VI";

		// military states RE
		var militaryRE = "AA|AE|AP";

		// Build states and territories RE
		if (flags.allowTerritories) {
			statesRE += "|" + territoriesRE;
		}
		if (flags.allowMilitary) {
			statesRE += "|" + militaryRE;
		}

		return "(" + statesRE + ")"; // String
	}

	dojox.regexp.ca.postalCode = function() {
		var postalRE = "[A-Z][0-9][A-Z] [0-9][A-Z][0-9]";
		return "(" + postalRE + ")";
	}

	dojox.regexp.ca.province = function() {
		// summary: a regular expression to match Canadian Province
		// Abbreviations
		var stateRE = "AB|BC|MB|NB|NL|NS|NT|NU|ON|PE|QC|SK|YT";
		return "(" + statesRE + ")";
	}

	dojox.regexp.numberFormat = function(/* Object? */flags) {
		// summary: Builds a regular expression to match any sort of number
		// based format
		// description:
		// Use this method for phone numbers, social security numbers,
		// zip-codes, etc.
		// The RE can match one format or one of multiple formats.
		//
		// Format
		// # Stands for a digit, 0-9.
		// ? Stands for an optional digit, 0-9 or nothing.
		// All other characters must appear literally in the expression.
		//
		// Example
		// "(###) ###-####" -> (510) 542-9742
		// "(###) ###-#### x#???" -> (510) 542-9742 x153
		// "###-##-####" -> 506-82-1089 i.e. social security number
		// "#####-####" -> 98225-1649 i.e. zip code
		//
		// flags: An object
		// flags.format A string or an Array of strings for multiple formats.

		// assign default values to missing paramters
		flags = (typeof flags == "object") ? flags : {};
		if (typeof flags.format == "undefined") {
			flags.format = "###-###-####";
		}

		// Converts a number format to RE.
		var digitRE = function(format) {
			// escape all special characters, except '?'
			format = dojo.regexp.escapeString(format, "?");

			// Now replace '?' with Regular Expression
			format = format.replace(/\?/g, "\\d?");

			// replace # with Regular Expression
			format = format.replace(/#/g, "\\d");

			return format; // String
		};

		// build RE for multiple number formats
		return dojo.regexp.buildGroupRE(flags.format, digitRE); // String
	}

}