VStringBr extension Atalhos
Atalhos de validadores brasileiros em cima de VString.
Cada atalho delega ao método equivalente do core com o pattern BR
plugado. Toda a API pública dos atalhos é em pt-BR (modo,
mensagem, alfanumerico, etc.) — internamente cada atalho faz
o depara para os parâmetros do core (mode, message, etc.).
A forma explícita via pattern continua disponível e usa os nomes originais (em inglês) — afinal, ela é o ponto de extensão do próprio core:
V.string().cpf(); // atalho (pt-BR)
V.string().taxId(patterns: [const CpfPattern()]); // explícita (core)
V.string().placa();
V.string().licensePlate(patterns: [const PlacaPattern()]);
V.string().telefone(apenasCelular: true);
V.string().phone(patterns: [const TelefonePattern(mobileOnly: true)]);
See also:
- VLocaleBr, que traduz para pt-BR as mensagens de erro que estes atalhos emitem.
- ModoValidacao, FormatoDdd, FormatoPais, TipoChavePix e FormatoBoleto, os enums pt-BR que os atalhos recebem.
- CpfPattern e os demais patterns, para a forma explícita.
- on
-
- VString
Methods
-
boleto(
{FormatoBoleto? formato, String? mensagem}) → VString -
Available on VString, provided by the VStringBr extension
Valida boletos brasileiros — bancário (cobrança) ou de arrecadação (concessionárias e tributos), tanto na forma de linha digitável (47/48 dígitos) quanto código de barras (44 dígitos). Aceita máscara — caracteres não numéricos são descartados. -
cep(
{ModoValidacao modo = ModoValidacao.qualquer, String? mensagem}) → VString -
Available on VString, provided by the VStringBr extension
Valida que a string é um CEP válido (8 dígitos). -
chavePix(
{List< TipoChavePix> tipos = ChavePixValidator.defaultAllow, String? mensagem}) → VString -
Available on VString, provided by the VStringBr extension
Valida que a string é um identificador PIX válido. -
cnh(
{String? mensagem}) → VString -
Available on VString, provided by the VStringBr extension
Valida que a string é uma CNH válida (11 dígitos). -
cnpj(
{ModoValidacao modo = ModoValidacao.qualquer, bool alfanumerico = true, String? mensagem}) → VString -
Available on VString, provided by the VStringBr extension
Valida que a string é um CNPJ válido. -
codigoBanco(
{String? mensagem}) → VString -
Available on VString, provided by the VStringBr extension
Valida que a string é um código de banco brasileiro válido — 3 dígitos da tabela COMPE do Banco Central. -
cpf(
{ModoValidacao modo = ModoValidacao.qualquer, String? mensagem}) → VString -
Available on VString, provided by the VStringBr extension
Valida que a string é um CPF válido (11 dígitos com dois DVs). -
ddd(
{String? mensagem}) → VString -
Available on VString, provided by the VStringBr extension
Valida que a string é um DDD brasileiro válido — 2 dígitos da lista oficial Anatel. -
pis(
{ModoValidacao modo = ModoValidacao.qualquer, String? mensagem}) → VString -
Available on VString, provided by the VStringBr extension
Valida que a string é um PIS/PASEP/NIS válido (11 dígitos). -
placa(
{ModoValidacao modo = ModoValidacao.qualquer, String? mensagem}) → VString -
Available on VString, provided by the VStringBr extension
Valida que a string é uma placa de veículo brasileira — formato antigo (AAA-9999/AAA9999) ou Mercosul (AAA9A99). -
Available on VString, provided by the VStringBr extension
Valida que a string é um Renavam válido (11 dígitos). -
telefone(
{FormatoDdd ddd = FormatoDdd.opcional, FormatoPais pais = FormatoPais.opcional, bool apenasCelular = false, ModoValidacao modo = ModoValidacao.qualquer, String? mensagem}) → VString -
Available on VString, provided by the VStringBr extension
Valida que a string é um telefone brasileiro válido. -
tituloEleitor(
{String? mensagem}) → VString -
Available on VString, provided by the VStringBr extension
Valida que a string é um título de eleitor válido (12 dígitos, UF01..28). -
uf(
{String? mensagem}) → VString -
Available on VString, provided by the VStringBr extension
Valida que a string é uma sigla de UF brasileira válida — uma das 27 unidades federativas em caixa alta (AC,AL, ...,TO).