Procedure Search Language

JavaScript is not currently enabled, but is required for full CodeSonar manual search and browse functionality.

If you are viewing this file in your hub's Web GUI, enable JavaScript in your browser: you will also need it for GUI functionality.

If you opened this file directly from disk, your browser may be directly suppressing JavaScript functionality: certain browsers perform this suppression on local files (but not files delivered by web servers) for security reasons.

If you access the manual through the hub's Web GUI, the functionality will not be suppressed because the hub is a web server.
Alternatively, your browser may allow you to explicitly disable the security setting that suppresses functionality. See the CodeSonar FAQ for more information.

CodeSonar^® 9.2p0

CONFIDENTIAL

CodeSecure Inc

Procedure Search Language

The CodeSonar procedure search language allows you to specify search conditions based on various procedure properties, and provides basic logical operators for combining multiple conditions. It can be used both to specify and to refine searches.

Use with the simple search tool to specify a search in the procedure domain.
- With the procedures in these results domain/scope setting on the procedure search results page, will narrow the results of a previous search.
Use to interpret the procedure searches described on the Saved Searches page.

Note that procedure-domain searches are only available within the scope of a focal analysis, and the results will depend on procedure information availability.

Procedure-Specific Grammar

T : quoted-string
  | metric-condition
  | ilike-condition
  | imatch-condition
  | field-condition
  | ( T )
  | unary T
  | T binary T
  | T T
  | word
  
metric-condition : metric-tag ext-operator num
                 | metric-tag operator num-range

metric-tag : the tag of any procedure-granularity metric class (built-in or user-defined) on the hub 

ext-operator : <
             | <=
             | >=
             | >

field-name : directory
           | file
           | language
           | path
           | procedure

field-condition terms

field-name	Contents	Condition Type
directory	Procedure File . Directory	word \| quoted-string
file	Procedure File . File	word \| quoted-string
language	Procedure File . Language	word \| quoted-string
path	Procedure File . File Path	word \| quoted-string
procedure	Procedure	word \| quoted-string (case-sensitive)

field-name

Contents

Condition Type

example	explanation
vG:100..250	Find procedures with Cyclomatic Complexity (vG) between 100 and 250 (inclusive). Note that these procedures must belong to an analysis that computed vG[Procedure].
ab	Find procedures whose name includes (case-sensitive) substring ab.
ab cd	Find procedures whose name includes (case-sensitive) both substring ab and substring cd.
directory:module	Find procedures defined in any file in a directory whose path includes (case-insensitive) substring module.
file=foo.c	Find procedures defined in any file with (case-insensitive) basename foo.c.
language=C	Find procedures defined in files whose language is C (not C++).
path:src/mod1/bar.c	Find procedures defined in any file whose absolute name contains (case-insensitive) substring src/mod1/bar.c.
procedure:print	Find procedures whose name contains (case-sensitive) substring print.
procedure=FF	Find procedures whose name is (case-sensitive) FF.
procedure=~book.*open	Find procedures whose name contains the string 'book' and subsequently substring 'open' (case insensitive).
procedure=~~p%epd	Find procedures whose name starts with 'p' and ends with 'epd' (case insensitive).