```
public interface ICdtVariableManager
```
Since:

3.0

Restriction:

This interface is not intended to be implemented by clients.

Restriction:

This interface is not intended to be extended by clients.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`void`	`checkVariableIntegrity(ICConfigurationDescription cfg)`	checks the integrity of the Macros If there are inconsistencies, such as when a macro value refers to a nonexistent macro or when two macros refer to each other, this method will throw the BuildMacroException exception The BuildMacroException will contain the human-readable string describing the inconsistency and the array of the IBuildMacro interfaces that will represent the macros that caused the inconsistency.
`java.lang.String`	`convertStringListToString(java.lang.String[] value, java.lang.String listDelimiter)`	converts StringList value into String of the following format: "< listDelimiter >< listDelimiter > ...
`ICdtVariable`	`getVariable(java.lang.String name, ICConfigurationDescription cfg)`	Returns reference to the IBuildMacro interface representing Macro of the specified name or null if there is there is no such macro
`ICdtVariable[]`	`getVariables(ICConfigurationDescription cfg)`
`boolean`	`isEnvironmentVariable(ICdtVariable variable, ICConfigurationDescription cfg)`
`boolean`	`isStringListValue(java.lang.String value, ICConfigurationDescription cfg)`
`boolean`	`isUserVariable(ICdtVariable variable, ICConfigurationDescription cfg)`
`java.lang.String[]`	`resolveStringListValue(java.lang.String value, java.lang.String nonexistentMacrosValue, java.lang.String listDelimiter, ICConfigurationDescription cfg)`	if the string contains a value that can be treated as a StringList resolves it to arrays of strings otherwise throws the BuildMacroException exception
`java.lang.String[]`	`resolveStringListValues(java.lang.String[] value, java.lang.String nonexistentMacrosValue, java.lang.String listDelimiter, ICConfigurationDescription cfg)`	resolves macros in the array of string-list values
`java.lang.String`	`resolveValue(java.lang.String value, java.lang.String nonexistentMacrosValue, java.lang.String listDelimiter, ICConfigurationDescription cfg)`	resolves all macros in the string.
`org.eclipse.core.variables.IStringVariable`	`toEclipseVariable(ICdtVariable variable, ICConfigurationDescription cfg)`

Method Detail

getVariable
```
ICdtVariable getVariable(java.lang.String name,
                         ICConfigurationDescription cfg)
```
Returns reference to the IBuildMacro interface representing Macro of the specified name or null if there is there is no such macro

Parameters:

name - macro name

getVariables
```
ICdtVariable[] getVariables(ICConfigurationDescription cfg)
```
Returns:

the array of the IBuildMacro representing all available macros

convertStringListToString

java.lang.String convertStringListToString(java.lang.String[] value,
                                           java.lang.String listDelimiter)

converts StringList value into String of the following format: "< listDelimiter >< listDelimiter > ... "

resolveValue
```
java.lang.String resolveValue(java.lang.String value,
                              java.lang.String nonexistentMacrosValue,
                              java.lang.String listDelimiter,
                              ICConfigurationDescription cfg)
                       throws CdtVariableException
```
resolves all macros in the string.

Parameters:

value - the value to be resolved

nonexistentMacrosValue - specifies the value that inexistent macro references will be expanded to. If null the BuildMacroException is thrown in case the string to be resolved references inexistent macros

listDelimiter - if not null, StringList macros are expanded as "< listDelimiter >< listDelimiter > ... " otherwise the BuildMacroException is thrown in case the string to be resolved references string-list macros

Throws:

CdtVariableException

resolveStringListValue

java.lang.String[] resolveStringListValue(java.lang.String value,
                                          java.lang.String nonexistentMacrosValue,
                                          java.lang.String listDelimiter,
                                          ICConfigurationDescription cfg)
                                   throws CdtVariableException

if the string contains a value that can be treated as a StringList resolves it to arrays of strings otherwise throws the BuildMacroException exception

Throws:: CdtVariableException

resolveStringListValues

java.lang.String[] resolveStringListValues(java.lang.String[] value,
                                           java.lang.String nonexistentMacrosValue,
                                           java.lang.String listDelimiter,
                                           ICConfigurationDescription cfg)
                                    throws CdtVariableException

resolves macros in the array of string-list values

Throws:: CdtVariableException
See Also:: isStringListValue(java.lang.String, org.eclipse.cdt.core.settings.model.ICConfigurationDescription)

isStringListValue

boolean isStringListValue(java.lang.String value,
                          ICConfigurationDescription cfg)
                   throws CdtVariableException

Returns:: true if the specified expression can be treated as StringList 1. The string value is "${}"
Throws:: CdtVariableException

checkVariableIntegrity
```
void checkVariableIntegrity(ICConfigurationDescription cfg)
                     throws CdtVariableException
```
checks the integrity of the Macros If there are inconsistencies, such as when a macro value refers to a nonexistent macro or when two macros refer to each other, this method will throw the BuildMacroException exception The BuildMacroException will contain the human-readable string describing the inconsistency and the array of the IBuildMacro interfaces that will represent the macros that caused the inconsistency. This information will be used in the UI to notify the user about the macro inconsistencies (see also the "User interface for viewing and editing Build Macros" section of this design)

Throws:

CdtVariableException

isEnvironmentVariable

boolean isEnvironmentVariable(ICdtVariable variable,
                              ICConfigurationDescription cfg)

isUserVariable

boolean isUserVariable(ICdtVariable variable,
                       ICConfigurationDescription cfg)

toEclipseVariable

org.eclipse.core.variables.IStringVariable toEclipseVariable(ICdtVariable variable,
                                                             ICConfigurationDescription cfg)

Interface ICdtVariableManager

Method Summary

Method Detail

getVariable

getVariables