gimp-procedural-db-query

Spencer Kimball & Peter Mattis

Description

Queries the procedural database for its contents using regular expression matching.

Help

This procedure queries the contents of the procedural database. It is supplied with seven arguments matching procedures on { name, blurb, help, author, copyright, date, procedure type}. 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.


Type

unknown

Parameters

Type Name Description
PF_VALUE name The regex for procedure name
PF_VALUE blurb The regex for procedure blurb
PF_VALUE help The regex for procedure help
PF_VALUE author The regex for procedure author
PF_VALUE copyright The regex for procedure copyright
PF_VALUE date The regex for procedure date
PF_VALUE proc-type The regex for procedure type: { 'Internal GIMP procedure', 'GIMP Plug-In', 'GIMP Extension', 'Temporary Procedure' }

Return

Type Name Description
PF_INT num-matches The number of matching procedures (num-matches >= 0)
unknown procedure-names The list of procedure names