Função para Exibir um Contato

Parte da seção Logic & Flow do Journey de C da Coddy — lição 53 de 63.

Desafio

Fácil

Com base no seu sistema de gerenciamento de contatos das lições anteriores, crie uma função que exiba as informações do contato de forma formatada. Esta lição apresenta três novas funções de string que você precisará: fgets(), strcspn() e strchr() — cada uma é explicada abaixo antes dos requisitos.

Novas funções usadas nesta lição:

fgets(buffer, size, stdin) — lê uma linha de entrada incluindo espaços (ao contrário do scanf, que para no espaço em branco). Ela armazena a entrada no buffer, lendo no máximo size - 1 caracteres. Ela também armazena o caractere de nova linha '\n' ao final.
strcspn(str, "\n") — retorna o índice da primeira ocorrência de '\n' em str. Usado para remover a nova linha residual deixada pelo fgets: str[strcspn(str, "\n")] = '\0';
strchr(str, ch) — procura pelo caractere ch em str e retorna um ponteiro para sua localização, ou NULL se não for encontrado.

Seu programa deve:

Usar a mesma definição da struct Contact das lições anteriores com os membros:
- Um array de caracteres name com tamanho 50
- Um array de caracteres phone com tamanho 20
- Um array de caracteres email com tamanho 40
- Um inteiro age
Usar a mesma função createContact das lições anteriores que:
- Aloca dinamicamente memória para uma struct Contact
- Inicializa todos os membros com valores padrão
- Retorna um ponteiro para o contato
Escrever uma função populateContact que:
- Recebe um ponteiro para uma struct Contact como seu parâmetro
- Usa fgets() para ler cada campo de string (nome, telefone, e-mail) para que nomes com espaços sejam aceitos
- Usa strcspn() para remover a nova linha residual de cada campo de string após a leitura
- Usa scanf("%d", ...) para ler o campo de idade inteiro
- Nota: Esta versão da populateContact não inclui validação de comprimento de número de telefone — não a adicione, pois as entradas de teste usam números de telefone curtos como 555-1234
Escrever uma função chamada displayContact que:
- Recebe um ponteiro constante para uma struct Contact como seu parâmetro: const struct Contact *contactPtr
- Não retorna nada (void)
- Imprime as informações do contato exatamente neste formato:
  - === CONTACT DETAILS ===
  - Name: [name]
  - Phone: [phone]
  - Email: [email]
  - Age: [age] years old
  - ========================
- Após exibir as informações básicas, calcula e exibe detalhes adicionais:
  - Calcula o comprimento do nome usando strlen() e imprime: Name length: [length] characters
  - Determina a categoria da geração com base na idade e imprime:
    - Se a idade estiver entre 0 e 12: Generation: Child
    - Se a idade estiver entre 13 e 19: Generation: Teenager
    - Se a idade estiver entre 20 e 39: Generation: Young Adult
    - Se a idade estiver entre 40 e 59: Generation: Middle-aged Adult
    - Se a idade for 60 ou superior: Generation: Senior
  - Verifica se o e-mail contém o caractere '@' usando strchr() e imprime:
    - Se '@' for encontrado: Email format: Valid
    - Se '@' não for encontrado: Email format: Invalid
Na função main:
- Cria um contato usando a função createContact
- Verifica se a criação do contato foi bem-sucedida
- Chama a função populateContact para preencher os dados do contato
- Chama a função displayContact para mostrar as informações formatadas do contato
- Libera a memória alocada dinamicamente
- Imprime Program completed successfully

Este desafio demonstra como criar uma função de exibição que recebe um ponteiro constante para uma struct, garantindo que a função não possa modificar os dados originais. Você praticará o uso de fgets() para ler strings que contêm espaços, strcspn() para remover novas linhas residuais, o operador de seta para acessar membros da struct através de um ponteiro, strchr() para busca de caracteres e lógica condicional para categorização de dados. O uso de const na declaração do parâmetro é uma boa prática que evita a modificação acidental dos dados do contato dentro da função de exibição.

Experimente você mesmo

#include <stdio.h>
#include <stdlib.h>
#include <string.h>

typedef struct {
    char name[50];
    char phone[20];
    char email[40];
    int age;
} Contact;

Contact* createContact() {
    Contact* contact = (Contact*)malloc(sizeof(Contact));
    if (contact == NULL) {
        return NULL;
    }
    
    strcpy(contact->name, "");
    strcpy(contact->phone, "");
    strcpy(contact->email, "");
    contact->age = 0;
    
    return contact;
}

void populateContact(Contact* contactPtr) {
    printf("Enter name: ");
    scanf("%s", contactPtr->name);
    
    printf("Enter phone: ");
    scanf("%s", contactPtr->phone);
    
    printf("Enter email: ");
    scanf("%s", contactPtr->email);
    
    printf("Enter age: ");
    scanf("%d", &contactPtr->age);
    
    if (contactPtr->age < 0 || contactPtr->age > 120) {
        printf("Invalid age entered\n");
    } else if (strlen(contactPtr->phone) < 10) {
        printf("Invalid phone number\n");
    } else {
        printf("Contact populated successfully\n");
    }
}

int main() {
    Contact* contact = createContact();
    
    if (contact == NULL) {
        return 1;
    }
    
    populateContact(contact);
    
    printf("Contact Information:\n");
    printf("Name: %s\n", contact->name);
    printf("Phone: %s\n", contact->phone);
    printf("Email: %s\n", contact->email);
    printf("Age: %d\n", contact->age);
    
    free(contact);
    printf("Contact deleted successfully\n");
    
    return 0;
}

Todas as lições de Logic & Flow

3Arrays de Caracteres e Strings

Strings como Arrays de char O Terminador Nulo Entrada de Strings com scanf Usando strlen()Usando strcpy()Usando strcat()Usando strcmp()Recapitulação: Funções Básicas de Strings

6Gerenciamento de Memória

Memória Stack vs. Heap Alocação Dinâmica - malloc()Usando sizeof() para Alocação Verificando Falhas de Alocação Liberando Memória com free()Alocando com calloc()Recapitulação: Array Dinâmico

9Projeto: Cadastro Simples de Contatos

Projeto: Definir a Struct de Contato Função para Criar um Contato

Função para Preencher um Contato

Função para Exibir um Contato Lição de projeto

Juntando Tudo