UnitValue

Retorna o valor numérico de uma medida com sua expansão de unidade associada, após uma conversão opcional de unidade. Uma expansão de unidade é uma string que consiste em um número seguido por uma unidade de medida válida.

Sintaxe

UnitValue(s1 [, s2 ])

Parâmetros

Parâmetros

Descrição

s1

Uma string válida que contém um valor numérico e uma unidade de medida válida (expansão de unidade). As unidades de medida reconhecidas são:

  • in, polegadas

  • mm, milímetros

  • cm, centímetros

  • pt, paicas, pontos

  • mp, milipontos

s2 (opcional)

Uma string que contém uma unidade de medida válida. A função converte a expansão de unidade especificada em s1 para essa nova unidade de medida.

Se um valor não for incluído para s2, a função usará a unidade de medida especificada em s1. Se s2 for inválida, a função converterá s1 em polegadas.

Exemplos

As expressões a seguir são exemplos de uso da função UnitValue:

Expressão

Retorna

UnitValue("2in")

2

UnitValue("2in", "cm")

5.08

UnitValue("6", "pt")

432

UnitValue("A", "cm")

0

UnitValue(Size[2], "mp")

Retorna o valor de medida da terceira ocorrência de Size convertido em milipontos.

UnitValue("5.08cm", "kilograms")

2