TOTVSTEC

Árvore de páginas

Valida se uma string está formatada conforme um determinado padrão.

Sintaxe

Match( < cValue >, < cMask > )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cValue

caractere

Indica o valor que será validado contra um padrão.

X

 

cMask

caractere

Indica a máscara com o padrão para validar cValue.

X

 

Retorno

Nome

Tipo

Descrição

lRet

lógico

Retorna .T. caso cValue seja validado pelo padrão indicado em cMask; caso contrário, retornará .F..

Observações

  • cMask aceita apenas os carcateres * e ? como coringas.
  • O caractere curinga * indica 0 ou mais caracteres quaisquer.
  • O caractere curinga ? indica 1 caractere qualquer.
  • Se cMask for vazio, a função retornará .T..
  • A função não é case sensitive, ou seja, não faz diferenciação entre letra maiúscula e minúscula.

Exemplos

Exemplo 1
#DEFINE CRLF Chr(13)+Chr(10)
User Function match1()
  Local cMensagem := ""
  
  //+----------------------------------------------------------------------------+
  //|Exemplifica o uso da função Match                                           |
  //+----------------------------------------------------------------------------+
  
  cMensagem += 'Match("BAAA", "b*") = '  + cValToChar( Match( "BAAA", "b*" ) )  + CRLF
  cMensagem += 'Match("baaa", "b*a") = ' + cValToChar( Match( "baaa", "b*a" ) ) + CRLF
  cMensagem += 'Match("baaa", "b?a") = ' + cValToChar( Match( "baaa", "b?a" ) ) + CRLF
  cMensagem += 'Match("ba", "b?a") = '   + cValToChar( Match( "ba", "b?a" ) )   + CRLF
  cMensagem += 'Match("bxa", "b?a") = '  + cValToChar( Match( "bxa", "b?a" ) )  + CRLF
  cMensagem += 'Match("Automatic", "*m?t*i*") = ' + cValToChar( Match( "Automatic", "*m?t*i*" ) ) + CRLF

  //+----------------------------------------------------------------------------+
  //|Apresenta uma mensagem com os resultados obtidos                            |
  //+----------------------------------------------------------------------------+
Return MsgInfo( cMensagem, "Exemplo do Match" )

Resultado do Exemplo

Abrangência

Disponível a partir da build 7.00.131227A com data de geração superior a 23/11/2015.

  • Sem rótulos