GetVariableByName

> [HTML Version](getvariablebyname.html)

**Синтаксис**

````
function GetVariableByName(const AName: string): TM\_Variable;

````
**Описание**

Возвращает переменную с именем AName. Вернёт "nil" если переменная с таким именем не найдена. Если после подмены переменной требуется выполнить скрипты OnDataChange/OnDataChangeEx для объектов связанных с этой переменной, то нужно использовать метод [OnDataChangeEvent](ondatachangeeventvar.md).

**Пример кода**

````
var  
  aVar: TM\_Variable;  
begin  
  aVar := GetVariableByName('MyVariable');  
  if aVar <> nil then        // если переменная существует  
    Field1.Variable := aVar; // то, связать поле "Field1" с переменной  
end.
````