Resumo
Converte a cadeia de valor do parâmetro indicado num número usando o tipo de unidade especificado.
Sintaxe
StrToNumber(Value : String , Unit : String) : Number
Exemplo de utilização
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Converte o valor em cadeia devolvido pelo parâmetro VoltageRating num número, usando volts (V) como unidade, e depois devolve todos os objetos com um valor superior a 50V.
StrToNumber(ParameterValue('Resistance'),Ohms) Between 1000 And 10000
Converte o valor em cadeia devolvido pelo parâmetro Resistance num número, usando ohms como unidade, e depois devolve todos os objetos com um valor entre 1kΩ e 10kΩ.
StrToNumber(ParameterValue('CapacitanceValue'),F) < 2e-9
Converte o valor em cadeia devolvido pelo parâmetro CapacitanceValue num número, usando Capacitância (F) como unidade, e depois devolve todos os objetos com um valor inferior a 2nF (2e-9 em notação científica).
Notas
Será gerado um erro de scripting se a cadeia de valor não puder ser convertida num número. Para contemplar esta situação, utilize a função StrToNumber, que devolve um número predefinido se a conversão falhar.
A função de conversão de cadeia em número com reconhecimento de unidades aceita uma vasta gama de definições de tipo de unidade, incluindo:
-
V – Tensão
-
A – Corrente
-
Ohm – Resistência
-
Z – Impedância
-
F – Capacitância
-
H – Indutância
-
G – Condutância
-
W – Potência
-
Hz – Frequência
-
Q – Carga
-
C – Temperatura
-
dB – Decibéis
-
% – Percentagem
-
m – Comprimento
-
Kg – Massa
-
s – Tempo
O conversor aceita fatores de escala de valor padrão (micro, quilo, mega, etc.,) e, por conseguinte, cadeias de parâmetros que contenham abreviaturas de prefixo como mV, uA, kHz, etc.
Também são suportadas várias formas de representação de valores. Por exemplo, o mesmo valor de resistência pode ser representado como: