A função verificaNomeCompleto é uma função em PHP que tem como objetivo validar se uma string passada como argumento ($nome) pode ser considerada um nome completo. Para isso, a função verifica se o nome contém pelo menos dois componentes (como nome e sobrenome) e se esses componentes possuem pelo menos dois caracteres cada.
Abaixo está o detalhamento de cada passo da função:
1. Recebe o parâmetro $nome:
A função recebe um argumento $nome, que deve ser uma string representando o nome a ser validado.
function nomeDaFuncao($parametro1, $parametro2) {
// Código a ser executado
return $resultado; // O retorno é opcional
}
2. Aplica trim($nome):
A função utiliza trim($nome) para remover quaisquer espaços em branco no início e no final da string. Isso garante que eventuais espaços adicionais não interfiram na validação.
$nome = trim($nome);
3. Separa a string em partes usando explode(' ', $nome):
A função utiliza explode(' ', $nome) para dividir a string em um array de palavras, separando as partes onde houver espaços.
Por exemplo, se $nome for "João da Silva", o array resultante será ['João', 'da', 'Silva'].
$nomeCompleto = explode(' ', $nome);
4. Verifica se há pelo menos dois componentes:
A função usa count($nomeCompleto) para contar o número de partes (palavras) que compõem o nome.
Se o número de partes for menor que 2, a função retorna false, indicando que o nome não é considerado completo.
if(count($nomeCompleto) < 2){
return false;
}
5. Verifica se o primeiro nome tem pelo menos 2 caracteres:
A função utiliza strlen($nomeCompleto[0]) para verificar o comprimento da primeira palavra (primeiro nome).
Se o comprimento da primeira palavra for menor que 2 caracteres, a função retorna false.
if(strlen($nomeCompleto[0]) < 2){
return false;
}
6. Verifica se a segunda palavra tem pelo menos 2 caracteres:
Da mesma forma, a função verifica o comprimento da segunda palavra (normalmente o sobrenome) usando strlen($nomeCompleto[1]).
Se o comprimento da segunda palavra for menor que 2 caracteres, a função retorna false.
if(strlen($nomeCompleto[1]) < 2){
return false;
}
7. Retorna true se todas as verificações passarem:
Se o nome passou por todas as verificações acima, a função retorna true, indicando que o nome é considerado válido como um nome completo.
return true;
Resumo
Entrada: Uma string $nome.
Saída: true se $nome é considerado um nome completo,
false caso contrário.
Critérios de validação:
O nome deve ter pelo menos dois componentes.
O primeiro e o segundo componentes devem ter, no mínimo, 2 caracteres cada.
Exemplo de uso:
$nomeValido = "João Silva";
$nomeInvalido = "J S";
var_dump(verificaNomeCompleto($nomeValido)); // true
var_dump(verificaNomeCompleto($nomeInvalido)); // false
Neste exemplo, "João Silva" é um nome válido, enquanto "J S" não é, pois as palavras têm menos de 2 caracteres.