<?xml version="1.0"?>
<page id="Gimp.PDB.query_procedures"
      type="topic"
      style="method"
      xmlns="http://projectmallard.org/1.0/"
      xmlns:api="http://projectmallard.org/experimental/api/"
      xmlns:ui="http://projectmallard.org/1.0/ui/">
  <info>
    <link xref="Gimp.PDB" group="method" type="guide"/>
    <api:function>
      <api:returns>
        <api:type>[unicode]</api:type>
      </api:returns>
      <api:name>gimp_pdb_query_procedures</api:name>
      <api:arg>
        <api:type>Gimp.PDB</api:type>
        <api:name>self</api:name>
      </api:arg>
      <api:arg>
        <api:type>unicode</api:type>
        <api:name>name</api:name>
      </api:arg>
      <api:arg>
        <api:type>unicode</api:type>
        <api:name>blurb</api:name>
      </api:arg>
      <api:arg>
        <api:type>unicode</api:type>
        <api:name>help</api:name>
      </api:arg>
      <api:arg>
        <api:type>unicode</api:type>
        <api:name>help_id</api:name>
      </api:arg>
      <api:arg>
        <api:type>unicode</api:type>
        <api:name>authors</api:name>
      </api:arg>
      <api:arg>
        <api:type>unicode</api:type>
        <api:name>copyright</api:name>
      </api:arg>
      <api:arg>
        <api:type>unicode</api:type>
        <api:name>date</api:name>
      </api:arg>
      <api:arg>
        <api:type>unicode</api:type>
        <api:name>proc_type</api:name>
      </api:arg>
    </api:function>
  </info>
  <title>Gimp.PDB.query_procedures</title>
  <synopsis><code mime="text/x-python">
@accepts(Gimp.PDB, unicode, unicode, unicode, unicode, unicode, unicode, unicode, unicode)
@returns([unicode])
def query_procedures(self, name, blurb, help, help_id, authors, copyright, date, proc_type):
    # Python wrapper for gimp_pdb_query_procedures()
  </code></synopsis>
  <p>Queries the procedural database for its contents using regular
expression matching.</p>  <p>This function queries the contents of the procedural database. It
is supplied with eight arguments matching procedures on</p>  <p>{ name, blurb, help, help-id, authors, copyright, date, procedure type}.</p>  <p>This is accomplished using regular expression matching. For
instance, to find all procedures with "jpeg" listed in the blurb,
all seven arguments can be supplied as ".*", except for the second,
which can be supplied as ".*jpeg.*". There are two return arguments
for this procedure. The first is the number of procedures matching
the query. The second is a concatenated list of procedure names
corresponding to those matching the query. If no matching entries
are found, then the returned string is NULL and the number of
entries is 0.</p>
  <p>Since 3.0</p>
<terms>
<item>
<title><code>self</code></title>
  <p>A <link xref="Gimp.PDB"/>.</p>
</item>
<item>
<title><code>name</code></title>
  <p>The regex for procedure name.</p>
</item>
<item>
<title><code>blurb</code></title>
  <p>The regex for procedure blurb.</p>
</item>
<item>
<title><code>help</code></title>
  <p>The regex for procedure help.</p>
</item>
<item>
<title><code>help_id</code></title>
  <p>The regex for procedure help-id.</p>
</item>
<item>
<title><code>authors</code></title>
  <p>The regex for procedure authors.</p>
</item>
<item>
<title><code>copyright</code></title>
  <p>The regex for procedure copyright.</p>
</item>
<item>
<title><code>date</code></title>
  <p>The regex for procedure date.</p>
</item>
<item>
<title><code>proc_type</code></title>
  <p>The regex for procedure type: { 'Internal GIMP procedure', 'GIMP Plug-in', 'GIMP Extension', 'Temporary Procedure' }.</p>
</item>
<item>
<title><code>Returns</code></title>
{formatter.format(node, node.retval.doc)}
</item>
</terms>

</page>
