Copyright (c) 2004, 2005 IBM Corporation and others.
This program and the accompanying materials
are made available under the terms of the Eclipse Public License 2.0
which accompanies this distribution, and is available at
https://www.eclipse.org/legal/epl-2.0/
SPDX-License-Identifier: EPL-2.0
Contributors:
    IBM Corporation - initial API and implementation
/*******************************************************************************
 * Copyright (c) 2004, 2005 IBM Corporation and others.
 *
 * This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License 2.0
 * which accompanies this distribution, and is available at
 * https://www.eclipse.org/legal/epl-2.0/
 *
 * SPDX-License-Identifier: EPL-2.0
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.debug.core;

import org.eclipse.debug.core.model.IValue;

Provides logical structure types applicable to a raw implementation value
from a debug model. Associated with a logical structure provider extension.

The following is an example of a logical structure provider extension:

 <extension point="org.eclipse.debug.core.logicalStructureProviders">
  <logicalStructureProvider
   class="com.example.ExampleLogicalStructureProvider"
   modelIdentifier="com.example.debug.model">
  </logicalStructureProvider>
</extension>


In the example above, the specified logical structure provider will be
consulted for alternative logical structures for values from the
com.example.debug.model debug model as they are displayed in the
variables view.


Clients contributing logical structure providers must implement this
interface.

See Also:
ILogicalStructureType
Since:
3.1/**
 * Provides logical structure types applicable to a raw implementation value
 * from a debug model. Associated with a logical structure provider extension.
 * <p>
 * The following is an example of a logical structure provider extension:
 * </p>
 * 
 * <pre>
 *  &lt;extension point=&quot;org.eclipse.debug.core.logicalStructureProviders&quot;&gt;
 *   &lt;logicalStructureProvider
 *    class=&quot;com.example.ExampleLogicalStructureProvider&quot;
 *    modelIdentifier=&quot;com.example.debug.model&quot;&gt;
 *   &lt;/logicalStructureProvider&gt;
 * &lt;/extension&gt;
 * </pre>
 * <p>
 * In the example above, the specified logical structure provider will be
 * consulted for alternative logical structures for values from the
 * <code>com.example.debug.model</code> debug model as they are displayed in the
 * variables view.
 * </p>
 * <p>
 * Clients contributing logical structure providers must implement this
 * interface.
 * </p>
 * 
 * @since 3.1
 * @see org.eclipse.debug.core.ILogicalStructureType
 */
public interface ILogicalStructureProvider {

	
Returns the logical structure types which are applicable to the given value.
Params:
value – value for which logical structure types are being requested
Returns:
the logical structure types which are applicable to the given value/**
	 * Returns the logical structure types which are applicable to the given value.
	 *
	 * @param value value for which logical structure types are being requested
	 * @return the logical structure types which are applicable to the given value
	 */
	ILogicalStructureType[] getLogicalStructureTypes(IValue value);

}