File: udm-find.xml

package info (click to toggle)
php-doc 20100521-2
  • links: PTS, VCS
  • area: main
  • in suites: squeeze, wheezy
  • size: 59,992 kB
  • ctags: 4,085
  • sloc: xml: 796,833; php: 21,338; cpp: 500; sh: 117; makefile: 58; awk: 28
file content (112 lines) | stat: -rw-r--r-- 3,638 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 297028 $ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.udm-find">
 <refnamediv>
  <refname>udm_find</refname>
  <refpurpose>Perform search</refpurpose>
 </refnamediv>
 
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>resource</type><methodname>udm_find</methodname>
   <methodparam><type>resource</type><parameter>agent</parameter></methodparam>
   <methodparam><type>string</type><parameter>query</parameter></methodparam>
  </methodsynopsis>
  <para>
   Performs a search.
  </para>
  <para>
   The search itself. The first argument - session, the next one -
   query itself.  To find something just type words you want to find
   and press SUBMIT button.  For example, "mysql odbc". You should
   not use quotes " in query, they are written here only to divide a
   query from other text. mnoGoSearch will find all documents that
   contain word "mysql" and/or word "odbc".  Best documents having
   bigger weights will be displayed first.  If you use search mode
   ALL, search will return documents that contain both (or more)
   words you entered. In case you use mode ANY, the search will
   return list of documents that contain any of the words you
   entered.  If you want more advanced results you may use query
   language.  You should select "bool" match mode in the search
   from.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>agent</parameter></term>
     <listitem>
      <para>
       A link to Agent, received after call to
       <function>udm_alloc_agent</function>.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>query</parameter></term>
     <listitem>
      <para>
       mnoGoSearch understands the following boolean operators:
      </para>
      <para>
       &amp; - logical AND. For example, &quot;mysql &amp;
       odbc&quot;. mnoGoSearch will find any URLs that contain both
       &quot;mysql&quot; and &quot;odbc&quot;.
      </para>
      <para>
       | - logical OR. For example &quot;mysql|odbc&quot;. mnoGoSearch
       will find any URLs, that contain word &quot;mysql&quot; or word
       &quot;odbc&quot;.
      </para>
      <para>
       ~ - logical NOT. For example &quot;mysql &amp; ~odbc&quot;.
       mnoGoSearch will find URLs that contain word &quot;mysql&quot;
       and do not contain word &quot;odbc&quot; at the same time. Note
       that ~ just excludes given word from results.  Query
       &quot;~odbc&quot; will find nothing!
      </para>
      <para>
       () - group command to compose more complex queries.  For example
       &quot;(mysql | msql) &amp; ~postgres&quot;.  Query language is
       simple and powerful at the same time. Just consider query as
       usual boolean expression.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Returns a result link identifier on success&return.falseforfailure;.
  </para>
 </refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->