GetNumGateValueAsString

Top  Previous  Next

Описание

Возвращает значение указанного (именем и идентификатором) тега как строку форматированного текста.

Синтаксис

String GetNumGateValueAsString(String Name, Int Id,String Format)

Параметры

Name = имя тега, который Вы желаете прочитать

Id = идентификатор тега, который Вы желаете прочитать

Format = строка форматирования возвращаемого текста.

Вы должны использовать следующие строки форматирования:

%g для вещественных (Float) чисел и

%d для целых (integer) чисел,

%s для string переменных.

Например, если Вы хотите показать температуру, прочитанную с численной (аналоговой) переменной, Вы должны установить метку как последовательность %g °C . Если во время фазы исполнения значение переменной будет 25, то Label покажет последовательность 25 °C .

Используя формат %g , программное обеспечение покажет действительное число наименьшее возможное (если нужно использование экспоненциального счисления).

Если Вы хотите определить, как число должно появиться, возможно использовать строку форматирования %x.ylf , где:

• x - (необязательное) число, указывает число цифр, которые будут показаны.

Если это не будет присутствовать, то будут показаны все цифры значения прочитанной переменной.
Если этому предшествует 0, перед числом будут показаны нули, дополняющие до заданного количества цифр.

• y - (необязательное) число, указывает количество десятичных цифр после запятой.

Если y равен "*" тогда количество десятичных цифр является предопределенным (это число определено в редакторе переменных Gate Builder).

Некоторые примеры:

%5.2lf произведет 123.45

%5.0lf произведет 123

%07.2lf произведет 00123.45

"%7.*lf" произведет 123.456, если число десятичных цифр, определенных в Gate Builder для переменных, связанных с объектом метки, будет равно 3.

Таким же образом можно определить формат для целых (integer) чисел (%xd ) и для строк (&xs). Значение параметра х такое же, как описано выше.

 

Возвращаемое значение

значение указанного тега как строка форматированного текста.

Связанные функции

GetNumGateValue()

Пример

int Gate12Id;

String Gate12Name;

Sring Value;

Value = GetNumGateValueAsString(Gate12Name, Gate12Id,"%6.*lf");