carbidecpp22devenv/configuration/org.eclipse.osgi/bundles/309/1/.cp/tasks/cdt_t_search.htm
author cawthron
Fri, 04 Dec 2009 10:01:33 -0600
changeset 5 684bf18fdedf
permissions -rw-r--r--
add files for RCL_2_2
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
5
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     2
<html lang="en">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     3
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     4
<head>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     5
<meta http-equiv="Content-Language" content="en-us">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     6
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     7
<title>Searching for C/C++ elements</title>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     8
<link rel="stylesheet" type="text/css" href="../help.css">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     9
</head>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    10
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    11
<body>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    12
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    13
<h1>Searching for C/C++ elements</h1>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    14
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    15
<p>It is recommended that you perform searches on successfully compiled 
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    16
programs to ensure the accuracy of search results. It is important to familiarize yourself with the correct search syntax 
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    17
to use to complete an effective search. It is also important to ensure that 
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    18
include paths and symbols are correctly defined. For more information, see
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    19
<a href="cdt_t_proj_paths.htm">Including paths and symbols</a>.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    20
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    21
<p>See <a href="../concepts/cdt_c_search.htm">C/C++ search</a>, for more information on:</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    22
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    23
<ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    24
  <li>What you can search for</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    25
  <li>How to limit your search</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    26
  <li>How to use wildcard characters in your search</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    27
  <li>Syntax examples</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    28
</ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    29
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    30
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    31
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    32
<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> 
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    33
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    34
The info required to do a search is:
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    35
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    36
<table border="1"  cellpadding="2" valign="top">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    37
	<tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    38
		<td valign="top"><b>Search string</b></td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    39
		<td valign="top">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>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    40
	</tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    41
	<tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    42
		<td valign="top"><b>Search For </b></td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    43
		<td valign="top">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>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    44
	</tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    45
	<tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    46
		<td valign="top"><b>Limit To</b></td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    47
		<td valign="top">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>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    48
	</tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    49
	<tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    50
		<td valign="top"><b>Scope</b></td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    51
		<td valign="top">this allows the user to limit the scope of the search. The three available scopes are:
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    52
		<table border="0" cellpadding="2">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    53
			<tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    54
				<td valign="top"><b>Workspace</b></td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    55
				<td valign="top">this searches all of the open projects in the workspace</td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    56
			</tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    57
			<tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    58
				<td valign="top"><b>Selected Resources</b></td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    59
				<td valign="top">this option becomes enabled whenever something is selected in one of the following views in the C/C++ perspective:
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    60
				<ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    61
					<li>C/C++ Projects</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    62
					<li>Project Explorer</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    63
					<li>Search</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    64
					<li>Outline</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    65
				</ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    66
				<p>The scope will be limited to whatever element is selected in the view.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    67
				</td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    68
			</tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    69
			<tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    70
				<td valign="top"><b>Working Set</b></td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    71
				<td valign="top">working sets can be selected and created </td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    72
				</tr>		
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    73
			</table>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    74
		</td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    75
	</tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    76
</table>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    77
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    78
<p>There are 3 main ways for initiating a C/C++ search:
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    79
<ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    80
	<li>Using the <b>C/C++ Search</b> dialog</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    81
	<li>Selecting an element in the <b>Editor</b> view</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    82
	<li>Selecting an element in the <b>C/C++ Projects</b> view or Selecting an element from the <b>Outline</b> view</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    83
</ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    84
</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    85
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    86
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    87
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    88
<h3>Using the C/C++ Search dialog</h3>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    89
<p> <img src="../images/search.png"  alt="Search dialog box"></p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    90
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    91
<ol>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    92
	<li>Enter the search string in the <b>Search String</b> field (optional mark it case sensitive). <br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    93
	<b>Note: </b>that previous search queries (from the same work session) are remembered and can be accessed via the drop down list.</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    94
	<li>Select the <b>Search For</b> element.</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    95
	<li>Select the <b>Limit To</b>.</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    96
	<li>Select the <b>Scope</b>.</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    97
	<li>Press <b>Search</b>.</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    98
</ol>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    99
<p>Results are displayed in the <b>Search</b> view.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   100
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   101
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   102
<h3>Selecting an element in the Editor view</h3>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   103
<ol>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   104
	<li>Select the desired element in the editor.</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   105
	<li>Right click and select <b>All Declarations</b> or <b>All References</b> and the scope you wish to search.</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   106
</ol>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   107
<p>Results are displayed in the <b>Search</b> view.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   108
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   109
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   110
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   111
<h3>Selecting an element in C/C++ Projects or Outline View</h3>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   112
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   113
<ol>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   114
	<li>Select the desired element in the tree.</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   115
	<li>Right click and select <b>All Declarations</b> or <b>All References</b> and the scope you wish to search.</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   116
</ol>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   117
<p>Results are displayed in the <b>Search</b> view.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   118
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   119
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   120
<p>For more information, see:
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   121
<li><b>Workbench User Guide &gt; Concepts &gt; Views &gt; Search view</b></li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   122
<li><b>Workbench User Guide &gt; Concepts &gt; Workbench &gt; Working Set</b></li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   123
<li><b>Workbench User Guide &gt; Tasks &gt; Navigating and finding resources</b></li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   124
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   125
</ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   126
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   127
<p><img border="0" src="../images/ngconcepts.gif" ALT="Related concepts" width="143" height="21">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   128
<br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   129
<a href="../concepts/cdt_c_search.htm">C/C++ search</a><br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   130
<a href="../concepts/cdt_c_indexer.htm">C/C++ Indexer</a><br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   131
<a href="../concepts/cdt_c_projects.htm">CDT Projects</a><br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   132
<a href="../concepts/cdt_c_open_declarations.htm">Open Declaration</a><br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   133
</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   134
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   135
<p><img border="0" src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21"><br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   136
<a href="cdt_t_sel_search.htm">Selection Searching for C/C++ elements</a><br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   137
<a href="cdt_t_open_declarations.htm">Navigate to C/C++ declarations</a><br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   138
</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   139
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   140
<p><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   141
<br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   142
<a href="../reference/cdt_u_search.htm">C/C++ search page, Search dialog box</a></p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   143
<p>&nbsp;</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   144
<img src="../images/ng00_07.gif" ALT="IBM Copyright Statement" >
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   145
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   146
</body>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   147
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   148
</html>