cStringCaractereObrigatório
String de bits.
FUNçãOEm revisão
BITON()
BitOn( <cString>, <nInitialBit>, <nCountBits>, <nStringSize> )Registra o contrato parcial de ativação de bits em string.
Visão geral
A ficha BITON() informa ativação de bits de uma string, com quatro parâmetros: string, bit inicial, quantidade de bits e tamanho da string. Não é a assinatura numérica BitOn(nNumero,nBit). A página não esclarece a base de contagem, representação do retorno ou efeitos de limites inválidos. Por isso esta revisão não apresenta resultado binário esperado nem recomenda a chamada para permissões ou formatos reais. O exemplo isola uma consulta diagnóstica sobre um byte fictício e registra somente o tipo retornado, sujeito a homologação. (TOTVS, s.d., ref. 1)
Sintaxe
BitOn( <cString>, <nInitialBit>, <nCountBits>, <nStringSize> )Parâmetros
nInitialBitNuméricoObrigatório
Bit inicial; base não esclarecida.
nCountBitsNuméricoObrigatório
Quantidade de bits.
nStringSizeNuméricoObrigatório
Tamanho da string.
Retorno
Não especificado na ficha; confirmar tipo e conteúdo em homologação.
Exemplo comentado
#Include "Protheus.ch"
User Function EdBiton()
Local cTeste := Chr(0)
Local xRetorno
// Diagnostico isolado; nao representa formato de producao.
xRetorno := BitOn(cTeste, 1, 1, Len(cTeste))
ConOut(ValType(xRetorno))
Return NilResultado esperado
Tipo do retorno a verificar; nenhum valor binário é presumido. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Registrar build, entrada em hexadecimal e resultado em testes isolados antes de documentar semântica adicional. Não substituir por API numérica homônima.
- Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.