query_procedures

Description:

[ CCode ( array_length = false , array_null_terminated = true ) ]
[ Version ( since = "3.0" ) ]
public string[] query_procedures (string name, string blurb, string help, string help_id, string authors, string copyright, string date, string proc_type)

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

This function queries the contents of the procedural database. It is supplied with eight arguments matching procedures on

{ name, blurb, help, help-id, authors, 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.

Parameters:

this	A PDB.
name	The regex for procedure name.
blurb	The regex for procedure blurb.
help	The regex for procedure help.
help_id	The regex for procedure help-id.
authors	The regex for procedure authors.
copyright	The regex for procedure copyright.
date	The regex for procedure date.
proc_type	The regex for procedure type: { 'Internal GIMP procedure', 'GIMP Plug-in', 'GIMP Extension', 'Temporary Procedure' }.

Returns:

The list of procedure names. Free with strfreev.