0.6.x/js/01_core/04_XObject.js

   1 /**\r
   2  * name in object 構文が使えない環境で構文解析エラーを回避するためにこのメソッドを使用します。\r
   3  * 但し for( name in object ) については構文解析エラーになる環境はありません。\r
   4  * @alias X.Object.inObject\r
   5  * @function\r
   6  * @param {string|number} name \r
   7  * @param {object} obj \r
   8  * @return {boolean} name が定義されている(値が undefined や null でも) -> true\r
   9  */\r
  10 var X_Object_inObject = X_UA[ 'IE' ] < 5.5 ? // TODO JScript で判定\r
  11         (function( name, obj, p ){\r
  12                 if( obj[ name ] ) return true; // quick\r
  13                 name += ''; // 数値も許可\r
  14                 for( p in obj ){\r
  15                         if( p === name ) return true;\r
  16                 };\r
  17                 return false;\r
  18         }) :\r
  19         new Function( 'a,b', 'return a in b' );\r
  20 \r
  21 \r
  22 // ------------------------------------------------------------------------- //\r
  23 // --- interface ----------------------------------------------------------- //\r
  24 // ------------------------------------------------------------------------- //\r
  25 \r
  26 /**\r
  27  * Object に関するメソッドを集めたものです。\r
  28  * @namespace X.Object\r
  29  * @alias X.Object\r
  30  */\r
  31 X[ 'Object' ] = {\r
  32         // TODO rename to copy\r
  33         'clone'      : X_Object_clone,\r
  34         \r
  35         'override'   : X_Object_override,\r
  36         \r
  37         'deepCopy'   : X_Object_deepCopy,\r
  38         \r
  39         // TODO rename to X.Array.copy\r
  40         'cloneArray' : X_Object_cloneArray,\r
  41         \r
  42         'isEmpty'    : X_Object_isEmpty,\r
  43         \r
  44         'inObject'   : X_Object_inObject\r
  45         \r
  46         // TODO hasOwnProperty\r
  47 };\r
  48 \r
  49 // ------------------------------------------------------------------------- //\r
  50 // --- implements ---------------------------------------------------------- //\r
  51 // ------------------------------------------------------------------------- //\r
  52 /**\r
  53  * 単純なクローンでメンバーをコピーしたオブジェクトを返します。 k in null でエラーになる Opera7- に対策済。\r
  54  * @alias X.Object.clone\r
  55  * @param {object|Array} src コピー元のオブジェクトです。\r
  56  * @return {object|Array}\r
  57  */\r
  58 function X_Object_clone( src ){\r
  59         var ret, k;\r
  60         \r
  61         if( !src || !X_Type_isObject( src ) ) return src;\r
  62         \r
  63         ret = {};\r
  64         for( k in src ){\r
  65                 //if( X_EMPTY_OBJECT[ k ] ) continue;\r
  66                 ret[ k ] = src[ k ];\r
  67         };\r
  68         return ret;\r
  69 };\r
  70 \r
  71 /**\r
  72  * オブジェクトにオブジェトのメンバーをコピーします。同じ名前のメンバーは上書きされます。\r
  73  * @alias X.Object.override\r
  74  * @param {object} target コピーされるオブジェクトです。返り値はこのオブジェクトです。\r
  75  * @param {object} src コピー元のオブジェクトです。\r
  76  * @return {object} target が返る。\r
  77  */\r
  78 function X_Object_override( target, src ){\r
  79         var k;\r
  80         if( !src || !X_Type_isObject( src ) ) return target;\r
  81         for( k in src ){\r
  82                 //if( X_EMPTY_OBJECT[ k ] ) continue;\r
  83                 target[ k ] = src[ k ];\r
  84         };\r
  85         return target;\r
  86 };\r
  87 \r
  88 /**\r
  89  * オブジェクト(object, Array)のメンバーを探索して、ディープコピーしたオブジェクトを返します。\r
  90  * オブジェクトが循環参照している場合は、既にコピーしているオブジェクトが現れた時点で、先に作成しているコピーの参照を返すので無限にループすることはありません。\r
  91  * @alias X.Object.deepCopy\r
  92  * @param {object|Array} src コピー元のオブジェクトです。\r
  93  * @return {object|Array}\r
  94  */\r
  95 function X_Object_deepCopy( src ){              \r
  96         return X_Object_deepCopy_( src, [], [], -1 );\r
  97 };\r
  98 \r
  99 function X_Object_deepCopy_( src, objSrc, objCopy, n ) {\r
 100         var ret, i, k;\r
 101         \r
 102         if( !src ){ // 0, "", null, undefined, NaN, false\r
 103                 return src;\r
 104         } else\r
 105         if( X_Type_isArray( src ) ){\r
 106                 i = objSrc.indexOf( src );\r
 107                 if( i !== -1 ) return objCopy[ i ];\r
 108                 objSrc[ ++n ] = src;\r
 109                 objCopy[ n ]  = ret = [];\r
 110         } else\r
 111         if( X_Type_isObject( src ) ){\r
 112                 i = objSrc.indexOf( src );\r
 113                 if( i !== -1 ) return objCopy[ i ];\r
 114                 objSrc[ ++n ] = src;\r
 115                 objCopy[ n ]  = ret = {};\r
 116         } else {\r
 117                 // string, number, true\r
 118                 return src;\r
 119         };\r
 120         for( k in src ){\r
 121                 //if( X_EMPTY_OBJECT[ k ] ) continue;\r
 122                 ret[ k ] = X_Object_deepCopy_( src[ k ], objSrc, objCopy, n );\r
 123         };\r
 124         return ret;\r
 125 };\r
 126 \r
 127 /**\r
 128  * 単純にメンバーをコピーした Array を返します。\r
 129  * @alias X.Object.cloneArray\r
 130  * @param {Array} ary コピー元のオブジェクトです。\r
 131  * @return {Array}\r
 132  */\r
 133 function X_Object_cloneArray( ary ){\r
 134         var ret = [],\r
 135                 i = ary.length;\r
 136 \r
 137         if( !i ) return ret;\r
 138         for( ; i; ){\r
 139                 ret[ --i ] = ary[ i ];\r
 140         };\r
 141         return ret;\r
 142 };\r
 143 \r
 144 /**\r
 145  * object が空か？調べます。 object でない場合、undefined が返る\r
 146  * @alias X.Object.isEmpty\r
 147  * @param {object} v \r
 148  * @return {boolean|undefined}\r
 149  */\r
 150 function X_Object_isEmpty( v ){\r
 151         if( !v ) return;\r
 152         for( var k in v ){\r
 153                 //if( X_EMPTY_OBJECT[ _k ] ) continue;\r
 154                 return false;//if( v.hasOwnProperty && v.hasOwnProperty( p ) ) return false; ie4 で動かない、、、\r
 155         };\r
 156         return true;\r
 157 };\r
 158 \r
 159 /*      \r
 160 X.matchTest = function( array1, array2 ){\r
 161         var i = array2.length;\r
 162         for( ; i; ){\r
 163                 if( array1.indexOf( array2[ --i ] ) === -1 ) return false;\r
 164         };\r
 165         return true;\r
 166 }; */\r