Retorna a posição inicial em bytes da primeira instância de agulha em palheiro. Retorna nulo se agulha não estiver em palheiro. A contagem começa em 1 (não zero).
A contagem é sempre feita na direção natural da localidade do anunciante.
Essa função destina-se principalmente a idiomas que não usam um conjunto de caracteres latinos, como é o caso do japonês e do chinês. Se a string ou atributo de inventário estiverem em um idioma que usa um conjunto de caracteres latinos de byte único, como o inglês, searchb
retornará o mesmo valor que search.
Sintaxe
searchb(agulha, palheiro)
Saiba mais sobre a sintaxe das funções.
Parâmetro
agulha e palheiro podem ser qualquer um destes:
- uma constante de string, como "GDN"
-
um atributo de inventário ou coluna de fórmula que retorna uma string
Saiba mais sobre referências a atributos de inventário.
Sem diferenciação de maiúsculas e minúsculas
As pesquisas de texto não diferem maiúsculas e minúsculas.
Caractere vazio
Se você incluir uma coluna de fórmula ou expressão nessa função, a coluna de fórmula ou expressão poderia avaliar como uma string vazia.
Pesquisar uma string vazia sempre retorna "1". Assim, searchb("", "GDN")
avalia como "1".
Exemplos
-
searchb("Δ", "ΓaΔbΘc")
retorna 4, que é o byte inicial do terceiro caractere. O primeiro caractere de palheiro é de 2 bytes e o segundo caractere é de 1 byte. -
searchb("a", "ΓaΔbΘc")
retorna 3, que é o byte inicial do segundo caractere. -
searchb("ー", "スニーカー")
retorna 5, que é o local do primeiroー
ao contar bytes em um conjunto de caracteres de byte duplo. -
searchb("", "ΓaΔbΘc")
retorna 1, pois a função pesquisa uma string vazia. A pesquisa por uma string vazia retorna 1, mesmo que o primeiro caractere seja de 2 bytes.