> ## Documentation Index
> Fetch the complete documentation index at: https://villagesql.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Extensão vsql_luhn para MySQL

> A extensão da comunidade vsql_luhn valida dígitos verificadores de Luhn no MySQL e os gera, para números de cartão, códigos IMEI, códigos de barras e identificadores semelhantes.

Números de cartão, códigos IMEI e números de seguro social canadenses carregam
um dígito verificador de Luhn, e um dígito errado é a forma mais comum de um
identificador digitado ficar inválido. O `vsql_luhn` verifica esse dígito e o
gera, de modo que uma restrição `CHECK` pode recusar um número inválido antes
que ele chegue a uma linha.

| | |
| - | - |
| **Mantenedor** | [Anurag Ojha](https://github.com/intojhanurag) |
| **Código-fonte e documentação** | [intojhanurag/vsql-luhn](https://github.com/intojhanurag/vsql-luhn) |
| **Licença** | GPL-2.0 |

> [!NOTE]
>
> Um terceiro escreve e mantém esta extensão. O VillageSQL não a compila, não a
> testa e não a distribui, e a descrição abaixo segue a documentação do próprio
> mantenedor. Leia essa documentação antes de depender dela.

## Instalar

Compile-o a partir do repositório com uma árvore de compilação do VillageSQL (`VillageSQL_BUILD_DIR`), copie o arquivo `.veb` para o `veb_dir` do servidor e, em seguida, instale-o:

```sql theme={null}
INSTALL EXTENSION vsql_luhn;
```

## O que ela adiciona

| Função | Retorna | O que faz |
| - | - | - |
| `luhn_valid(value)` | int | 1 quando a string passa na soma de verificação, 0 quando não passa. Espaços em branco e hifens são ignorados, e texto não numérico retorna 0 em vez de um erro |
| `luhn_checkdigit(partial)` | texto | Acrescenta o dígito verificador correto a um identificador parcial |

Como o `luhn_valid` responde 0 em vez de falhar com texto que não é um número,
ele se encaixa diretamente em uma cláusula `WHERE` sobre uma coluna de entrada
não validada.

## Veja também

* [Extensões disponíveis](https://villagesql.com/docs/pt-BR/extensions/catalog) — o catálogo completo
* [intojhanurag/vsql-luhn](https://github.com/intojhanurag/vsql-luhn) — código-fonte, exemplos e as limitações conhecidas


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.