protected static class PsiUtilCore.NullPsiElement extends java.lang.Object implements PsiElement
Iconable.IconFlags, Iconable.LastComputedIconARRAY_FACTORY, EMPTY_ARRAYICON_FLAG_IGNORE_MASK, ICON_FLAG_OPEN, ICON_FLAG_READ_STATUS, ICON_FLAG_VISIBILITY| Modifier | Constructor and Description |
|---|---|
protected |
NullPsiElement() |
| Modifier and Type | Method and Description |
|---|---|
void |
accept(PsiElementVisitor visitor)
Passes the element to the specified visitor.
|
void |
acceptChildren(PsiElementVisitor visitor)
Passes the children of the element to the specified visitor.
|
PsiElement |
add(PsiElement element)
Adds a child to this PSI element.
|
PsiElement |
addAfter(PsiElement element,
PsiElement anchor)
Adds a child to this PSI element, after the specified anchor element.
|
PsiElement |
addBefore(PsiElement element,
PsiElement anchor)
Adds a child to this PSI element, before the specified anchor element.
|
PsiElement |
addRange(PsiElement first,
PsiElement last)
Adds a range of elements as children to this PSI element.
|
PsiElement |
addRangeAfter(PsiElement first,
PsiElement last,
PsiElement anchor)
Adds a range of elements as children to this PSI element, after the specified anchor element.
|
PsiElement |
addRangeBefore(PsiElement first,
PsiElement last,
PsiElement anchor)
Adds a range of elements as children to this PSI element, before the specified anchor element.
|
void |
checkAdd(PsiElement element)
Checks if it is possible to add the specified element as a child to this element,
and throws an exception if the add is not possible.
|
void |
checkDelete()
Checks if it is possible to delete the specified element from the tree,
and throws an exception if the add is not possible.
|
PsiElement |
copy()
Creates a copy of the file containing the PSI element and returns the corresponding
element in the created copy.
|
void |
delete()
Deletes this PSI element from the tree.
|
void |
deleteChildRange(PsiElement first,
PsiElement last)
Deletes a range of children of this PSI element from the tree.
|
PsiElement |
findElementAt(int offset)
Finds a leaf PSI element at the specified offset from the start of the text range of this node.
|
PsiReference |
findReferenceAt(int offset)
Finds a reference at the specified offset from the start of the text range of this node.
|
PsiElement [] |
getChildren()
Returns the array of children for the PSI element.
|
PsiFile |
getContainingFile()
Returns the file containing the PSI element.
|
PsiElement |
getContext()
Returns the element which should be used as the parent of this element in a tree up
walk during a resolve operation.
|
<T> T |
getCopyableUserData(Key<T> key)
Returns a copyable user data object attached to this element.
|
PsiElement |
getFirstChild()
Returns the first child of the PSI element.
|
javax.swing.Icon |
getIcon(int flags) |
Language |
getLanguage()
Returns the language of the PSI element.
|
PsiElement |
getLastChild()
Returns the last child of the PSI element.
|
PsiManager |
getManager()
Returns the PSI manager for the project to which the PSI element belongs.
|
PsiElement |
getNavigationElement()
Returns the PSI element which should be used as a navigation target
when navigation to this PSI element is requested.
|
PsiElement |
getNextSibling()
Returns the next sibling of the PSI element.
|
ASTNode |
getNode()
Returns the AST node corresponding to the element.
|
PsiElement |
getOriginalElement()
Returns the PSI element which corresponds to this element and belongs to
either the project source path or class path.
|
PsiElement |
getParent()
Returns the parent of the PSI element.
|
PsiElement |
getPrevSibling()
Returns the previous sibling of the PSI element.
|
Project |
getProject()
Returns the project to which the PSI element belongs.
|
PsiReference |
getReference()
Returns the reference from this PSI element to another PSI element (or elements), if one exists.
|
PsiReference [] |
getReferences()
Returns all references from this PSI element to other PSI elements.
|
GlobalSearchScope |
getResolveScope()
Returns the scope in which the declarations for the references in this PSI element are searched.
|
int |
getStartOffsetInParent()
Returns the text offset of the PSI element relative to its parent.
|
java.lang.String |
getText()
Returns the text of the PSI element.
|
int |
getTextLength()
Returns the length of text of the PSI element.
|
int |
getTextOffset()
Returns the offset in the file to which the caret should be placed
when performing the navigation to the element.
|
TextRange |
getTextRange()
Returns the text range in the document occupied by the PSI element.
|
<T> T |
getUserData(Key<T> key) |
SearchScope |
getUseScope()
Returns the scope in which references to this element are searched.
|
boolean |
isEquivalentTo(PsiElement another)
This method shouldn't be called by clients directly, because there are no guarantees of it being symmetric.
|
boolean |
isPhysical()
Checks if an actual source or class file corresponds to the element.
|
boolean |
isValid()
Checks if this PSI element is valid.
|
boolean |
isWritable()
Checks if the contents of the element can be modified (if it belongs to a
non-read-only source file.)
|
boolean |
processDeclarations(PsiScopeProcessor processor,
ResolveState state,
PsiElement lastParent,
PsiElement place)
Passes the declarations contained in this PSI element and its children
for processing to the specified scope processor.
|
<T> void |
putCopyableUserData(Key<T> key,
T value)
Attaches a copyable user data object to this element.
|
<T> void |
putUserData(Key<T> key,
T value)
Add a new user data value to this object.
|
PsiElement |
replace(PsiElement newElement)
Replaces this PSI element (along with all its children) with another element
(along with the children).
|
boolean |
textContains(char c)
Checks if the text of this element contains the specified character.
|
boolean |
textMatches(java.lang.CharSequence text)
Checks if the text of this PSI element is equal to the specified character sequence.
|
boolean |
textMatches(PsiElement element)
Checks if the text of this PSI element is equal to the text of the specified PSI element.
|
char [] |
textToCharArray()
Returns the text of the PSI element as a character array.
|
java.lang.String |
toString()
toString() should never be presented to the user.
|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitgetOwnReferences, getTextRangeInParentpublic Project getProject()
PsiElementgetProject in interface PsiElementpublic Language getLanguage()
PsiElementgetLanguage in interface PsiElementpublic PsiManager getManager()
PsiElementgetManager in interface PsiElementpublic PsiElement [] getChildren()
PsiElementgetChildren in interface PsiElementpublic PsiElement getParent()
PsiElementgetParent in interface PsiElementpublic PsiElement getFirstChild()
PsiElementgetFirstChild in interface PsiElementpublic PsiElement getLastChild()
PsiElementgetLastChild in interface PsiElementpublic PsiElement getNextSibling()
PsiElementgetNextSibling in interface PsiElementpublic PsiElement getPrevSibling()
PsiElementgetPrevSibling in interface PsiElementpublic PsiFile getContainingFile()
PsiElementgetContainingFile in interface PsiElementpublic TextRange getTextRange()
PsiElementgetTextRange in interface PsiElementpublic int getStartOffsetInParent()
PsiElementgetStartOffsetInParent in interface PsiElementpublic int getTextLength()
PsiElementgetTextLength in interface PsiElementpublic PsiElement findElementAt(int offset)
PsiElementfindElementAt in interface PsiElementoffset - the relative offset for which the PSI element is requested.public PsiReference findReferenceAt(int offset)
PsiElementfindReferenceAt in interface PsiElementoffset - the relative offset for which the reference is requested.public int getTextOffset()
PsiElementPsiNamedElement, this should return the offset in the file of the
name identifier.)getTextOffset in interface PsiElementpublic java.lang.String getText()
PsiElementgetText in interface PsiElementPsiElement.textMatches(java.lang.CharSequence),
PsiElement.textContains(char)public char [] textToCharArray()
PsiElementtextToCharArray in interface PsiElementpublic PsiElement getNavigationElement()
PsiElementthis or substitute a different element if this element
does not have an associated file and offset. (For example, if the source code
of a library is attached to a project, the navigation element for a compiled
library class is its source class.)getNavigationElement in interface PsiElementpublic PsiElement getOriginalElement()
PsiElementthis or substitute a different element if this element does
not belong to the source path or class path. (For example, the original
element for a library source file is the corresponding compiled class file.)getOriginalElement in interface PsiElementpublic boolean textMatches(java.lang.CharSequence text)
PsiElementtextMatches in interface PsiElementtext - the character sequence to compare with.public boolean textMatches(PsiElement element)
PsiElementtextMatches in interface PsiElementelement - the element to compare the text with.public boolean textContains(char c)
PsiElementtextContains in interface PsiElementc - the character to search for.public void accept(PsiElementVisitor visitor)
PsiElementaccept in interface PsiElementvisitor - the visitor to pass the element to.public void acceptChildren(PsiElementVisitor visitor)
PsiElementacceptChildren in interface PsiElementvisitor - the visitor to pass the children to.public PsiElement copy()
PsiElementcopy in interface PsiElementpublic PsiElement add(PsiElement element)
PsiElementadd in interface PsiElementelement - the child element to add.element or its copy).public PsiElement addBefore(PsiElement element, PsiElement anchor)
PsiElementaddBefore in interface PsiElementelement - the child element to add.anchor - the anchor before which the child element is inserted (must be a child of this PSI element)element or its copy).public PsiElement addAfter(PsiElement element, PsiElement anchor)
PsiElementaddAfter in interface PsiElementelement - the child element to add.anchor - the anchor after which the child element is inserted (must be a child of this PSI element)element or its copy).public void checkAdd(PsiElement element)
PsiElementcheckAdd in interface PsiElementelement - the child element to check the add possibility.public PsiElement addRange(PsiElement first, PsiElement last)
PsiElementaddRange in interface PsiElementfirst - the first child element to add.last - the last child element to add (must have the same parent as first)first or its copy).public PsiElement addRangeBefore(PsiElement first, PsiElement last, PsiElement anchor)
PsiElementaddRangeBefore in interface PsiElementfirst - the first child element to add.last - the last child element to add (must have the same parent as first)anchor - the anchor before which the child element is inserted (must be a child of this PSI element)first or its copy).public PsiElement addRangeAfter(PsiElement first, PsiElement last, PsiElement anchor)
PsiElementaddRangeAfter in interface PsiElementfirst - the first child element to add.last - the last child element to add (must have the same parent as first)anchor - the anchor after which the child element is inserted (must be a child of this PSI element)first or its copy).public void delete()
PsiElementdelete in interface PsiElementpublic void checkDelete()
PsiElementcheckDelete in interface PsiElementpublic void deleteChildRange(PsiElement first, PsiElement last)
PsiElementdeleteChildRange in interface PsiElementfirst - the first child to delete (must be a child of this PSI element)last - the last child to delete (must be a child of this PSI element)public PsiElement replace(PsiElement newElement)
PsiElementreplace in interface PsiElementnewElement - the element to replace this element with.newElement or its copy)public boolean isValid()
PsiElementPsiDocumentManager.commitDocument(com.intellij.openapi.editor.Document)).
(In this case an attempt to change PSI will result in an exception).
Any access to invalid elements results in PsiInvalidElementAccessException.
Once invalid, elements can't become valid again.
Elements become invalid in following cases:
PsiElement.delete())isValid in interface PsiElementPsiUtilCore.ensureValid(PsiElement)public boolean isWritable()
PsiElementisWritable in interface PsiElementpublic PsiReference getReference()
PsiElementPsiElement.getReferences()
for an example), returns the first associated reference.getReference in interface PsiElementReferencesSearchpublic PsiReference [] getReferences()
PsiElementPsiPolyVariantReference should be used instead
of returning multiple references.
Actually, it's preferable to call PsiReferenceService.getReferences(com.intellij.psi.PsiElement, com.intellij.psi.PsiReferenceService.Hints) instead
as it allows adding references by plugins when the element implements ContributedReferenceHost.getReferences in interface PsiElementPsiReferenceService.getReferences(com.intellij.psi.PsiElement, com.intellij.psi.PsiReferenceService.Hints),
ReferencesSearchpublic <T> T getCopyableUserData(Key<T> key)
PsiElementgetCopyableUserData in interface PsiElementkey - the key for accessing the user data object.PsiElement.putCopyableUserData(Key, Object)public <T> void putCopyableUserData(Key<T> key, T value)
PsiElementputCopyableUserData in interface PsiElementkey - the key for accessing the user data object.value - the user data object to attach.PsiElement.getCopyableUserData(Key)public boolean processDeclarations(PsiScopeProcessor processor, ResolveState state, PsiElement lastParent, PsiElement place)
PsiElementprocessDeclarations in interface PsiElementprocessor - the processor receiving the declarations.lastParent - the child of this element has been processed during the previous
step of the tree up walk (declarations under this element do not need
to be processed again)place - the original element from which the tree up walk was initiated.public PsiElement getContext()
PsiElementgetParent(),
but the context can be overridden for some elements like code fragments (see
JavaCodeFragmentFactory.createCodeBlockCodeFragment(String, PsiElement, boolean)).getContext in interface PsiElementpublic boolean isPhysical()
PsiElementPsiDocumentManager.getDocument(PsiFile) returns null for non-physical elements.
Not to be confused with FileViewProvider.isPhysical().isPhysical in interface PsiElementpublic GlobalSearchScope getResolveScope()
PsiElementgetResolveScope in interface PsiElementpublic SearchScope getUseScope()
PsiElementgetUseScope in interface PsiElementPsiSearchHelper.getUseScope(PsiElement)public ASTNode getNode()
PsiElementgetNode in interface PsiElementpublic <T> T getUserData(Key<T> key)
getUserData in interface UserDataHolderpublic <T> void putUserData(Key<T> key, T value)
UserDataHolderputUserData in interface UserDataHolderpublic boolean isEquivalentTo(PsiElement another)
PsiElementPsiManager.areElementsEquivalent(PsiElement, PsiElement) internally, which clients should invoke instead.
Implementations of this method should return true if the parameter is resolve-equivalent to this, i.e. it represents
the same entity from the language perspective. See also PsiManager.areElementsEquivalent(PsiElement, PsiElement) documentation.isEquivalentTo in interface PsiElementpublic java.lang.String toString()
PsiElementtoString in interface PsiElementtoString in class java.lang.Object