- Categorias:
Funções de cadeia de caracteres e binários (Correspondência/Comparação)
ILIKE ANY¶
Permite a correspondência, sem distinção entre maiúsculas e minúsculas, de cadeias de caracteres com base na comparação com um ou mais padrões.
A operação é semelhante a LIKE
. Se a cadeia de caracteres de entrada corresponder a qualquer um dos padrões, isto retornará a cadeia de caracteres de entrada.
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
) emsubject
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.