mirrors/cdt
1
0
Fork 0
mirror of https://github.com/eclipse-cdt/cdt synced 2025-04-29 19:45:01 +02:00
Code Issues Wiki Activity

Clarified index locking requirements.

Browse source
This commit is contained in:
Sergey Prigogin 2011-02-17 21:33:05 +00:00
parent 6d940840ee
commit d62d436c14
1 changed files with 16 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

25
core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ITranslationUnit.java
View file

@ -1,5 +1,5 @@
/******************************************************************************* /*******************************************************************************
* Copyright (c) 2000, 2010 QNX Software Systems and others. * Copyright (c) 2000, 2011 QNX Software Systems and others.
* All rights reserved. This program and the accompanying materials * All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0 * are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at * which accompanies this distribution, and is available at
@ -24,6 +24,7 @@ import org.eclipse.cdt.internal.core.model.IBufferFactory;
import org.eclipse.core.runtime.CoreException; import org.eclipse.core.runtime.CoreException;
import org.eclipse.core.runtime.IPath; import org.eclipse.core.runtime.IPath;
import org.eclipse.core.runtime.IProgressMonitor; import org.eclipse.core.runtime.IProgressMonitor;
/** /**
* Represents an entire C translation unit (<code>.c</code> source file). * Represents an entire C translation unit (<code>.c</code> source file).
* The children are of type <code>IStructureElement</code>, * The children are of type <code>IStructureElement</code>,
@ -160,7 +161,8 @@ public interface ITranslationUnit extends ICElement, IParent, IOpenable, ISource
* *
* @param name the name of the namespace * @param name the name of the namespace
* @param monitor the progress monitor to notify * @param monitor the progress monitor to notify
* @return the newly inserted namespace declaration (or the previously existing one in case attempting to create a duplicate) * @return the newly inserted namespace declaration (or the previously existing one in case
* attempting to create a duplicate)
* *
* @exception CModelException if the element could not be created. Reasons include: * @exception CModelException if the element could not be created. Reasons include:
* <ul> * <ul>
@ -172,8 +174,8 @@ public interface ITranslationUnit extends ICElement, IParent, IOpenable, ISource
INamespace createNamespace (String namespace, ICElement sibling, IProgressMonitor monitor) throws CModelException; INamespace createNamespace (String namespace, ICElement sibling, IProgressMonitor monitor) throws CModelException;
/** /**
* Returns the shared working copy for this element, using the default <code>IBuffer</code> factory, or * Returns the shared working copy for this element, using the default <code>IBuffer</code>
* <code>null</code>, if no working copy has been created for this element. * factory, or <code>null</code>, if no working copy has been created for this element.
* <p> * <p>
* Users of this method must not destroy the resulting working copy. * Users of this method must not destroy the resulting working copy.
* *
@ -244,7 +246,8 @@ public interface ITranslationUnit extends ICElement, IParent, IOpenable, ISource
* *
* @param the name of the include to find (For example: <code>"stdio.h"</code> * @param the name of the include to find (For example: <code>"stdio.h"</code>
* or <code>"sys/types.h"</code>) * or <code>"sys/types.h"</code>)
* @return a handle onto the corresponding include declaration. The include declaration may or may not exist. * @return a handle onto the corresponding include declaration. The include declaration may or
* may not exist.
*/ */
IInclude getInclude(String name) ; IInclude getInclude(String name) ;
@ -425,8 +428,8 @@ public interface ITranslationUnit extends ICElement, IParent, IOpenable, ISource
public IScannerInfo getScannerInfo(boolean force); public IScannerInfo getScannerInfo(boolean force);
/** /**
* Creates the full AST for this translation unit. May return <code>null</code> if the language of this * Creates the full AST for this translation unit. May return <code>null</code> if the language
* translation unit does not support ASTs. * of this translation unit does not support ASTs.
* @return the AST for the translation unit or <code>null</code> * @return the AST for the translation unit or <code>null</code>
* @throws CoreException * @throws CoreException
* @since 4.0 * @since 4.0
@ -434,8 +437,10 @@ public interface ITranslationUnit extends ICElement, IParent, IOpenable, ISource
public IASTTranslationUnit getAST() throws CoreException; public IASTTranslationUnit getAST() throws CoreException;
/** /**
* Creates an AST based on the requested style. May return <code>null</code> if the language of this * Creates an AST based on the requested style. May return <code>null</code> if the language of
* translation unit does not support ASTs. * this translation unit does not support ASTs. If the index was supplied, the caller has to
* hold a read lock on it. The returned AST is valid only while the read lock is being held
* and should not be accessed after releasing the lock.
* @param index index to back up the parsing of the AST, may be <code>null</code> * @param index index to back up the parsing of the AST, may be <code>null</code>
* @param style <code>0</code> or a combination of {@link #AST_SKIP_ALL_HEADERS}, * @param style <code>0</code> or a combination of {@link #AST_SKIP_ALL_HEADERS},
* {@link #AST_SKIP_IF_NO_BUILD_INFO}, {@link #AST_SKIP_INDEXED_HEADERS} * {@link #AST_SKIP_IF_NO_BUILD_INFO}, {@link #AST_SKIP_INDEXED_HEADERS}
@ -485,6 +490,4 @@ public interface ITranslationUnit extends ICElement, IParent, IOpenable, ISource
*/ */
@Deprecated @Deprecated
org.eclipse.cdt.core.parser.CodeReader getCodeReader(); org.eclipse.cdt.core.parser.CodeReader getCodeReader();
} }