Saltar para o conteúdo principal
Versão: v20 R4 BETA

Operators

Um operador é um símbolo ou um grupo de símbolos que é utilizado para verificar, modificar ou combinar valores. Já está familiarizado com muitos operadores. Por exemplo, 1 + 2 utiliza o operador de adição (ou sinal de mais) para adicionar dois números e o resultado é 3. Os operadores de comparação, como = ou >, permitem-lhe comparar dois ou mais valores.

A linguagem 4D suporta os operadores que talvez já conheça de outras linguagens como C ou JavaScript. No entanto, o operador de atribuição é := para evitar que seja utilizado por engano quando se pretende utilizar o operador igual a (=). Operadores básicos tais como operadores aritméticos (+, -, *, /, %...) e operadores de comparação (=, >, >=...) podem ser utilizados com números, mas também com tipos de dados booleanos, texto, data, hora, ponteiro ou imagem. Tal como JavaScript, a linguagem 4D suporta o conceito de valores truthy e falsy, que são usados em operadores de curto-circuito.

Terminologia

A linguagem 4D suporta os operadores binários e ternários:

  • os operadores binários operam sobre dois objectivos (como 2 + 3) e aparecem entre os seus dois objectivos.
  • os operadores ternários operam em três objectivos. Tal como C, 4D tem apenas um operador ternário, o operador condicional ternário (a ? b : c).

Os valores que os operadores afectam são os operandos. Na expressão 1 + 2, o símbolo + é um operador binário e os seus dois operandos são os valores 1 e 2.

Operador de atribuição

O operador de atribuição (a:=b) inicializa ou actualiza o valor de a com o valor de b:

$myNumber:=3 //atribui 3 à variável MyNumber  
$myDate:=!2018/01/21! //atribui uma data literal
$myLength:=Length("Acme") //atribui o resultado do comando (4) a $myLength
$col:=New collection //$col é inicializado com uma colecção vazia

NÃO confundir o operador de atribuição := com o operador de comparação de igualdade =. Foi deliberadamente escolhido um operador de atribuição diferente (e não =) para evitar problemas e confusões que ocorrem frequentemente com == ou === noutras linguagens de programação. Esses erros são geralmente difíceis de reconhecer pelo compilador e geram problemas trabalhosos.

Operadores básicos

Os resultados dos operadores dependem dos tipos de dados aos quais são aplicados. 4D suporta diferentes operadores em tipos de dados escalares. São descritos com os tipos de dados, nas secções seguintes:

Operadores de atribuição compostos

Histórico
VersãoMudanças
v19 R4Adicionado

4D fornece operadores de atribuição compostos que combinam a atribuição com outra operação. Um exemplo é o operador de atribuição de adição (+=):

$a:=1 
$a+=2 // $a=3

São suportados os seguintes operadores de atribuição compostos:

OperadorSintaxeAtribuiçõesExemplo
AdiçãoText += TextText$t+=" World" //$t:=$t+" World"
Number += NumberNumber$n+=5 //$n:=$n+5
Date += NumberDate$d+=5 //$d:=$d+5
Time += TimeHora$t1+=$t2 //$t1:=$t1+$t2
Time += NumberNumber$t1+=5 //$t1:=$t1+5
Picture += PictureImagem$p1+=$p2 //$p1:=$p1+$p2 (add $p2 to the right of $p1)
Picture += NumberImagem$p1+=5 //$p1:=$p1+5 (move $p1 horizontally 5 pixels to the right)
SubtraçãoNumber -= NumberNumber$n-=5 //$n:=$n-5
Date -= NumberDate$d-=5 //$d:=$d-5
Time -= TimeHora$t1-=$t2 //$t1:=$t1-$t2
Time -= NumberNumber$t1-=5 //$t1:=$t1-5
Picture -= NumberImagem$p1-=5 //$p1:=$p1-5 (mover horizontalmente $p1 5 pixels para a esquerda)
DivisãoNumber /= NumberNumber$n/=5 //$n:=$n/5
Time /= TimeHora$t1/=$t2 //$t1:=$t1/$t2
Time /= NumberNumber$t1/=5 //$t1:=$t1/5
Picture /= PictureImagem$p1/=$p2 //$p1:=$p1/$p2 (adicione $p2 ao fundo de $p1)
Picture /= NumberImagem$p1/=5 //$p1:=$p1/5 (mover $p1 verticalmente 5 pixels)
MultiplicaçãoText *= NumberText$t*="abc" //$t:=$t*"abc"
Number *= NumberNumber$n*=5 //$n:=$n*5
Time *= TimeHora$t1*=$t2 //$t1:=$t1*$t2
Time *= NumberNumber$t1*=5 //$t1:=$t1*5
Picture *= NumberImagem$p1*=5 //$p1:=$p1*5 (redimensionar $p1 por 5)

