Port dojo.lang.shallowCopy to Dojo 0.9

[Tom Trenka]

The shallowCopy method in dojo.lang (0.4) is used fairly often in some other parts of the code base (particularly dojox.gfx); if this could be ported to Dojo Core, that'd be awesome. There's a comment in it asking "why tf is it called shallowCopy?"; suggestions for a better name would be dojo.clone() or dojo.copy().

[bill]

See lang.js. There's a dojo.clone() function there already except that it's commented out.

// FIXME: this is unreviewed dojo.clone() function, 
// which can clone any objects including HTML nodes

//dojo.clone = function(/*anything*/ o){
//	// summary:
//	//		Clones objects (including DOM nodes) and all children.
//	//		Warning: do not clone cyclic structures.
//	if(!o){ return o; }
//	if(dojo.isArray(o)){
//		var r = [];
//		for(var i = 0; i < o.length; ++i){
//			r.push(dojo.clone(o[i]));
//		}
//		return r;
//	}else if(dojo.isObject(o)){
//		if(o.nodeType && o.cloneNode){ // isNode
//			return o.cloneNode(true);
//		}else{
//			var r = new o.constructor();
//			for(var i in o){
//				if(!(i in r) || r[i] != o[i]){
//					r[i] = dojo.clone(o[i]);
//				}
//			}
//			return r;
//		}
//	}
//	return o;
//}

[alex]

dojo.clone() made it into 0.9