fields.html 7.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  2. <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="utf-8" lang="utf-8">
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  5. <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=0" />
  6. <title>字段元数据 - CodeIgniter 中文手册|用户手册|用户指南|Wiki文档</title>
  7. <link rel="shortcut icon" href="http://codeigniter.org.cn/user_guide/../images/design/favicon.ico" type="image/x-icon" />
  8. <link rel="stylesheet" type="text/css" media="all" href="../userguide.css" />
  9. <link rel="search" href="http://codeigniter.org.cn/user_guide/../CodeIgniterSearch.xml" type="application/opensearchdescription+xml" title="CodeIgniter 搜索"/>
  10. <link rel="canonical" href="http://codeigniter.org.cn/user_guide/database/fields.html" />
  11. <script type="text/javascript" src="../nav/mootools.js-ver=20130324.js"></script>
  12. <script type="text/javascript" src="../nav/mootools-more.js-ver=20130324.js"></script>
  13. <script type="text/javascript" src="../nav/nav.js-ver=20130324.js"></script>
  14. <script type="text/javascript" src="../nav/user_guide_menu.js-ver=20130324.js"></script>
  15. <meta name="robots" content="all" />
  16. <meta name="author" content="ExpressionEngine Dev Team" />
  17. <meta name="description" content="CodeIgniter 中文手册, CodeIgniter 用户指南, CodeIgniter User Guide, Wiki 文档" />
  18. </head>
  19. <body>
  20. <!-- START NAVIGATION -->
  21. <div id="nav">
  22. <div id="nav_inner">
  23. <script type="text/javascript">create_menu('../');</script>
  24. </div>
  25. </div>
  26. <script type="text/javascript">_setNavigation();</script>
  27. <div id="nav2"><a name="top"></a><a href="javascript:void(0);" onclick="myHeight.toggle();"><img src="../images/nav_toggle_darker.jpg" width="154" height="43" border="0" title="切换目录" alt="切换目录" /></a></div>
  28. <div id="masthead" class="clearfix">
  29. <div class="topbar-hd"><h1>CodeIgniter 用户指南 版本 2.2.0</h1></div>
  30. <div class="topbar-tip">编辑文档、查看近期更改请 <a href="#">登录</a> 或 <a href="#">注册</a>  <a href="#">找回密码</a></div> <div id="breadcrumb_right"><a href="../toc.html">目录页</a></div>
  31. </div>
  32. <!-- END NAVIGATION -->
  33. <!-- START BREADCRUMB -->
  34. <table cellpadding="0" cellspacing="0" border="0" style="width:100%">
  35. <tr>
  36. <td id="breadcrumb">
  37. <a href="#" target="_blank">CodeIgniter 中国首页</a>&nbsp;&#8250;&nbsp;
  38. <a href="../index.html">用户指南首页</a>&nbsp;&#8250;&nbsp;<a href="index.html">数据库类</a>&nbsp;&#8250;&nbsp;字段元数据 </td>
  39. <td id="searchbox">
  40. <form method="get" action="http://www.google.com.hk/search" target="google_window">
  41. <input type="hidden" name="client" value="pub-0176846097796333"></input>
  42. <input type="hidden" name="forid" value="1"></input>
  43. <input type="hidden" name="ie" value="UTF-8"></input>
  44. <input type="hidden" name="oe" value="UTF-8"></input>
  45. <input type="hidden" name="as_sitesearch" id="as_sitesearch" value="codeigniter.org.cn/user_guide/" />
  46. 搜索用户指南&nbsp;
  47. <input type="text" class="input" style="width:200px;" name="q" id="q" size="31" maxlength="255" value="" />
  48. &nbsp;
  49. <input type="submit" class="submit" name="sa" value="Go" />
  50. </form>
  51. </td>
  52. </tr>
  53. </table>
  54. <!-- END BREADCRUMB -->
  55. <div style="clear:both;text-align:right;padding: 6px 40px 0 0;">
  56. <a href="#" target="_blank">查看原文</a>
  57. </div>
  58. <!--<br clear="all" />--><!-- START CONTENT -->
  59. <div id="content">
  60. <h1>字段数据</h1>
  61. <h2>$this-&gt;db-&gt;list_fields()</h2>
  62. <p>Returns an array containing the field names. This query can be called two ways:</p>
  63. <br>返回一个包含字段名称的数组。这个查询可以用两种方法调用:
  64. <br/><p>
  65. 1.您可以将表名称提供给<dfn>$this-&gt;db-&gt;list_fields()</dfn>调用。
  66. <code>
  67. $fields = $this-&gt;db-&gt;list_fields('table_name');<br /><br />
  68. foreach ($fields as $field)<br />
  69. &#123;<br />
  70. &nbsp;&nbsp;&nbsp;echo $field;<br />
  71. &#125;
  72. </code>
  73. <br/>
  74. 2.您可以将组合查询语句传递给query函数执行并返回:
  75. <code>
  76. $query = $this-&gt;db-&gt;query('SELECT * FROM some_table');
  77. <br /><br />
  78. foreach ($query-&gt;list_fields() as $field)<br />
  79. &#123;<br />
  80. &nbsp;&nbsp;&nbsp;echo $field;<br />
  81. &#125;
  82. </code>
  83. <h2>$this-&gt;db-&gt;field_exists()</h2>
  84. <p>Sometimes it's helpful to know whether a particular field exists before performing an action.
  85. Returns a boolean TRUE/FALSE. Usage example:</p>
  86. <br/>
  87. 在执行一个动作前就先确认某个特殊字段是否存在在某些时候非常有用。返回一个布尔值:TRUE/FALSE。实例:
  88. <code>
  89. if ($this-&gt;db-&gt;field_exists('field_name', 'table_name'))<br />
  90. &#123;<br />
  91. &nbsp;&nbsp; // some code...<br />
  92. &#125;
  93. </code>
  94. <p>Note: Replace <em>field_name</em> with the name of the column you are looking for, and replace
  95. <em>table_name</em> with the name of the table you are looking for.</p>
  96. <br/>
  97. 注解:替换<em>field_name</em>为您要查找的字段名称,同时替换<em>table_name</em>为您要查找表名。
  98. <h2>$this-&gt;db-&gt;field_data()</h2>
  99. <p>Returns an array of objects containing field information.</p>
  100. <br/>
  101. 返回一个包含字段信息的对象数组。
  102. <p>Sometimes it's helpful to gather the field names or other metadata, like the column type, max length, etc.</p>
  103. <br/>
  104. 收集字段的名称或者其它元数据在某些时候非常有用,例如列的数据类型、最大长度等。
  105. <p class="important">Note: Not all databases provide meta-data.</p>
  106. <br/>注解:并非所有数据库都提供元数据。
  107. <p>Usage example:</p>
  108. <br/>
  109. 例子:
  110. <code>
  111. $fields = $this-&gt;db-&gt;field_data('table_name');<br /><br />
  112. foreach ($fields as $field)<br />
  113. &#123;<br />
  114. &nbsp;&nbsp;&nbsp;echo $field-&gt;name;<br />
  115. &nbsp;&nbsp;&nbsp;echo $field-&gt;type;<br />
  116. &nbsp;&nbsp;&nbsp;echo $field-&gt;max_length;<br />
  117. &nbsp;&nbsp;&nbsp;echo $field-&gt;primary_key;<br />
  118. &#125;
  119. </code>
  120. <p>If you have run a query already you can use the result object instead of supplying the table name:</p>
  121. <br/>如果您想执行一个已有的查询时你可用返回项替换掉表格名称:
  122. <code>
  123. $query = $this-&gt;db-&gt;query("YOUR QUERY");<br />
  124. $fields = $query-&gt;field_data();
  125. </code>
  126. <p>The following data is available from this function if supported by your database:</p>
  127. <br/>
  128. 如果你的数据库支持,以下数据在这个函数中将是可用的:
  129. <ul>
  130. <li>name - 列名称</li>
  131. <li>max_length - 列的最大长度</li>
  132. <li>primary_key - 1 如果此列被定义为主键</li>
  133. <li>type - 指定列的数据类型</li>
  134. </ul><p>&nbsp;</p>
  135. <div id="Contributors">
  136. 翻译贡献者:
  137. analyzer, Drice, Hex, hui314, loiynet</div>
  138. <div id="DocDate">
  139. 最后修改: 2012-10-25 17:10:40</div>
  140. </div>
  141. <!-- END CONTENT -->
  142. <div id="footer">
  143. <p>
  144. 上一个主题:&nbsp;&nbsp;<a href="table_data.html">数据库表数据</a>&nbsp;&nbsp;&middot;&nbsp;&nbsp;<a href="#top">页首</a>
  145. &nbsp;&middot;&nbsp;&nbsp;<a href="../index.html">用户指南首页</a>&nbsp;&nbsp;&middot;&nbsp;&nbsp;下一个主题:&nbsp;&nbsp;<a href="call_function.html">自定义函数调用</a> </p>
  146. <p><a href="#">CodeIgniter</a> &nbsp;&middot;&nbsp; 版权所有 &#169; 2006-2013 &nbsp;&middot;&nbsp; <a href="#">Ellislab, Inc.</a></p>
  147. <p>中文化: <a href="#">CodeIgniter 中国</a> &nbsp;&middot;&nbsp; 制作: Hex &nbsp;&middot;&nbsp; 版本: 1.30 &nbsp;&middot;&nbsp; 鸣谢: 子非鱼</p>
  148. </div>
  149. </body>
  150. </html>