Estes operadores aplicam-se a quaisquer expressões atribuíveis (exceto imagens como propriedades de objecto ou elementos de colecções).

A operação "source operator value" não é estritamente equivalente a "source := source operator value" porque a expressão que designa a fonte (variável, campo, propriedade de objeto, elemento de coleção) só é avaliada uma vez. Por exemplo, numa expressão como getPointer()->+=1 o método getPointer é chamado apenas uma vez.

A indexação de caracteres no texto e a indexação de bytes no blob não suportam estes operadores.

Exemplos

// Addition
$x:=2
$x+=5 //$x=7

$t:="Hello"
$t+=" World" //$t="Hello World"

$d:=!2000-11-10!
$d+=10 //$d=!2000-11-20!

// Subtracção
$x1:=10
$x1-=5 //$x1=5

$d1:=!2000-11-10!
$d1-=10 // $d1=!2000-10-31!

// Divisão
$x3:=10
$x3/=2 // $x3=5


// Multiplicação
$x2:=10
$x2*=5 // $x2=10

$t2:="Hello"
$t2*=2 // $t2="HelloHello"

Operadores curto-circuito

Os operadores && e || são os operadores de curto-circuito. Um operador de curto-circuito é aquele que não avalia necessariamente todos os seus operandos.

A diferença em relação aos operadores booleanos simples & e | é que os operadores de curto-circuito && e || não devolvem um valor booleano. Avaliam as expressões como truthy ou falsye, em seguida, devolvem uma das expressões.

Operador em curto-circuito AND (&&)

Histórico
VersãoMudanças
v19 R4Adicionado

A regra é a seguinte:

Dado Expr1 && Expr2:

O operador de curto-circuito AND avalia os operandos da esquerda para a direita, retornando imediatamente com o valor do primeiro operando falsy que encontrar; se todos os valores forem truthy, o valor do último operando é retornado.

A tabela seguinte resume os diferentes casos para o operador &&:

Expr1Expr2Valor devolvido
truthytruthyExpr2
truthyfalsyExpr2
falsytruthyExpr1
falsyfalsyExpr1

Exemplo 1

var $v : Variant

$v:= "Hello" && "World" //"World"
$v:=False && 0 // False
$v:=0 && False // False
$v:=5 && !00-00-00! // 00/00/00
$v := 5 && 10 && "hello" //"hello"

Exemplo 2

Digamos que tem uma loja online e que alguns produtos têm uma taxa de imposto aplicada e outros não.

Para calcular o imposto, multiplica-se o preço pela taxa de imposto, que pode não ter sido especificada.

Portanto, pode escrever isto:

var $tax : Variant

$tax:=$item.taxRate && ($item.price*$item.taxRate)

$tax será NULL se tarateté é NULL (ou indefinido); caso contrário, armazenará o resultado do cálculo.

Exemplo 3

Os operadores de curto-circuito são úteis em provas como:

