mirror of
https://github.com/eclipse-cdt/cdt
synced 2025-04-23 14:42:11 +02:00
6acb6dbc70
- add org.eclipse.cdt.debug.application plugin which supports running CDT debugger as Eclipse application - add org.eclipse.cdt.debug.application.docs plugin which is the modified CDT docs - add org.eclipse.cdt.debug.standalone-feature which bundles the two aforementioned plugins - add org.eclipse.cdt.debug.standlone.source-feature Change-Id: I1a1ae855ab3912e678b7d9e3465e2fbbfe949e13 Reviewed-on: https://git.eclipse.org/r/25845 Reviewed-by: Jeff Johnston <jjohnstn@redhat.com> Tested-by: Jeff Johnston <jjohnstn@redhat.com>
150 lines
No EOL
6.7 KiB
HTML
150 lines
No EOL
6.7 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
|
|
<html lang="en">
|
|
|
|
<head>
|
|
<meta http-equiv="Content-Language" content="en-us">
|
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
<title>Searching for C/C++ elements</title>
|
|
<link rel="stylesheet" type="text/css" href="../help.css">
|
|
</head>
|
|
|
|
<body>
|
|
|
|
<div role="main"><h1>Searching for C/C++ elements</h1>
|
|
|
|
<p>The Stand-alone Debugger provides the ability to search through the source code of your
|
|
application. To do this, the Debugger indexes the source code using the include paths and
|
|
macros used to build the application. If your application is built using the default include
|
|
paths and no additional user-defined flags, then there is nothing you need to do to make the
|
|
search work accurately. In the case where your application has additional include paths and
|
|
user-defined flags specified in the build, you need to either use the -g3 flag to include macro
|
|
information or else you need to provide the Stand-alone Debugger with a copy of the build log.
|
|
The build log can be provided on the command line using the <strong>-b</strong> option or via
|
|
the <strong>File > New Executable...</strong> dialog. If you do not set this up properly,
|
|
various operations such as searching, type hierarchy, and hover display may be inaccurate.</p>
|
|
|
|
<p>See <a href="../concepts/cdt_c_search.htm">C/C++ search</a>, for more information on:</p>
|
|
|
|
<ul>
|
|
<li>What you can search for</li>
|
|
<li>How to limit your search</li>
|
|
<li>How to use wildcard characters in your search</li>
|
|
<li>Syntax examples</li>
|
|
</ul>
|
|
|
|
|
|
|
|
<p>Performing a C/C++ Search can be done in a number of different ways but regardless of the manner chosen the same information must be provided to C/C++ Search.</p>
|
|
|
|
The info required to do a search is:
|
|
|
|
<table border="1" cellpadding="4" cellspacing="0" valign="top" bordercolor="#DDDDDD" width="700px" summary="Search options">
|
|
<tr>
|
|
<th id="option" style="width:25%" scope="col">Option</th>
|
|
<th id="explanation" style="width:75%" scope="col">Explanation</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" headers="option"><strong>Search string</strong></td>
|
|
<td valign="top" headers="explanation">this is the name of the element you are looking for. See <a href="../concepts/cdt_c_search.htm">C/C++ search</a> for more information on how to specify wildcard searches and how to further refine your searches by using fully qualified names</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" headers="option"><strong>Search For </strong></td>
|
|
<td valign="top" headers="explanation">this is the element type that you wish to search for. You can also select to search on 'Any Element' which will perform the search on a combination of all elements</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" headers="option"><strong>Limit To</strong></td>
|
|
<td valign="top" headers="explanation">this allows you to limit your search to declarations, definitions or references. You can also select 'All Occurrences' which will search for declarations, definitions and references that match the element</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" headers="option"><strong>Scope</strong></td>
|
|
<td valign="top" headers="explanation">this allows the user to limit the scope of the search. The three available scopes are:
|
|
<table cellpadding="2">
|
|
<tr class="hidden">
|
|
<th id="scope"> Scope</th>
|
|
<th id="description">Description</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" headers="scope"><strong>Workspace</strong></td>
|
|
<td valign="top" headers="description">this searches all of the open projects in the workspace</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" headers="scope"><strong>Selected Resources</strong></td>
|
|
<td valign="top" headers="description">this option becomes enabled whenever something is selected in one of the following views in the C/C++ perspective:
|
|
<ul>
|
|
<li>C/C++ Projects</li>
|
|
<li>Project Explorer</li>
|
|
<li>Search</li>
|
|
<li>Outline</li>
|
|
</ul>
|
|
<p>The scope will be limited to whatever element is selected in the view.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" headers="scope"><strong>Working Set</strong></td>
|
|
<td valign="top" headers="description">working sets can be selected and created </td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>There are 3 main ways for initiating a C/C++ search:
|
|
<ul>
|
|
<li>Using the <strong>C/C++ Search</strong> dialog</li>
|
|
<li>Selecting an element in the <strong>Editor</strong> view</li>
|
|
<li>Selecting an element in the <strong>C/C++ Projects</strong> view or Selecting an element from the <strong>Outline</strong> view</li>
|
|
</ul>
|
|
<br>
|
|
<br>
|
|
|
|
<h2>Using the C/C++ Search dialog</h2>
|
|
<p> <img src="../images/search.png" alt="Search dialog box"></p>
|
|
|
|
<ol>
|
|
<li>Enter the search string in the <strong>Search String</strong> field (optional mark it case sensitive). <br>
|
|
<strong>Note: </strong>that previous search queries (from the same work session) are remembered and can be accessed via the drop down list.</li>
|
|
<li>Select the <strong>Search For</strong> element.</li>
|
|
<li>Select the <strong>Limit To</strong>.</li>
|
|
<li>Select the <strong>Scope</strong>.</li>
|
|
<li>Press <strong>Search</strong>.</li>
|
|
</ol>
|
|
<p>Results are displayed in the <a href="../reference/cdt_u_search_view.htm">Search</a> view.</p>
|
|
|
|
|
|
<h2>Selecting an element in the Editor view</h2>
|
|
<ol>
|
|
<li>Select the desired element in the editor.</li>
|
|
<li>Right click and select <strong>All Declarations</strong> or <strong>All References</strong> and the scope you wish to search.</li>
|
|
</ol>
|
|
<p>Results are displayed in the <strong>Search</strong> view.</p>
|
|
|
|
<h2>Selecting an element in C/C++ Projects or Outline View</h2>
|
|
|
|
<ol>
|
|
<li>Select the desired element in the tree.</li>
|
|
<li>Right click and select <strong>All Declarations</strong> or <strong>All References</strong> and the scope you wish to search.</li>
|
|
</ol>
|
|
<p>Results are displayed in the <strong>Search</strong> view.</p>
|
|
|
|
|
|
<p><img src="../images/ngconcepts.gif" ALT="Related concepts" width="143" height="21">
|
|
<br>
|
|
<a href="../concepts/cdt_c_search.htm">C/C++ search</a><br>
|
|
<a href="../concepts/cdt_c_indexer.htm">C/C++ Indexer</a><br>
|
|
<a href="../concepts/cdt_c_projects.htm">C/C++ Projects</a><br>
|
|
<a href="../concepts/cdt_c_open_declarations.htm">Open Declaration</a><br>
|
|
</p>
|
|
|
|
<p><img src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21"><br>
|
|
<a href="cdt_t_sel_search.htm">Selection Searching for C/C++ elements</a><br>
|
|
<a href="cdt_t_open_declarations.htm">Navigate to C/C++ declarations</a><br>
|
|
</p>
|
|
|
|
<p><img src="../images/ngref.gif" ALT="Related reference" width="143" height="21">
|
|
<br>
|
|
<a href="../reference/cdt_u_search.htm">C/C++ search page, Search dialog box</a></p>
|
|
<hr >
|
|
<img src="../images/ng00_07.gif" ALT="IBM Copyright Statement" >
|
|
</div></body>
|
|
|
|
</html> |