OSDN Git Service

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