PageRenderTime 47ms CodeModel.GetById 20ms RepoModel.GetById 0ms app.codeStats 0ms

/php/quickhashstringinthash.loadfromfile.html

https://bitbucket.org/stillzhl/manuals
HTML | 195 lines | 162 code | 33 blank | 0 comment | 0 complexity | dab86a62830ad6d3cc06756a4363d83f MD5 | raw file
    

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
    2. 

  2. <html>
    3. 

  3.  <head>
    4. 

  4.   <meta http-equiv="content-type" content="text/html; charset=UTF-8">
    5. 

  5.   <title>This factory method creates a hash from a file</title>
    6. 

  6. 

  7.  </head>
    8. 

  8.  <body><div class="manualnavbar" style="text-align: center;">
    9. 

  9.  <div class="prev" style="text-align: left; float: left;"><a href="quickhashstringinthash.getsize.html">QuickHashStringIntHash::getSize</a></div>
    10. 

  10.  <div class="next" style="text-align: right; float: right;"><a href="quickhashstringinthash.loadfromstring.html">QuickHashStringIntHash::loadFromString</a></div>
    11. 

  11.  <div class="up"><a href="class.quickhashstringinthash.html">QuickHashStringIntHash</a></div>
    12. 

  12.  <div class="home"><a href="index.html">PHP Manual</a></div>
    13. 

  13. </div><hr /><div id="quickhashstringinthash.loadfromfile" class="refentry">
    14. 

  14.  <div class="refnamediv">
    15. 

  15.   <h1 class="refname">QuickHashStringIntHash::loadFromFile</h1>
    16. 

  16.   <p class="verinfo">(No version information available, might only be in SVN)</p><p class="refpurpose"><span class="refname">QuickHashStringIntHash::loadFromFile</span> &mdash; <span class="dc-title">This factory method creates a hash from a file</span></p>
    17. 

  17. 

  18.  </div>
    19. 

  19. 

  20.  <div class="refsect1 description" id="refsect1-quickhashstringinthash.loadfromfile-description">
    21. 

  21.   <h3 class="title">说明</h3>
    22. 

  22.   <div class="methodsynopsis dc-description">
    23. 

  23.    <span class="modifier">public</span> <span class="modifier">static</span> <span class="type"><a href="class.quickhashstringinthash.html" class="type QuickHashStringIntHash">QuickHashStringIntHash</a></span> <span class="methodname"><strong>QuickHashStringIntHash::loadFromFile</strong></span>
    24. 

  24.     ( <span class="methodparam"><span class="type">string</span> <code class="parameter">$filename</code></span>
    25. 

  25.    [, <span class="methodparam"><span class="type">int</span> <code class="parameter">$size</code><span class="initializer"> = 0</span></span>
    26. 

  26.    [, <span class="methodparam"><span class="type">int</span> <code class="parameter">$options</code><span class="initializer"> = 0</span></span>
    27. 

  27.   ]] )</div>
    28. 

  28. 

  29.   <p class="para rdfs-comment">
    30. 

  30.    This factory method creates a new hash from a definition file on disk. The
    31. 

  31.    file format consists of a signature &#039;QH\0x21\0&#039;, the number of elements as
    32. 

  32.    a 32 bit signed integer in system Endianness, an unsigned 32 bit integer
    33. 

  33.    containing the number of element data to follow in characters. This element
    34. 

  34.    data contains all the strings. The follows another signed 32 bit integer
    35. 

  35.    containing the number of bucket lists.  After the header and the strings,
    36. 

  36.    the elements follow. They are ordered by bucket list so that the keys don&#039;t
    37. 

  37.    have to be hashed in order to restore the hash. For each bucket list, the
    38. 

  38.    following information is stored (all as 32 bit integers): the bucket list
    39. 

  39.    index, the number of elements in that list, and then in pairs of two
    40. 

  40.    unsigned 32 bit integers the elements, where the first one is the index
    41. 

  41.    into the string list containing the keys, and the second one the value.  An
    42. 

  42.    example could be:
    43. 

  43.   </p>
    44. 

  44.   <p class="para">
    45. 

  45.    <div class="example" id="example-4915">
    46. 

  46.     <p><strong>Example #1 QuickHash StringIntHash file format</strong></p>
    47. 

  47.     <div class="example-contents screen"><div class="descriptioncode"><pre class="descriptioncode">00000000  51 48 21 00 02 00 00 00  09 00 00 00 40 00 00 00  |QH!.........@...|
    48. 

  48. 00000010  4f 4e 45 00 4e 49 4e 45  00 07 00 00 00 01 00 00  |ONE.NINE........|
    49. 

  49. 00000020  00 00 00 00 00 01 00 00  00 2f 00 00 00 01 00 00  |........./......|
    50. 

  50. 00000030  00 04 00 00 00 03 00 00  00                       |.........|
    51. 

  51. 00000039</pre>
    52. 

  52. </div></div>
    53. 

  53.    </div>
    54. 

  54.   </p>
    55. 

  55.   <p class="para">
    56. 

  56.    <div class="example" id="example-4916">
    57. 

  57.     <p><strong>Example #2 QuickHash IntHash file format</strong></p>
    58. 

  58.     <div class="example-contents screen"><div class="descriptioncode"><pre class="descriptioncode">header signature (&#039;QH&#039;; key type: 2; value type: 1; filler: \0x00)
    59. 

  59. 00000000  51 48 21 00
    60. 

  60. 

  61. number of elements:
    62. 

  62. 00000004  02 00 00 00
    63. 

  63. 

  64. length of string values (9 characters):
    65. 

  65. 00000008  09 00 00 00
    66. 

  66. 

  67. number of hash bucket lists (this is configured for hashes as argument to the
    68. 

  68. constructor normally, 64 in this case):
    69. 

  69. 0000000C  40 00 00 00
    70. 

  70. 

  71. string values:
    72. 

  72. 00000010  4f 4e 45 00 4e 49 4e 45  00
    73. 

  73. 

  74. bucket lists:
    75. 

  75.   bucket list 1 (with key 7, and 1 element):
    76. 

  76.     header:
    77. 

  77.     07 00 00 00 01 00 00 00
    78. 

  78.     elements (key index: 0 (&#039;ONE&#039;), value = 0):
    79. 

  79.     00 00 00 00 01 00 00 00
    80. 

  80.   bucket list 2 (with key 0x2f, and 1 element):
    81. 

  81.     header:
    82. 

  82.     2f 00 00 00 01 00 00 00
    83. 

  83.     elements (key index: 4 (&#039;NINE&#039;), value = 3):
    84. 

  84.     04 00 00 00 03 00 00 00</pre>
    85. 

  85. </div></div>
    86. 

  86.    </div>
    87. 

  87.   </p>
    88. 

  88.  </div>
    89. 

  89. 

  90. 

  91.  <div class="refsect1 parameters" id="refsect1-quickhashstringinthash.loadfromfile-parameters">
    92. 

  92.   <h3 class="title">参数</h3>
    93. 

  93.   <p class="para">
    94. 

  94.    <dl>
    95. 

  95. 

  96.     <dt>
    97. 

  97. 

  98.      <span class="term"><em><code class="parameter">filename</code></em></span>
    99. 

  99.      <dd>
    100. 

  100. 

  101.       <p class="para">
    102. 

  102.        The filename of the file to read the hash from.
    103. 

  103.       </p>
    104. 

  104.      </dd>
    105. 

  105. 

  106.     </dt>
    107. 

  107. 

  108.     <dt>
    109. 

  109. 

  110.      <span class="term"><em><code class="parameter">size</code></em></span>
    111. 

  111.      <dd>
    112. 

  112. 

  113.       <p class="para">
    114. 

  114.        The amount of bucket lists to configure. The number you pass in will be
    115. 

  115.        automatically rounded up to the next power of two. It is also
    116. 

  116.        automatically limited from 4 to 4194304.
    117. 

  117.       </p>
    118. 

  118.      </dd>
    119. 

  119. 

  120.     </dt>
    121. 

  121. 

  122.     <dt>
    123. 

  123. 

  124.      <span class="term"><em><code class="parameter">options</code></em></span>
    125. 

  125.      <dd>
    126. 

  126. 

  127.       <p class="para">
    128. 

  128.        The same options that the class&#039; constructor takes; except that the size
    129. 

  129.        option is ignored. It is read from the file format (unlike the
    130. 

  130.        QuickHashIntHash and QuickHashIntStringHash classes, where it is
    131. 

  131.        automatically calculated from the number of entries in the hash.)
    132. 

  132.       </p>
    133. 

  133.      </dd>
    134. 

  134. 

  135.     </dt>
    136. 

  136. 

  137.    </dl>
    138. 

  138. 

  139.   </p>
    140. 

  140.  </div>
    141. 

  141. 

  142. 

  143.  <div class="refsect1 returnvalues" id="refsect1-quickhashstringinthash.loadfromfile-returnvalues">
    144. 

  144.   <h3 class="title">返回值</h3>
    145. 

  145.   <p class="para">
    146. 

  146.    Returns a new QuickHashStringIntHash.
    147. 

  147.   </p>
    148. 

  148.  </div>
    149. 

  149. 

  150. 

  151.  <div class="refsect1 examples" id="refsect1-quickhashstringinthash.loadfromfile-examples">
    152. 

  152.   <h3 class="title">范例</h3>
    153. 

  153.   <p class="para">
    154. 

  154.    <div class="example" id="example-4917">
    155. 

  155.     <p><strong>Example #3  <span class="function"><strong>QuickHashStringIntHash::loadFromFile()</strong></span> example</strong></p>
    156. 

  156.     <div class="example-contents">
    157. 

  157. <div class="phpcode"><code><span style="color: #000000">
    158. 

  158. <span style="color: #0000BB">&lt;?php<br />$file&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">dirname</span><span style="color: #007700">(&nbsp;</span><span style="color: #0000BB">__FILE__&nbsp;</span><span style="color: #007700">)&nbsp;.&nbsp;</span><span style="color: #DD0000">"/simple.hash.string"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$hash&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">QuickHashStringIntHash</span><span style="color: #007700">::</span><span style="color: #0000BB">loadFromFile</span><span style="color: #007700">(<br />&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">$file</span><span style="color: #007700">,<br />&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">QuickHashStringIntHash</span><span style="color: #007700">::</span><span style="color: #0000BB">DO_NOT_USE_ZEND_ALLOC<br /></span><span style="color: #007700">);<br />foreach(&nbsp;</span><span style="color: #0000BB">range</span><span style="color: #007700">(&nbsp;</span><span style="color: #0000BB">0</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">0x0f&nbsp;</span><span style="color: #007700">)&nbsp;as&nbsp;</span><span style="color: #0000BB">$key&nbsp;</span><span style="color: #007700">)<br />{<br />&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">$i&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">48712&nbsp;</span><span style="color: #007700">+&nbsp;</span><span style="color: #0000BB">$key&nbsp;</span><span style="color: #007700">*&nbsp;</span><span style="color: #0000BB">1631</span><span style="color: #007700">;<br />&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">$k&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">base_convert</span><span style="color: #007700">(&nbsp;</span><span style="color: #0000BB">$i</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">10</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">36&nbsp;</span><span style="color: #007700">);<br />&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;</span><span style="color: #0000BB">$k</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'&nbsp;=&gt;&nbsp;'</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$hash</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">get</span><span style="color: #007700">(&nbsp;</span><span style="color: #0000BB">$k&nbsp;</span><span style="color: #007700">),&nbsp;</span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?&gt;</span>
    159. 

  159. </span>
    160. 

  160. </code></div>
    161. 

  161.     </div>
    162. 

  162. 

  163.     <div class="example-contents"><p>以上例程的输出类似于：</p></div>
    164. 

  164.     <div class="example-contents screen">
    165. 

  165. <div class="cdata"><pre>
    166. 

  166. 11l4 =&gt; 48712
    167. 

  167. 12uf =&gt; 50343
    168. 

  168. 143q =&gt; 51974
    169. 

  169. 15d1 =&gt; 53605
    170. 

  170. 16mc =&gt; 55236
    171. 

  171. 17vn =&gt; 56867
    172. 

  172. 194y =&gt; 58498
    173. 

  173. 1ae9 =&gt; 60129
    174. 

  174. 1bnk =&gt; 61760
    175. 

  175. 1cwv =&gt; 63391
    176. 

  176. 1e66 =&gt; 65022
    177. 

  177. 1ffh =&gt; 66653
    178. 

  178. 1gos =&gt; 68284
    179. 

  179. 1hy3 =&gt; 69915
    180. 

  180. 1j7e =&gt; 71546
    181. 

  181. 1kgp =&gt; 73177
    182. 

  182. </pre></div>
    183. 

  183.     </div>
    184. 

  184.    </div>
    185. 

  185.   </p>
    186. 

  186.  </div>
    187. 

  187. 

  188. 

  189. 

  190. </div><hr /><div class="manualnavbar" style="text-align: center;">
    191. 

  191.  <div class="prev" style="text-align: left; float: left;"><a href="quickhashstringinthash.getsize.html">QuickHashStringIntHash::getSize</a></div>
    192. 

  192.  <div class="next" style="text-align: right; float: right;"><a href="quickhashstringinthash.loadfromstring.html">QuickHashStringIntHash::loadFromString</a></div>
    193. 

  193.  <div class="up"><a href="class.quickhashstringinthash.html">QuickHashStringIntHash</a></div>
    194. 

  194.  <div class="home"><a href="index.html">PHP Manual</a></div>
    195. 

  195. </div></body></html>
    196. 

  196.