ILIKE ANY¶

Sintaxe¶

<subject> ILIKE ANY (<pattern1> [, <pattern2> ... ] ) [ ESCAPE <escape_char> ]

Argumentos¶

Obrigatório:

subject

A cadeia de caracteres a ser comparada com o(s) padrão(s).

pattern#

O(s) padrão(s) com o(s) qual(is) a cadeia de caracteres deve ser comparada. Você deve especificar pelo menos um padrão.

Opcional:

escape_char

Caractere(s) inserido(s) na frente de um curinga para indicar que o curinga deve ser interpretado como um caractere normal e não como um curinga.

Retornos¶

O tipo de dados do valor retornado é VARCHAR.

Notas de uso¶

• Curingas SQL são suportados em pattern:

  • Um sublinhado (_) corresponde a qualquer caractere individual.

  • Um sinal de porcentagem (%) corresponde a qualquer sequência de zero ou mais caracteres.

• Os caracteres curinga em pattern incluem caracteres de nova linha (\n) em subject como correspondências.

• O padrão é considerado compatível se corresponder a toda a cadeia de caracteres de entrada (assunto). Para combinar uma sequência em qualquer lugar dentro de uma cadeia de caracteres, comece e termine o padrão com %, por exemplo ‘%algo%’.

• NULL não é compatível com NULL. Em outras palavras, se o assunto é NULL e um dos padrões é NULL, isso não é considerado uma correspondência.

• Se a função for usada com uma subconsulta, a subconsulta deve retornar uma única linha.

  Por exemplo, o seguinte só deve ser usado se a subconsulta retornar uma única linha:

  SELECT ...
      WHERE x ILIKE ANY (SELECT ...)
  

Exemplos¶

Isso mostra como usar ILIKE ANY:

Criar uma tabela que contenha algumas cadeias de caracteres:

CREATE OR REPLACE TABLE ilike_example(subject varchar(20));
INSERT INTO ilike_example VALUES
    ('jane doe'),
    ('Jane Doe'),
    ('JANE DOE'),
    ('John Doe'),
    ('John Smith');

SELECT * 
  FROM ilike_example 
  WHERE subject ILIKE ANY ('jane%', '%SMITH')
  ORDER BY subject;
+------------+
| SUBJECT    |
|------------|
| JANE DOE   |
| Jane Doe   |
| John Smith |
| jane doe   |
+------------+

Para exemplos de como usar caracteres curinga, consulte a documentação da função relacionada LIKE ANY.