If(($myObject#Null) && ($myObject.value>10))
//code End if

Se $myObject for nulo, o segundo argumento não é executado e, por conseguinte, não é lançado qualquer erro.

Operador em curto-circuito OR (||)

Histórico
VersãoMudanças
v19 R4Adicionado

O operador || devolve o valor de um dos operandos especificados. A expressão é avaliada da esquerda para a direita e testada para uma possível avaliação de "curto-circuito" utilizando a seguinte regra:

Dado Expr1 || Expr2:

Se Expr1 é truthy, Expr2 não é avaliado e o cálculo devolve Expr1.

Se Expr1 é falsy, o cálculo devolve Expr2.

A tabela seguinte resume os diferentes casos e o valor retornado para o operador ||:

Expr1Expr2Valor devolvido
truthytruthyExpr1
truthyfalsyExpr1
falsytruthyExpr2
falsyfalsyExpr2

Exemplo 1

Digamos que tem uma tabela chamada Employee. Alguns empregados introduziram um número de telefone e outros não. Some employees have entered a phone number, and others haven't. Some employees have entered a phone number, and others haven't. This means that $emp.phone could be NULL, and you cannot assign NULL to a Text variable. Mas pode escrever o seguinte:

var $phone : Text

$phone:=$emp.phone || "n/a"

Nesse caso, $phone guardará um número de telefone ou a cadeia "n/a".

Exemplo 2

Dada uma tabela chamada Person com um campo name, bem como um campo maiden name para mulheres casadas.

O exemplo seguinte verifica se existe um nome de solteira e armazena-o numa variável; caso contrário, armazena simplesmente o nome da pessoa:

var $name: Text

$name:=$person.maidenName || $person.name

Precedência

Os operadores && e || têm a mesma precedência que os operadores lógicos & e |, e são avaliados da esquerda para a direita.

Isto significa que a || b && c é avaliado como (a || b) && c.

Operador ternário

Histórico
VersãoMudanças
v19 R4Adicionado

O operador condicional ternário permite-lhe escrever expressões condicionais de uma linha. For example, it can replace a full sequence of If… Else statements.

Aceita três operandos na seguinte ordem:

  • uma condição seguida de um ponto de interrogação (?)
  • uma expressão a executar se a condição é truthy, seguida de dois pontos (:)
  • uma expressão a executar se a condição é falsy

Sintaxe

A sintaxe é a seguinte:

condition ? exprIfTruthy : exprIfFalsy

Uma vez que a sintaxe do token utiliza dois pontos, recomenda-se a inserção de um espaço após os dois pontos : ou a utilização de parênteses para encerrar os tokens, a fim de evitar conflitos.

Exemplos

Um exemplo simple

var $age : Integer
var $beverage : Text

$age:=26
$beverage:=($age>=21) ? "Beer" : "Juice" ALERT($beverage) // "Beer"

Tratamento de dados de uma tabela

Este exemplo armazena o nome completo de uma pessoa numa variável e trata do caso em que não foi especificado o primeiro nome ou o último nome:

var $fullname : Text

// Se um dos nomes estiver em falta, guardar o que existe, caso contrário guardar uma cadeia vazia
$fullname:=($person.firstname && $person.lastname) ? ($person.firstname+" "+$person.lastname) : ($person.lastname || $person.firstname) || ""

Truthy e falsy

Histórico
VersãoMudanças
v19 R4Adicionado

Para além de um tipo, cada valor tem também um valor booliano inerente, geralmente conhecido como truthy ou falsy.

Os valores truthy e falsy só são avaliados pelos operadores de curto-circuito e ternários.

Os seguintes valores são falsy:

  • false
  • Null
  • indefinido
  • Null object
  • Null collection
  • Null pointer
  • Null picture
  • Null date !00-00-00!
  • "" - Empty strings
  • [] - Colecções vazias
  • {} - Objectos vazios

Todos os outros valores são considerados truthy, incluindo:

  • 0 - zero numérico (inteiro ou não)

Em 4D, a avaliação truthy e falsy reflecte a usabilidade de um valor, o que significa que um valor truthy existe e pode ser processado pelo código sem gerar erros ou resultados inesperados. The rationale behind this is to provide a convenient way to handle undefined and null values in objects and collections, so that a reduced number of If… Else statements are necessary to avoid runtime errors.

Por exemplo, quando se utiliza um operador OR curto-circuito:

$value:=$object.value || $defaultValue

... obtém o valor padrão sempre que $object não contém a propriedade value OU quando é null. Assim, este operador verifica a existência ou a possibilidade de utilização do valor em vez de um valor específico. Note-se que, como o valor numérico 0 existe e é utilizável, não é tratado de forma especial, pelo que é truthy.

Para valores que representam coleções, objetos ou cadeias de caracteres, os valores "vazios" são considerados como falsy. É útil quando se pretende atribuir um valor por defeito sempre que se encontra um valor vazio.

$phone:=$emp.phone || "n/a"