{"id":17807,"date":"2026-07-20T14:58:06","date_gmt":"2026-07-20T17:58:06","guid":{"rendered":"https:\/\/kb.elipse.com.br\/?p=17807"},"modified":"2026-07-20T16:40:58","modified_gmt":"2026-07-20T19:40:58","slug":"setbit-alterar-bit-de-tag-e3","status":"publish","type":"post","link":"https:\/\/kb.elipse.com.br\/en\/setbit-alterar-bit-de-tag-e3\/","title":{"rendered":"Alterando bits individuais de um tag com a fun\u00e7\u00e3o SetBit."},"content":{"rendered":"
\n
<\/div>\n<\/div>\n
\n
\n

1.<\/span>\u00a0Introdu\u00e7\u00e3o<\/h2>\n

\u00c9 comum precisar ligar ou desligar um \u00fanico bit<\/strong> de um tag inteiro, por exemplo acionar o bit 0 de uma word<\/em> de comando sem alterar os demais bits. O E3Globals oferece a fun\u00e7\u00e3o SetBit<\/code> justamente para isso.<\/p>\n

Um erro frequente \u00e9 chamar SetBit<\/code> sobre o valor do tag<\/strong> e esperar que a altera\u00e7\u00e3o seja aplicada automaticamente:<\/p>\n

<\/div>\n
'N\u00c3O funciona: o retorno \u00e9 descartado\r\nSetBit Application.GetObject(\"Driver.Tag1\").Value, 0, False<\/pre>\n
Nesse formato, o bit \u00e9 calculado, mas nada \u00e9 escrito no tag<\/strong>. Isso acontece porque SetBit<\/code> n\u00e3o altera o valor no local<\/strong>: ela retorna<\/strong> o valor j\u00e1 modificado. A corre\u00e7\u00e3o \u00e9 reatribuir esse retorno ao tag<\/strong>.<\/p>\n<\/section>\n
\n
2.<\/span>\u00a0O que s\u00e3o SetBit e GetBit<\/h2>\n
Ambas s\u00e3o fun\u00e7\u00f5es do E3Globals<\/strong>, dispon\u00edveis tanto em scripts<\/strong> quanto em associa\u00e7\u00f5es<\/strong>.<\/p>\n
\n\n\n\n\n\n\n
Fun\u00e7\u00e3o<\/th>\nAssinatura<\/th>\nRetorno<\/th>\n<\/tr>\n<\/thead>\n
SetBit<\/td>\nSetBit(Value, BitIndex, BitValue)<\/code><\/td>\nInteiro com sinal de 32 bits (o valor de Value<\/code> com o bit alterado)<\/td>\n<\/tr>\n
GetBit<\/td>\nGetBit(Value, BitIndex)<\/code><\/td>\nBooleano (True<\/code>\/False<\/code>) do bit indicado<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
Par\u00e2metros de SetBit<\/code>:<\/p>\n
    \n
  • Value<\/code><\/strong>: inteiro sem sinal de 32 bits. Se um valor de ponto flutuante for informado, apenas a parte inteira<\/strong> \u00e9 utilizada.<\/li>\n
  • BitIndex<\/code><\/strong>: posi\u00e7\u00e3o do bit, de 0 a 31<\/strong>. Valores fora dessa faixa geram erro<\/strong>.<\/li>\n
  • BitValue<\/code><\/strong>: booleano (True<\/code> ou False<\/code>) a atribuir ao bit.<\/li>\n<\/ul>\n<\/section>\n
    \n
    3.<\/span>\u00a0Por que a altera\u00e7\u00e3o n\u00e3o tem efeito<\/h2>\n
    SetBit<\/code> \u00e9 uma fun\u00e7\u00e3o pura<\/strong>: ela recebe um n\u00famero, calcula um novo n\u00famero com o bit ajustado e devolve esse resultado<\/strong>. Ela n\u00e3o modifica<\/strong> a vari\u00e1vel passada como Value<\/code> nem escreve diretamente no tag.<\/p>\n
    Quando se escreve apenas SetBit(Tag.Value, 0, False)<\/code>, o novo valor \u00e9 produzido e imediatamente descartado<\/strong>, e o tag continua com o valor antigo. A solu\u00e7\u00e3o \u00e9 fechar o ciclo ler, modificar e escrever<\/strong> em uma \u00fanica atribui\u00e7\u00e3o: reatribuir o retorno de SetBit<\/code> ao Value<\/code> do tag.<\/p>\n
    \n
    Por que isso resolve o problema?<\/p>\n
    Ao atribuir o retorno de SetBit<\/code> de volta a Tag.Value<\/code>, o E3 grava o novo inteiro no tag. \u00c9 essa grava\u00e7\u00e3o que efetiva a altera\u00e7\u00e3o do bit.<\/p>\n<\/div>\n<\/section>\n
    \n
    4.<\/span>\u00a0Como usar<\/h2>\n
    Por script<\/h3>\n
    Para atribuir o valor False<\/strong> ao bit 0<\/strong> de um tag:<\/p>\n
    \n
    ' Seta o valor FALSE no bit 0 do tag\r\nApplication.GetObject(\"Driver.Tag1\").Value = _\r\nSetBit(Application.GetObject(\"Driver.Tag1\").Value, 0, False)<\/pre>\n
    Para ligar<\/strong> o mesmo bit, basta trocar o \u00faltimo par\u00e2metro para True<\/code>:<\/p>\n<\/div>\n
    \n
    'Seta o valor TRUE no bit 0 do tag\r\nApplication.GetObject(\"Driver.Tag1\").Value = _\r\nSetBit(Application.GetObject(\"Driver.Tag1\").Value, 0, True)<\/pre>\n
    Para ler<\/strong> o estado de um bit (por exemplo, o bit 3):<\/p>\n<\/div>\n
    \n
    'Retorna True ou False conforme o bit 3 do tag\r\nDim bEstado\r\nbEstado = GetBit(Application.GetObject(\"Driver.Tag1\").Value, 3)<\/pre>\n
    Em uma associa\u00e7\u00e3o<\/h3>\n<\/div>\n
    Como SetBit<\/code>\/GetBit<\/code> tamb\u00e9m funcionam em associa\u00e7\u00f5es, \u00e9 poss\u00edvel, por exemplo, associar uma propriedade de um objeto de tela ao estado de um bit com GetBit(Tag.Value, n)<\/code>.<\/p>\n<\/section>\n
    \n
    5.<\/span>\u00a0Resultado<\/h2>\n
    \n\n\n\n\n\n\n
    Forma de uso<\/th>\nComportamento<\/th>\n<\/tr>\n<\/thead>\n
    Retorno descartado<\/span>
    \nSetBit(Tag.Value, 0, False)<\/code><\/td>\n    		O bit \u00e9 calculado, mas o tag n\u00e3o muda<\/strong>.<\/td>\n<\/tr>\n
    Retorno reatribu\u00eddo<\/span>
    \nTag.Value = SetBit(Tag.Value, 0, False)<\/code><\/td>\n    		O tag recebe o novo inteiro e a altera\u00e7\u00e3o do bit \u00e9 efetivada<\/strong>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/section>\n
    \n
    6.<\/span>\u00a0Observa\u00e7\u00f5es e boas pr\u00e1ticas<\/h2>\n
      \n
    • Reatribua sempre o retorno.<\/strong> SetBit<\/code> nunca altera o valor no local. O resultado precisa ser gravado de volta no tag (ou em outra vari\u00e1vel) para ter efeito.<\/li>\n
    • Grava\u00e7\u00e3o do inteiro completo.<\/strong> A atribui\u00e7\u00e3o grava no tag o inteiro completo de 32 bits, n\u00e3o apenas o bit alterado. Se outra origem tamb\u00e9m escreve nesse tag, avalie a concorr\u00eancia de escrita para n\u00e3o sobrescrever valores.<\/li>\n
    • Faixa do \u00edndice.<\/strong> BitIndex<\/code> deve estar entre 0 e 31<\/strong>. Fora disso, ocorre erro.<\/li>\n
    • Valores fracion\u00e1rios.<\/strong> Se Value<\/code> for de ponto flutuante, apenas a parte inteira \u00e9 considerada.<\/li>\n
    • Retorno com sinal.<\/strong> SetBit<\/code> retorna um inteiro com sinal de 32 bits. Para bits altos, o n\u00famero resultante pode aparecer negativo, mas o padr\u00e3o de bits gravado \u00e9 o correto.<\/li>\n
    • Leitura com GetBit.<\/strong> Para testar um bit sem alter\u00e1-lo, use GetBit<\/code>, que retorna diretamente True<\/code>\/False<\/code>.<\/li>\n<\/ul>\n<\/section>\n
      <\/section>\n