<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="en_US" xml:lang="en_US"> <head> <title>kjs: lookup.h Source File (kjs)</title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" comment "ICRAonline DE v2.0" l gen true for "http://www.kde.org" r (nz 1 vz 1 lz 1 oz 1 cb 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://www.kde.org" r (n 0 s 0 v 0 l 0))' /> <meta name="trademark" content="KDE e.V." /> <meta name="description" content="K Desktop Environment Homepage, KDE.org" /> <meta name="MSSmartTagsPreventParsing" content="true" /> <meta name="robots" content="all" /> <link rel="shortcut icon" href="../../favicon.ico" /> <link rel="stylesheet" media="screen" type="text/css" title="APIDOX" href="doxygen.css" /> </head> <body> <div id="nav_header_top" align="right"> <a href="#content" class="doNotDisplay" accesskey="2">Skip to main content ::</a> <a href="../.."><img id="nav_header_logo" alt="Home" align="left" src="../../kde_gear_64.png" border="0" /></a> <span class="doNotDisplay">::</span> <div id="nav_header_title" align="left">KDE API Reference</div> </div> <div id="nav_header_bottom" align="right"> <span class="doNotDisplay">:: <a href="#navigation" accesskey="5">Skip to Link Menu</a><br/></span> <div id="nav_header_bottom_right" style="text-align: left;"> / <a href="../..">API Reference</a> / <a href=".">kjs</a> </div> </div> <table id="main" border="0" cellpadding="0" cellspacing="0" width="100%"> <tr> <td valign="top" class="menuheader" height="0"></td> <td id="contentcolumn" valign="top" rowspan="2" > <div id="content" style="padding-top: 0px;"><div style="width:100%; margin: 0px; padding: 0px;"> <a name="content"></a> <!-- Generated by Doxygen 1.7.4 --> <div class="header"> <div class="headertitle"> <div class="title">lookup.h</div> </div> </div> <div class="contents"> <div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">// -*- c-basic-offset: 2 -*-</span> <a name="l00002"></a>00002 <span class="comment">/*</span> <a name="l00003"></a>00003 <span class="comment"> * This file is part of the KDE libraries</span> <a name="l00004"></a>00004 <span class="comment"> * Copyright (C) 1999-2000 Harri Porten (porten@kde.org)</span> <a name="l00005"></a>00005 <span class="comment"> * Copyright (C) 2003 Apple Computer, Inc.</span> <a name="l00006"></a>00006 <span class="comment"> *</span> <a name="l00007"></a>00007 <span class="comment"> * This library is free software; you can redistribute it and/or</span> <a name="l00008"></a>00008 <span class="comment"> * modify it under the terms of the GNU Lesser General Public</span> <a name="l00009"></a>00009 <span class="comment"> * License as published by the Free Software Foundation; either</span> <a name="l00010"></a>00010 <span class="comment"> * version 2 of the License, or (at your option) any later version.</span> <a name="l00011"></a>00011 <span class="comment"> *</span> <a name="l00012"></a>00012 <span class="comment"> * This library is distributed in the hope that it will be useful,</span> <a name="l00013"></a>00013 <span class="comment"> * but WITHOUT ANY WARRANTY; without even the implied warranty of</span> <a name="l00014"></a>00014 <span class="comment"> * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</span> <a name="l00015"></a>00015 <span class="comment"> * Lesser General Public License for more details.</span> <a name="l00016"></a>00016 <span class="comment"> *</span> <a name="l00017"></a>00017 <span class="comment"> * You should have received a copy of the GNU Lesser General Public</span> <a name="l00018"></a>00018 <span class="comment"> * License along with this library; if not, write to the Free Software</span> <a name="l00019"></a>00019 <span class="comment"> * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA</span> <a name="l00020"></a>00020 <span class="comment"> *</span> <a name="l00021"></a>00021 <span class="comment"> */</span> <a name="l00022"></a>00022 <a name="l00023"></a>00023 <span class="preprocessor">#ifndef _KJSLOOKUP_H_</span> <a name="l00024"></a>00024 <span class="preprocessor"></span><span class="preprocessor">#define _KJSLOOKUP_H_</span> <a name="l00025"></a>00025 <span class="preprocessor"></span> <a name="l00026"></a>00026 <span class="preprocessor">#include "identifier.h"</span> <a name="l00027"></a>00027 <span class="preprocessor">#include "value.h"</span> <a name="l00028"></a>00028 <span class="preprocessor">#include "object.h"</span> <a name="l00029"></a>00029 <span class="preprocessor">#include "interpreter.h"</span> <a name="l00030"></a>00030 <span class="preprocessor">#include <stdio.h></span> <a name="l00031"></a>00031 <a name="l00032"></a>00032 <span class="keyword">namespace </span>KJS { <a name="l00033"></a>00033 <a name="l00037"></a><a class="code" href="structKJS_1_1HashEntry.html">00037</a> <span class="keyword">struct </span><a class="code" href="structKJS_1_1HashEntry.html" title="An entry in a hash table.">HashEntry</a> { <a name="l00041"></a><a class="code" href="structKJS_1_1HashEntry.html#afb93ded6bc0d48e1f58056ac4b6a029c">00041</a> <span class="keywordtype">unsigned</span> <span class="keywordtype">short</span> <a class="code" href="structKJS_1_1HashEntry.html#afb93ded6bc0d48e1f58056ac4b6a029c" title="s is the offset to the string key (e.g.">soffset</a>; <a name="l00045"></a><a class="code" href="structKJS_1_1HashEntry.html#ae4dd6db441f29909cd03c9466b2bc931">00045</a> <span class="keywordtype">short</span> <span class="keywordtype">int</span> <a class="code" href="structKJS_1_1HashEntry.html#ae4dd6db441f29909cd03c9466b2bc931" title="value is the result value (usually an enum value)">value</a>; <a name="l00049"></a><a class="code" href="structKJS_1_1HashEntry.html#a12c2b8d0dc49b3f26695c10a5a1a4781">00049</a> <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> <a class="code" href="structKJS_1_1HashEntry.html#a12c2b8d0dc49b3f26695c10a5a1a4781" title="attr is a set for flags (e.g.">attr</a>; <a name="l00054"></a><a class="code" href="structKJS_1_1HashEntry.html#a4886c63e2d87d0731ac60821bf59175b">00054</a> <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> <a class="code" href="structKJS_1_1HashEntry.html#a4886c63e2d87d0731ac60821bf59175b" title="params is another number.">params</a>; <a name="l00058"></a><a class="code" href="structKJS_1_1HashEntry.html#ad95917ba5e39d20c8fc8c43810045a21">00058</a> <span class="keywordtype">short</span> <a class="code" href="structKJS_1_1HashEntry.html#ad95917ba5e39d20c8fc8c43810045a21" title="next is the index to the next entry for the same hash value">next</a>; <a name="l00059"></a>00059 }; <a name="l00060"></a>00060 <a name="l00072"></a><a class="code" href="structKJS_1_1HashTable.html">00072</a> <span class="keyword">struct </span><a class="code" href="structKJS_1_1HashTable.html" title="A hash table Usually the hashtable is generated by the create_hash_table script, from a ...">HashTable</a> { <a name="l00076"></a><a class="code" href="structKJS_1_1HashTable.html#ae38f682939fba01691428863d9b4bfa1">00076</a> <span class="keywordtype">int</span> <a class="code" href="structKJS_1_1HashTable.html#ae38f682939fba01691428863d9b4bfa1" title="type is a version number.">type</a>; <a name="l00082"></a><a class="code" href="structKJS_1_1HashTable.html#a81197ec5685573938c9e0ba1423cc08b">00082</a> <span class="keywordtype">int</span> <a class="code" href="structKJS_1_1HashTable.html#a81197ec5685573938c9e0ba1423cc08b" title="size is the total number of entries in the hashtable, including the null entries, i...">size</a>; <a name="l00087"></a><a class="code" href="structKJS_1_1HashTable.html#a7c4140e42df68f8eae1ea17a93150ecf">00087</a> <span class="keyword">const</span> <a class="code" href="structKJS_1_1HashEntry.html" title="An entry in a hash table.">HashEntry</a> *<span class="keyword">const</span> <a class="code" href="structKJS_1_1HashTable.html#a7c4140e42df68f8eae1ea17a93150ecf" title="pointer to the array of entries Mind that some entries in the array are null (0,0,0,0).">entries</a>; <a name="l00091"></a><a class="code" href="structKJS_1_1HashTable.html#ad8bcaed94f9a1fb84377a27a98e4f79a">00091</a> <span class="keywordtype">int</span> <a class="code" href="structKJS_1_1HashTable.html#ad8bcaed94f9a1fb84377a27a98e4f79a" title="the maximum value for the hash.">hashSize</a>; <a name="l00092"></a>00092 <a name="l00096"></a><a class="code" href="structKJS_1_1HashTable.html#a22acd0e8efcefaad0c73cce8f5e6cccd">00096</a> <span class="keyword">const</span> <span class="keywordtype">char</span>* <span class="keyword">const</span> <a class="code" href="structKJS_1_1HashTable.html#a22acd0e8efcefaad0c73cce8f5e6cccd" title="pointer to the string table.">sbase</a>; <a name="l00097"></a>00097 }; <a name="l00098"></a>00098 <a name="l00102"></a><a class="code" href="classKJS_1_1Lookup.html">00102</a> <span class="keyword">class </span>KJS_EXPORT <a class="code" href="classKJS_1_1Lookup.html" title="Fast keyword lookup.">Lookup</a> { <a name="l00103"></a>00103 <span class="keyword">public</span>: <a name="l00107"></a>00107 <span class="keyword">static</span> <span class="keywordtype">int</span> find(<span class="keyword">const</span> <span class="keyword">struct</span> <a class="code" href="structKJS_1_1HashTable.html" title="A hash table Usually the hashtable is generated by the create_hash_table script, from a ...">HashTable</a> *table, <span class="keyword">const</span> <a class="code" href="classKJS_1_1Identifier.html" title="Represents an Identifier for a Javascript object.">Identifier</a> &s); <a name="l00108"></a>00108 <span class="keyword">static</span> <span class="keywordtype">int</span> find(<span class="keyword">const</span> <span class="keyword">struct</span> <a class="code" href="structKJS_1_1HashTable.html" title="A hash table Usually the hashtable is generated by the create_hash_table script, from a ...">HashTable</a> *table, <a name="l00109"></a>00109 <span class="keyword">const</span> <a class="code" href="structKJS_1_1UChar.html" title="Unicode character.">UChar</a> *c, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> len); <a name="l00110"></a>00110 <a name="l00116"></a>00116 <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="structKJS_1_1HashEntry.html" title="An entry in a hash table.">HashEntry</a>* findEntry(<span class="keyword">const</span> <span class="keyword">struct</span> <a class="code" href="structKJS_1_1HashTable.html" title="A hash table Usually the hashtable is generated by the create_hash_table script, from a ...">HashTable</a> *table, <a name="l00117"></a>00117 <span class="keyword">const</span> <a class="code" href="classKJS_1_1Identifier.html" title="Represents an Identifier for a Javascript object.">Identifier</a> &s); <a name="l00118"></a>00118 <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="structKJS_1_1HashEntry.html" title="An entry in a hash table.">HashEntry</a>* findEntry(<span class="keyword">const</span> <span class="keyword">struct</span> <a class="code" href="structKJS_1_1HashTable.html" title="A hash table Usually the hashtable is generated by the create_hash_table script, from a ...">HashTable</a> *table, <a name="l00119"></a>00119 <span class="keyword">const</span> <a class="code" href="structKJS_1_1UChar.html" title="Unicode character.">UChar</a> *c, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> len); <a name="l00120"></a>00120 <a name="l00124"></a>00124 <span class="keyword">static</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> hash(<span class="keyword">const</span> <a class="code" href="classKJS_1_1Identifier.html" title="Represents an Identifier for a Javascript object.">Identifier</a> &key); <a name="l00125"></a>00125 <span class="keyword">static</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> hash(<span class="keyword">const</span> <a class="code" href="structKJS_1_1UChar.html" title="Unicode character.">UChar</a> *c, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> len); <a name="l00126"></a>00126 <span class="keyword">static</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> hash(<span class="keyword">const</span> <span class="keywordtype">char</span> *s); <a name="l00127"></a>00127 }; <a name="l00128"></a>00128 <a name="l00129"></a>00129 <span class="keyword">class </span><a class="code" href="classKJS_1_1ExecState.html" title="Represents the current state of script execution.">ExecState</a>; <a name="l00130"></a>00130 <span class="keyword">class </span><a class="code" href="classKJS_1_1UString.html" title="Unicode string class.">UString</a>; <a name="l00135"></a>00135 <span class="keyword">template</span> <<span class="keyword">class</span> FuncImp> <a name="l00136"></a>00136 <span class="keyword">inline</span> <a class="code" href="classKJS_1_1Value.html" title="Value objects are act as wrappers ("smart pointers") around ValueImp objects and their descendents...">Value</a> lookupOrCreateFunction(<a class="code" href="classKJS_1_1ExecState.html" title="Represents the current state of script execution.">ExecState</a> *exec, <span class="keyword">const</span> <a class="code" href="classKJS_1_1Identifier.html" title="Represents an Identifier for a Javascript object.">Identifier</a> &propertyName, <a name="l00137"></a>00137 <span class="keyword">const</span> ObjectImp *thisObj, <span class="keywordtype">int</span> token, <span class="keywordtype">int</span> params, <span class="keywordtype">int</span> attr) <a name="l00138"></a>00138 { <a name="l00139"></a>00139 <span class="comment">// Look for cached value in dynamic map of properties (in ObjectImp)</span> <a name="l00140"></a>00140 <a class="code" href="classKJS_1_1ValueImp.html" title="ValueImp is the base type for all primitives (Undefined, Null, Boolean, String, Number) and objects i...">ValueImp</a> * cachedVal = thisObj->ObjectImp::getDirect(propertyName); <a name="l00141"></a>00141 <span class="comment">/*if (cachedVal)</span> <a name="l00142"></a>00142 <span class="comment"> fprintf(stderr, "lookupOrCreateFunction: Function -> looked up in ObjectImp, found type=%d\n", cachedVal->type());*/</span> <a name="l00143"></a>00143 <span class="keywordflow">if</span> (cachedVal) <a name="l00144"></a>00144 <span class="keywordflow">return</span> <a class="code" href="classKJS_1_1Value.html" title="Value objects are act as wrappers ("smart pointers") around ValueImp objects and their descendents...">Value</a>(cachedVal); <a name="l00145"></a>00145 <a name="l00146"></a>00146 ObjectImp* func = <span class="keyword">new</span> FuncImp( exec, token, params ); <a name="l00147"></a>00147 <a class="code" href="classKJS_1_1Value.html" title="Value objects are act as wrappers ("smart pointers") around ValueImp objects and their descendents...">Value</a> val( func ); <a name="l00148"></a>00148 func->setFunctionName( propertyName ); <a name="l00149"></a>00149 ObjectImp *thatObj = <span class="keyword">const_cast<</span>ObjectImp *<span class="keyword">></span>(thisObj); <a name="l00150"></a>00150 thatObj->ObjectImp::put(exec, propertyName, val, attr); <a name="l00151"></a>00151 <span class="keywordflow">return</span> val; <a name="l00152"></a>00152 } <a name="l00153"></a>00153 <a name="l00174"></a>00174 <span class="keyword">template</span> <<span class="keyword">class</span> FuncImp, <span class="keyword">class</span> ThisImp, <span class="keyword">class</span> ParentImp> <a name="l00175"></a>00175 <span class="keyword">inline</span> Value lookupGet(ExecState *exec, <span class="keyword">const</span> Identifier &propertyName, <a name="l00176"></a>00176 <span class="keyword">const</span> HashTable* table, <span class="keyword">const</span> ThisImp* thisObj) <a name="l00177"></a>00177 { <a name="l00178"></a>00178 <span class="keyword">const</span> HashEntry* entry = <a class="code" href="classKJS_1_1Lookup.html#a97a1e8d2a5bb04cf1b1aa51b91b58c12" title="Find an entry in the table, and return the entry This variant gives access to the other attributes of...">Lookup::findEntry</a>(table, propertyName); <a name="l00179"></a>00179 <a name="l00180"></a>00180 <span class="keywordflow">if</span> (!entry) <span class="comment">// not found, forward to parent</span> <a name="l00181"></a>00181 <span class="keywordflow">return</span> thisObj->ParentImp::get(exec, propertyName); <a name="l00182"></a>00182 <a name="l00183"></a>00183 <span class="comment">//fprintf(stderr, "lookupGet: found value=%d attr=%d\n", entry->value, entry->attr);</span> <a name="l00184"></a>00184 <span class="keywordflow">if</span> (entry->attr & Function) <a name="l00185"></a>00185 <span class="keywordflow">return</span> lookupOrCreateFunction<FuncImp>(exec, propertyName, thisObj, entry->value, entry->params, entry->attr); <a name="l00186"></a>00186 <span class="keywordflow">return</span> thisObj->getValueProperty(exec, entry->value); <a name="l00187"></a>00187 } <a name="l00188"></a>00188 <a name="l00193"></a>00193 <span class="keyword">template</span> <<span class="keyword">class</span> FuncImp, <span class="keyword">class</span> ParentImp> <a name="l00194"></a>00194 <span class="keyword">inline</span> Value lookupGetFunction(ExecState *exec, <span class="keyword">const</span> Identifier &propertyName, <a name="l00195"></a>00195 <span class="keyword">const</span> HashTable* table, <span class="keyword">const</span> ObjectImp* thisObj) <a name="l00196"></a>00196 { <a name="l00197"></a>00197 <span class="keyword">const</span> HashEntry* entry = <a class="code" href="classKJS_1_1Lookup.html#a97a1e8d2a5bb04cf1b1aa51b91b58c12" title="Find an entry in the table, and return the entry This variant gives access to the other attributes of...">Lookup::findEntry</a>(table, propertyName); <a name="l00198"></a>00198 <a name="l00199"></a>00199 <span class="keywordflow">if</span> (!entry) <span class="comment">// not found, forward to parent</span> <a name="l00200"></a>00200 <span class="keywordflow">return</span> <span class="keyword">static_cast<</span><span class="keyword">const </span>ParentImp *<span class="keyword">></span>(thisObj)->ParentImp::get(exec, propertyName); <a name="l00201"></a>00201 <a name="l00202"></a>00202 <span class="keywordflow">if</span> (entry->attr & Function) <a name="l00203"></a>00203 <span class="keywordflow">return</span> lookupOrCreateFunction<FuncImp>(exec, propertyName, thisObj, entry->value, entry->params, entry->attr); <a name="l00204"></a>00204 <a name="l00205"></a>00205 fprintf(stderr, <span class="stringliteral">"Function bit not set! Shouldn't happen in lookupGetFunction!\n"</span> ); <a name="l00206"></a>00206 <span class="keywordflow">return</span> Undefined(); <a name="l00207"></a>00207 } <a name="l00208"></a>00208 <a name="l00213"></a>00213 <span class="keyword">template</span> <<span class="keyword">class</span> ThisImp, <span class="keyword">class</span> ParentImp> <a name="l00214"></a>00214 <span class="keyword">inline</span> Value lookupGetValue(ExecState *exec, <span class="keyword">const</span> Identifier &propertyName, <a name="l00215"></a>00215 <span class="keyword">const</span> HashTable* table, <span class="keyword">const</span> ThisImp* thisObj) <a name="l00216"></a>00216 { <a name="l00217"></a>00217 <span class="keyword">const</span> HashEntry* entry = <a class="code" href="classKJS_1_1Lookup.html#a97a1e8d2a5bb04cf1b1aa51b91b58c12" title="Find an entry in the table, and return the entry This variant gives access to the other attributes of...">Lookup::findEntry</a>(table, propertyName); <a name="l00218"></a>00218 <a name="l00219"></a>00219 <span class="keywordflow">if</span> (!entry) <span class="comment">// not found, forward to parent</span> <a name="l00220"></a>00220 <span class="keywordflow">return</span> thisObj->ParentImp::get(exec, propertyName); <a name="l00221"></a>00221 <a name="l00222"></a>00222 <span class="keywordflow">if</span> (entry->attr & Function) <a name="l00223"></a>00223 fprintf(stderr, <span class="stringliteral">"Function bit set! Shouldn't happen in lookupGetValue! propertyName was %s\n"</span>, propertyName.ascii() ); <a name="l00224"></a>00224 <span class="keywordflow">return</span> thisObj->getValueProperty(exec, entry->value); <a name="l00225"></a>00225 } <a name="l00226"></a>00226 <a name="l00231"></a>00231 <span class="keyword">template</span> <<span class="keyword">class</span> ThisImp, <span class="keyword">class</span> ParentImp> <a name="l00232"></a>00232 <span class="keyword">inline</span> <span class="keywordtype">void</span> lookupPut(ExecState *exec, <span class="keyword">const</span> Identifier &propertyName, <a name="l00233"></a>00233 <span class="keyword">const</span> Value& value, <span class="keywordtype">int</span> attr, <a name="l00234"></a>00234 <span class="keyword">const</span> HashTable* table, ThisImp* thisObj) <a name="l00235"></a>00235 { <a name="l00236"></a>00236 <span class="keyword">const</span> HashEntry* entry = <a class="code" href="classKJS_1_1Lookup.html#a97a1e8d2a5bb04cf1b1aa51b91b58c12" title="Find an entry in the table, and return the entry This variant gives access to the other attributes of...">Lookup::findEntry</a>(table, propertyName); <a name="l00237"></a>00237 <a name="l00238"></a>00238 <span class="keywordflow">if</span> (!entry) <span class="comment">// not found: forward to parent</span> <a name="l00239"></a>00239 thisObj->ParentImp::put(exec, propertyName, value, attr); <a name="l00240"></a>00240 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (entry->attr & Function) <span class="comment">// function: put as override property</span> <a name="l00241"></a>00241 thisObj->ObjectImp::put(exec, propertyName, value, attr); <a name="l00242"></a>00242 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (entry->attr & ReadOnly) <span class="comment">// readonly! Can't put!</span> <a name="l00243"></a>00243 <span class="preprocessor">#ifdef KJS_VERBOSE</span> <a name="l00244"></a>00244 <span class="preprocessor"></span> fprintf(stderr,<span class="stringliteral">"WARNING: Attempt to change value of readonly property '%s'\n"</span>,propertyName.ascii()); <a name="l00245"></a>00245 <span class="preprocessor">#else</span> <a name="l00246"></a>00246 <span class="preprocessor"></span> ; <span class="comment">// do nothing</span> <a name="l00247"></a>00247 <span class="preprocessor">#endif</span> <a name="l00248"></a>00248 <span class="preprocessor"></span> <span class="keywordflow">else</span> <a name="l00249"></a>00249 thisObj->putValueProperty(exec, entry->value, value, attr); <a name="l00250"></a>00250 } <a name="l00251"></a>00251 <a name="l00252"></a>00252 <a name="l00260"></a>00260 <span class="keyword">template</span> <<span class="keyword">class</span> ClassCtor> <a name="l00261"></a>00261 <span class="keyword">inline</span> <a class="code" href="classKJS_1_1Object.html" title="Represents an Object.">KJS::Object</a> cacheGlobalObject(ExecState *exec, <span class="keyword">const</span> Identifier &propertyName) <a name="l00262"></a>00262 { <a name="l00263"></a>00263 ValueImp *obj = <span class="keyword">static_cast<</span>KJS::ObjectImp*<span class="keyword">></span>(exec->interpreter()->globalObject().imp())->getDirect(propertyName); <a name="l00264"></a>00264 <span class="keywordflow">if</span> (obj) <a name="l00265"></a>00265 <span class="keywordflow">return</span> <a class="code" href="classKJS_1_1Object.html#ab12ea86cb49e21ea6c5547507f8d128e" title="Converts a Value into an Object.">KJS::Object::dynamicCast</a>(Value(obj)); <a name="l00266"></a>00266 <span class="keywordflow">else</span> <a name="l00267"></a>00267 { <a name="l00268"></a>00268 <a class="code" href="classKJS_1_1Object.html" title="Represents an Object.">KJS::Object</a> newObject(<span class="keyword">new</span> ClassCtor(exec)); <a name="l00269"></a>00269 exec->interpreter()->globalObject().put(exec, propertyName, newObject, Internal); <a name="l00270"></a>00270 <span class="keywordflow">return</span> newObject; <a name="l00271"></a>00271 } <a name="l00272"></a>00272 } <a name="l00273"></a>00273 <a name="l00274"></a>00274 <a name="l00293"></a>00293 <span class="preprocessor">#define PUBLIC_DEFINE_PROTOTYPE(ClassName,ClassProto) \</span> <a name="l00294"></a>00294 <span class="preprocessor"> namespace KJS { \</span> <a name="l00295"></a>00295 <span class="preprocessor"> class ClassProto : public KJS::ObjectImp { \</span> <a name="l00296"></a>00296 <span class="preprocessor"> friend KJS::Object cacheGlobalObject<ClassProto>(KJS::ExecState *exec, const KJS::Identifier &propertyName); \</span> <a name="l00297"></a>00297 <span class="preprocessor"> public: \</span> <a name="l00298"></a>00298 <span class="preprocessor"> static KJS::Object self(KJS::ExecState *exec) \</span> <a name="l00299"></a>00299 <span class="preprocessor"> { \</span> <a name="l00300"></a>00300 <span class="preprocessor"> return cacheGlobalObject<ClassProto>( exec, "[[" ClassName ".prototype]]" ); \</span> <a name="l00301"></a>00301 <span class="preprocessor"> } \</span> <a name="l00302"></a>00302 <span class="preprocessor"> protected: \</span> <a name="l00303"></a>00303 <span class="preprocessor"> ClassProto( KJS::ExecState *exec ) \</span> <a name="l00304"></a>00304 <span class="preprocessor"> : KJS::ObjectImp( exec->interpreter()->builtinObjectPrototype() ) {} \</span> <a name="l00305"></a>00305 <span class="preprocessor"> \</span> <a name="l00306"></a>00306 <span class="preprocessor"> public: \</span> <a name="l00307"></a>00307 <span class="preprocessor"> virtual const KJS::ClassInfo *classInfo() const { return &info; } \</span> <a name="l00308"></a>00308 <span class="preprocessor"> static const KJS::ClassInfo info; \</span> <a name="l00309"></a>00309 <span class="preprocessor"> KJS::Value get(KJS::ExecState *exec, const KJS::Identifier &propertyName) const; \</span> <a name="l00310"></a>00310 <span class="preprocessor"> bool hasProperty(KJS::ExecState *exec, const KJS::Identifier &propertyName) const; \</span> <a name="l00311"></a>00311 <span class="preprocessor"> }; \</span> <a name="l00312"></a>00312 <span class="preprocessor"> }</span> <a name="l00313"></a>00313 <span class="preprocessor"></span> <a name="l00314"></a>00314 <span class="preprocessor">#define IMPLEMENT_CLASSINFO(ClassName,ClassProto) \</span> <a name="l00315"></a>00315 <span class="preprocessor"> namespace KJS {\</span> <a name="l00316"></a>00316 <span class="preprocessor"> const KJS::ClassInfo ClassProto::info = { ClassName, 0, &ClassProto##Table, 0 }; \</span> <a name="l00317"></a>00317 <span class="preprocessor"> }</span> <a name="l00318"></a>00318 <span class="preprocessor"></span> <a name="l00319"></a>00319 <span class="preprocessor">#define DEFINE_PROTOTYPE(ClassName,ClassProto) \</span> <a name="l00320"></a>00320 <span class="preprocessor"> PUBLIC_DEFINE_PROTOTYPE(ClassName,ClassProto) \</span> <a name="l00321"></a>00321 <span class="preprocessor"> IMPLEMENT_CLASSINFO(ClassName,ClassProto)</span> <a name="l00322"></a>00322 <span class="preprocessor"></span> <a name="l00323"></a>00323 <span class="preprocessor">#define IMPLEMENT_PROTOTYPE(ClassProto,ClassFunc) \</span> <a name="l00324"></a>00324 <span class="preprocessor"> KJS::Value KJS::ClassProto::get(KJS::ExecState *exec, const KJS::Identifier &propertyName) const \</span> <a name="l00325"></a>00325 <span class="preprocessor"> { \</span> <a name="l00326"></a>00326 <span class="preprocessor"> </span><span class="comment">/*fprintf( stderr, "%sProto::get(%s) [in macro, no parent]\n", info.className, propertyName.ascii());*/</span> \ <a name="l00327"></a>00327 return lookupGetFunction<ClassFunc,KJS::ObjectImp>(exec, propertyName, &ClassProto##Table, this ); \ <a name="l00328"></a>00328 } \ <a name="l00329"></a>00329 bool KJS::ClassProto::hasProperty(KJS::ExecState *exec, const KJS::Identifier &propertyName) const \ <a name="l00330"></a>00330 { <span class="comment">/*stupid but we need this to have a common macro for the declaration*/</span> \ <a name="l00331"></a>00331 return KJS::ObjectImp::hasProperty(exec, propertyName); \ <a name="l00332"></a>00332 } <a name="l00333"></a>00333 <a name="l00334"></a>00334 <span class="preprocessor">#define PUBLIC_IMPLEMENT_PROTOTYPE(ClassProto,ClassName,ClassFunc) \</span> <a name="l00335"></a>00335 <span class="preprocessor"> IMPLEMENT_PROTOTYPE(ClassProto,ClassFunc)\</span> <a name="l00336"></a>00336 <span class="preprocessor"> IMPLEMENT_CLASSINFO(ClassName,ClassProto)</span> <a name="l00337"></a>00337 <span class="preprocessor"></span> <a name="l00338"></a>00338 <span class="preprocessor">#define IMPLEMENT_PROTOTYPE_WITH_PARENT(ClassProto,ClassFunc,ParentProto) \</span> <a name="l00339"></a>00339 <span class="preprocessor"> KJS::Value KJS::ClassProto::get(KJS::ExecState *exec, const KJS::Identifier &propertyName) const \</span> <a name="l00340"></a>00340 <span class="preprocessor"> { \</span> <a name="l00341"></a>00341 <span class="preprocessor"> </span><span class="comment">/*fprintf( stderr, "%sProto::get(%s) [in macro]\n", info.className, propertyName.ascii());*/</span> \ <a name="l00342"></a>00342 KJS::Value val = lookupGetFunction<ClassFunc,KJS::ObjectImp>(exec, propertyName, &ClassProto##Table, this ); \ <a name="l00343"></a>00343 if ( val.type() != UndefinedType ) return val; \ <a name="l00344"></a>00344 <span class="comment">/* Not found -> forward request to "parent" prototype */</span> \ <a name="l00345"></a>00345 return ParentProto::self(exec).get( exec, propertyName ); \ <a name="l00346"></a>00346 } \ <a name="l00347"></a>00347 bool KJS::ClassProto::hasProperty(KJS::ExecState *exec, const KJS::Identifier &propertyName) const \ <a name="l00348"></a>00348 { \ <a name="l00349"></a>00349 if (KJS::ObjectImp::hasProperty(exec, propertyName)) \ <a name="l00350"></a>00350 return true; \ <a name="l00351"></a>00351 return ParentProto::self(exec).hasProperty(exec, propertyName); \ <a name="l00352"></a>00352 } <a name="l00353"></a>00353 <a name="l00354"></a>00354 <span class="preprocessor">#define PUBLIC_IMPLEMENT_PROTOTYPE_WITH_PARENT(ClassProto,ClassName,ClassFunc,ParentProto) \</span> <a name="l00355"></a>00355 <span class="preprocessor"> IMPLEMENT_PROTOTYPE_WITH_PARENT(ClassProto,ClassFunc,ParentProto) \</span> <a name="l00356"></a>00356 <span class="preprocessor"> IMPLEMENT_CLASSINFO(ClassName,ClassProto)</span> <a name="l00357"></a>00357 <span class="preprocessor"></span> <a name="l00358"></a>00358 <span class="preprocessor">#define IMPLEMENT_PROTOFUNC(ClassFunc) \</span> <a name="l00359"></a>00359 <span class="preprocessor"> namespace KJS { \</span> <a name="l00360"></a>00360 <span class="preprocessor"> class ClassFunc : public ObjectImp { \</span> <a name="l00361"></a>00361 <span class="preprocessor"> public: \</span> <a name="l00362"></a>00362 <span class="preprocessor"> ClassFunc(KJS::ExecState *exec, int i, int len) \</span> <a name="l00363"></a>00363 <span class="preprocessor"> : ObjectImp( </span><span class="comment">/*proto? */</span> ), id(i) { \ <a name="l00364"></a>00364 KJS::Value protect(this); \ <a name="l00365"></a>00365 put(exec,lengthPropertyName,Number(len),DontDelete|ReadOnly|DontEnum); \ <a name="l00366"></a>00366 } \ <a name="l00367"></a>00367 virtual bool implementsCall() const { return true; } \ <a name="l00368"></a>00368 \ <a name="l00369"></a>00369 virtual KJS::Value call(KJS::ExecState *exec, KJS::Object &thisObj, const KJS::List &args); \ <a name="l00370"></a>00370 private: \ <a name="l00371"></a>00371 int id; \ <a name="l00372"></a>00372 }; \ <a name="l00373"></a>00373 } <a name="l00374"></a>00374 <a name="l00375"></a>00375 <span class="comment">// To be used in all call() implementations, before casting the type of thisObj</span> <a name="l00376"></a>00376 <span class="preprocessor">#define KJS_CHECK_THIS( ClassName, theObj ) \</span> <a name="l00377"></a>00377 <span class="preprocessor"> if (!theObj.isValid() || !theObj.inherits(&ClassName::info)) { \</span> <a name="l00378"></a>00378 <span class="preprocessor"> KJS::UString errMsg = "Attempt at calling a function that expects a "; \</span> <a name="l00379"></a>00379 <span class="preprocessor"> errMsg += ClassName::info.className; \</span> <a name="l00380"></a>00380 <span class="preprocessor"> errMsg += " on a "; \</span> <a name="l00381"></a>00381 <span class="preprocessor"> errMsg += thisObj.className(); \</span> <a name="l00382"></a>00382 <span class="preprocessor"> KJS::Object err = KJS::Error::create(exec, KJS::TypeError, errMsg.ascii()); \</span> <a name="l00383"></a>00383 <span class="preprocessor"> exec->setException(err); \</span> <a name="l00384"></a>00384 <span class="preprocessor"> return err; \</span> <a name="l00385"></a>00385 <span class="preprocessor"> }</span> <a name="l00386"></a>00386 <span class="preprocessor"></span> <a name="l00387"></a>00387 <span class="comment">/*</span> <a name="l00388"></a>00388 <span class="comment"> * List of things to do when porting an objectimp to the 'static hashtable' mechanism:</span> <a name="l00389"></a>00389 <span class="comment"> * - write the hashtable source, between @begin and @end</span> <a name="l00390"></a>00390 <span class="comment"> * - add a rule to build the .lut.h</span> <a name="l00391"></a>00391 <span class="comment"> * - include the .lut.h</span> <a name="l00392"></a>00392 <span class="comment"> * - mention the table in the classinfo (add a classinfo if necessary)</span> <a name="l00393"></a>00393 <span class="comment"> * - write/update the class enum (for the tokens)</span> <a name="l00394"></a>00394 <span class="comment"> * - turn get() into getValueProperty(), put() into putValueProperty(), using a switch and removing funcs</span> <a name="l00395"></a>00395 <span class="comment"> * - write get() and/or put() using a template method</span> <a name="l00396"></a>00396 <span class="comment"> * - cleanup old stuff (e.g. hasProperty)</span> <a name="l00397"></a>00397 <span class="comment"> * - compile, test, commit ;)</span> <a name="l00398"></a>00398 <span class="comment"> */</span> <a name="l00399"></a>00399 } <span class="comment">// namespace</span> <a name="l00400"></a>00400 <a name="l00401"></a>00401 <span class="preprocessor">#endif</span> </pre></div></div> </div> </div></div> </td> </tr> <tr> <td valign="top" id="leftmenu" width="25%"> <a name="navigation"></a> <div class="menu_box"><h2>kjs</h2> <div class="nav_list"> <ul><li><a href="index.html">Main Page</a></li><li><a href="hierarchy.html">Class Hierarchy</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="files.html">File List</a></li><li><a href="functions.html">Class Members</a></li><li><a href="pages.html">Related Pages</a></li></ul> <!-- <h2>Class Picker</h2> <div style="text-align: center;"> <form name="guideform"> <select name="guidelinks" style="width:100%;" onChange="window.location=document.guideform.guidelinks.options[document.guideform.guidelinks.selectedIndex].value"> <option value="annotated.html">-- Choose --</option> <option value="classKJS_1_1BinaryLogicalNode.html">kjs::binarylogicalnode</option>, <option value="classKJS_1_1Boolean.html">kjs::boolean</option>, <option value="classKJS_1_1Collector.html">kjs::collector</option>, <option value="classKJS_1_1Completion.html">kjs::completion</option>, <option value="classKJS_1_1ConditionalNode.html">kjs::conditionalnode</option>, <option value="classKJS_1_1Context.html">kjs::context</option>, <option value="classKJS_1_1ContextImp.html">kjs::contextimp</option>, <option value="classKJS_1_1CString.html">kjs::cstring</option>, <option value="classKJS_1_1Error.html">kjs::error</option>, <option value="classKJS_1_1ExecState.html">kjs::execstate</option>, <option value="classKJS_1_1FunctionImp.html">kjs::functionimp</option>, <option value="classKJS_1_1FunctionPrototypeImp.html">kjs::functionprototypeimp</option>, <option value="classKJS_1_1Identifier.html">kjs::identifier</option>, <option value="classKJS_1_1InternalFunctionImp.html">kjs::internalfunctionimp</option>, <option value="classKJS_1_1Interpreter.html">kjs::interpreter</option>, <option value="classKJS_1_1LabelStack.html">kjs::labelstack</option>, <option value="classKJS_1_1List.html">kjs::list</option>, <option value="classKJS_1_1ListIterator.html">kjs::listiterator</option>, <option value="classKJS_1_1Lookup.html">kjs::lookup</option>, <option value="classKJS_1_1Null.html">kjs::null</option>, <option value="classKJS_1_1Number.html">kjs::number</option>, <option value="classKJS_1_1Object.html">kjs::object</option>, <option value="classKJS_1_1PropertyMap.html">kjs::propertymap</option>, <option value="classKJS_1_1Reference.html">kjs::reference</option>, <option value="classKJS_1_1ReferenceList.html">kjs::referencelist</option>, <option value="classKJS_1_1ReferenceListIterator.html">kjs::referencelistiterator</option>, <option value="classKJS_1_1SavedProperties.html">kjs::savedproperties</option>, <option value="classKJS_1_1ScopeChain.html">kjs::scopechain</option>, <option value="classKJS_1_1ScopeChainNode.html">kjs::scopechainnode</option>, <option value="classKJS_1_1String.html">kjs::string</option>, <option value="classKJS_1_1UCharReference.html">kjs::ucharreference</option>, <option value="classKJS_1_1Undefined.html">kjs::undefined</option>, <option value="classKJS_1_1UString.html">kjs::ustring</option>, <option value="classKJS_1_1Value.html">kjs::value</option>, <option value="classKJS_1_1ValueImp.html">kjs::valueimp</option>, </select> </form> </div> --> </div></div> <div class="menu_box"><h2>API Dox</h2> <div class="nav_list"> <ul> <li><a href="../../arts/html/index.html">arts</a></li><li><a href="../../dcop/html/index.html">dcop</a></li><li><a href="../../dnssd/html/index.html">dnssd</a></li><li><a href="../../interfaces/html/index.html">interfaces</a></li><li> <a href="../../interfaces/kimproxy/interface/html/index.html">interface</a></li><li> <a href="../../interfaces/kimproxy/library/html/index.html">library</a></li><li> <a href="../../interfaces/kspeech/html/index.html">kspeech</a></li><li> <a href="../../interfaces/ktexteditor/html/index.html">ktexteditor</a></li><li><a href="../../kabc/html/index.html">kabc</a></li><li><a href="../../kate/html/index.html">kate</a></li><li><a href="../../kcmshell/html/index.html">kcmshell</a></li><li><a href="../../kdecore/html/index.html">kdecore</a></li><li><a href="../../kded/html/index.html">kded</a></li><li><a href="../../kdefx/html/index.html">kdefx</a></li><li><a href="../../kdeprint/html/index.html">kdeprint</a></li><li><a href="../../kdesu/html/index.html">kdesu</a></li><li><a href="../../kdeui/html/index.html">kdeui</a></li><li><a href="../../kdoctools/html/index.html">kdoctools</a></li><li><a href="../../khtml/html/index.html">khtml</a></li><li><a href="../../kimgio/html/index.html">kimgio</a></li><li><a href="../../kinit/html/index.html">kinit</a></li><li><a href="../../kio/html/index.html">kio</a></li><li> <a href="../../kio/bookmarks/html/index.html">bookmarks</a></li><li> <a href="../../kio/httpfilter/html/index.html">httpfilter</a></li><li> <a href="../../kio/kfile/html/index.html">kfile</a></li><li> <a href="../../kio/kio/html/index.html">kio</a></li><li> <a href="../../kio/kioexec/html/index.html">kioexec</a></li><li> <a href="../../kio/kpasswdserver/html/index.html">kpasswdserver</a></li><li> <a href="../../kio/kssl/html/index.html">kssl</a></li><li><a href="../../kioslave/html/index.html">kioslave</a></li><li> <a href="../../kioslave/http/html/index.html">http</a></li><li><a href="../../kjs/html/index.html">kjs</a></li><li><a href="../../kmdi/html/index.html">kmdi</a></li><li> <a href="../../kmdi/kmdi/html/index.html">kmdi</a></li><li><a href="../../knewstuff/html/index.html">knewstuff</a></li><li><a href="../../kparts/html/index.html">kparts</a></li><li><a href="../../kresources/html/index.html">kresources</a></li><li><a href="../../kspell2/html/index.html">kspell2</a></li><li><a href="../../kunittest/html/index.html">kunittest</a></li><li><a href="../../kutils/html/index.html">kutils</a></li><li><a href="../../kwallet/html/index.html">kwallet</a></li><li><a href="../../libkmid/html/index.html">libkmid</a></li><li><a href="../../libkscreensaver/html/index.html">libkscreensaver</a></li> </ul></div></div> </td> </tr> </table> <span class="doNotDisplay"> <a href="http://www.kde.org/" accesskey="8">KDE Home</a> | <a href="http://accessibility.kde.org/" accesskey="9">KDE Accessibility Home</a> | <a href="http://www.kde.org/media/accesskeys.php" accesskey="0">Description of Access Keys</a> </span> <div style="height: 8px"></div> <div id="footer"> <div id="footer_left"> Maintained by <a href="mailto:groot@kde.org">Adriaan de Groot</a> and <a href="mailto:winter@kde.org">Allen Winter</a>. <br/> KDE and K Desktop Environment are trademarks of <a href="http://www.kde.org/areas/kde-ev/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> | <a href="http://www.kde.org/contact/impressum.php">Legal</a> </div> <div id="footer_right"><img src="/media/images/footer_right.png" style="margin: 0px" alt="" /></div> </div> <!-- WARNING: DO NOT SEND MAIL TO THE FOLLOWING EMAIL ADDRESS! YOU WILL BE BLOCKED INSTANTLY AND PERMANENTLY! <a href="mailto:aaaatrap-425acc3b5374943f@kde.org">Block me</a> WARNING END --> </body> </html>