mirrors/cdt
1
0
Fork 0
mirror of https://github.com/eclipse-cdt/cdt synced 2025-04-23 14:42:11 +02:00
Code Issues Wiki Activity

Cosmetics.

Browse source
This commit is contained in:
Sergey Prigogin 2014-08-08 16:40:25 -07:00
parent ebac470813
commit 191b4111f8
2 changed files with 12 additions and 15 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

24
core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTNodeSelector.java
View file

@ -21,25 +21,25 @@ package org.eclipse.cdt.core.dom.ast;
*/ */
public interface IASTNodeSelector { public interface IASTNodeSelector {
/** /**
* Returns the name for the exact given range, or <code>null</code> if there is no such node. * Returns the name for the exact given range, or {@code null} if there is no such node.
* Will not return an implicit name. * Will not return an implicit name.
*/ */
IASTName findName(int offset, int length); IASTName findName(int offset, int length);
/** /**
* Returns the smallest name enclosing the given range, or <code>null</code> if there is * Returns the smallest name enclosing the given range, or {@code null} if there is
* no such node. Will not return an implicit name. * no such node. Will not return an implicit name.
*/ */
IASTName findEnclosingName(int offset, int length); IASTName findEnclosingName(int offset, int length);
/** /**
* Returns the first name contained in the given range, or <code>null</code> if there is * Returns the first name contained in the given range, or {@code null} if there is
* no such node. Will not return an implicit name. * no such node. Will not return an implicit name.
*/ */
IASTName findFirstContainedName(int offset, int length); IASTName findFirstContainedName(int offset, int length);
/** /**
* Returns the implicit name for the exact given range, or <code>null</code> if there is * Returns the implicit name for the exact given range, or {@code null} if there is
* no such node. * no such node.
* *
* Note that there can be more than one implicit name in the same location. * Note that there can be more than one implicit name in the same location.
@ -60,7 +60,7 @@ public interface IASTNodeSelector {
IASTImplicitName findEnclosingImplicitName(int offset, int length); IASTImplicitName findEnclosingImplicitName(int offset, int length);
/** /**
* Returns the node for the exact given range, or <code>null</code> if there is no such node. * Returns the node for the exact given range, or {@code null} if there is no such node.
* <p> * <p>
* For nodes with the same location, macro-expansions ({@link IASTPreprocessorMacroExpansion}) * For nodes with the same location, macro-expansions ({@link IASTPreprocessorMacroExpansion})
* are preferred over c/c++-nodes and children are preferred over their parents. * are preferred over c/c++-nodes and children are preferred over their parents.
@ -68,7 +68,7 @@ public interface IASTNodeSelector {
IASTNode findNode(int offset, int length); IASTNode findNode(int offset, int length);
/** /**
* Returns the smallest node enclosing the given range, or <code>null</code> if there is * Returns the smallest node enclosing the given range, or {@code null} if there is
* no such node. * no such node.
* <p> * <p>
* For nodes with the same location, macro-expansions ({@link IASTPreprocessorMacroExpansion}) * For nodes with the same location, macro-expansions ({@link IASTPreprocessorMacroExpansion})
@ -77,7 +77,7 @@ public interface IASTNodeSelector {
IASTNode findEnclosingNode(int offset, int length); IASTNode findEnclosingNode(int offset, int length);
/** /**
* Returns the smallest node strictly enclosing the given range, or <code>null</code> if there * Returns the smallest node strictly enclosing the given range, or {@code null} if there
* is no such node. * is no such node.
* <p> * <p>
* For nodes with the same location, macro-expansions ({@link IASTPreprocessorMacroExpansion}) * For nodes with the same location, macro-expansions ({@link IASTPreprocessorMacroExpansion})
@ -87,7 +87,7 @@ public interface IASTNodeSelector {
IASTNode findStrictlyEnclosingNode(int offset, int length); IASTNode findStrictlyEnclosingNode(int offset, int length);
/** /**
* Returns the first node contained in the given range, or <code>null</code> if there is * Returns the first node contained in the given range, or {@code null} if there is
* no such node. * no such node.
* <p> * <p>
* For nodes with the same location, macro-expansions ({@link IASTPreprocessorMacroExpansion}) * For nodes with the same location, macro-expansions ({@link IASTPreprocessorMacroExpansion})
@ -96,7 +96,7 @@ public interface IASTNodeSelector {
IASTNode findFirstContainedNode(int offset, int length); IASTNode findFirstContainedNode(int offset, int length);
/** /**
* Returns the node for the exact given range, or <code>null</code> if there is no such node. * Returns the node for the exact given range, or {@code null} if there is no such node.
* <p> * <p>
* The method never returns a macro expansion ({@link IASTPreprocessorMacroExpansion}) or * The method never returns a macro expansion ({@link IASTPreprocessorMacroExpansion}) or
* the name for an expansion. Rather than that the expansion itself is searched for a matching * the name for an expansion. Rather than that the expansion itself is searched for a matching
@ -106,7 +106,7 @@ public interface IASTNodeSelector {
IASTNode findNodeInExpansion(int offset, int length); IASTNode findNodeInExpansion(int offset, int length);
/** /**
* Returns the smallest node enclosing the range, or <code>null</code> if there is no such node. * Returns the smallest node enclosing the range, or {@code null} if there is no such node.
* <p> * <p>
* The method never returns a macro expansion ({@link IASTPreprocessorMacroExpansion}) or * The method never returns a macro expansion ({@link IASTPreprocessorMacroExpansion}) or
* the name for an expansion. Rather than that the expansion itself is searched for a matching * the name for an expansion. Rather than that the expansion itself is searched for a matching
@ -116,7 +116,7 @@ public interface IASTNodeSelector {
IASTNode findEnclosingNodeInExpansion(int offset, int length); IASTNode findEnclosingNodeInExpansion(int offset, int length);
/** /**
* Returns the first node contained in the given expansion, or <code>null</code> if there is * Returns the first node contained in the given expansion, or {@code null} if there is
* no such node. * no such node.
* <p> * <p>
* The method never returns a macro expansion ({@link IASTPreprocessorMacroExpansion}) or * The method never returns a macro expansion ({@link IASTPreprocessorMacroExpansion}) or
@ -127,7 +127,7 @@ public interface IASTNodeSelector {
IASTNode findFirstContainedNodeInExpansion(int offset, int length); IASTNode findFirstContainedNodeInExpansion(int offset, int length);
/** /**
* Returns a macro expansion enclosing the given range, or <code>null</code>. * Returns a macro expansion enclosing the given range, or {@code null}.
*/ */
IASTPreprocessorMacroExpansion findEnclosingMacroExpansion(int offset, int length); IASTPreprocessorMacroExpansion findEnclosingMacroExpansion(int offset, int length);
} }

3
core/org.eclipse.cdt.core/parser/org/eclipse/cdt/internal/core/dom/parser/ASTNodeSelector.java
View file

@ -51,9 +51,6 @@ public class ASTNodeSelector implements IASTNodeSelector {
return findNode(offsetInFile, lengthInFile, relation, requiredClass, false); return findNode(offsetInFile, lengthInFile, relation, requiredClass, false);
} }
/* (non-Javadoc)
* @see org.eclipse.cdt.core.dom.ast.IASTNodeSelector#getNode(int, int)
*/
private <T extends IASTNode> T findNode(int offsetInFile, int lengthInFile, Relation relation, private <T extends IASTNode> T findNode(int offsetInFile, int lengthInFile, Relation relation,
Class<T> requiredClass, boolean searchInExpansion) { Class<T> requiredClass, boolean searchInExpansion) {
if (!fIsValid) { if (!fIsValid) {