gimp_procedural_db_query (1995-1996)

NAME

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

SYNOPSIS

(num_matches,procedure_names) = gimp_procedural_db_query (name,blurb,help,author,copyright,date,proc_type)

DESCRIPTION

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.

INPUT ARGUMENTS

TYPE	NAME	DESCRIPTION
STRING	name	The regex for procedure name
STRING	blurb	The regex for procedure blurb
STRING	help	The regex for procedure help
STRING	author	The regex for procedure author
STRING	copyright	The regex for procedure copyright
STRING	date	The regex for procedure date
STRING	proc_type	The regex for procedure type: { 'Internal GIMP procedure', 'GIMP Plug-in', 'GIMP Extension' }

RETURN VALUES

TYPE	NAME	DESCRIPTION
INT32	num_matches	The number of matching procedures
STRINGARRAY	procedure_names	The list of procedure names

SOME SYNTAX ALTERNATIVES

procedure_names = Gimp->procedural_db_query (name,blurb,help,author,copyright,date,proc_type)
procedure_names = procedural_db_query Layer (name,blurb,help,author,copyright,date,proc_type)
procedure_names = procedural_db_query Image (name,blurb,help,author,copyright,date,proc_type)
procedure_names = procedural_db_query Channel (name,blurb,help,author,copyright,date,proc_type)
procedure_names = procedural_db_query Display (name,blurb,help,author,copyright,date,proc_type)
procedure_names = procedural_db_query Drawable (name,blurb,help,author,copyright,date,proc_type)

AUTHOR

Spencer Kimball & Peter Mattis
(c)1995-1996 Spencer Kimball & Peter Mattis