Función para mostrar un contacto

Basándote en tu sistema de gestión de contactos de las lecciones anteriores, crea una función que muestre la información de contacto de forma estructurada. En esta lección se presentan tres funciones nuevas para cadenas que necesitarás: fgets(), strcspn() y strchr(): cada una se explica a continuación antes de los requisitos.

Nuevas funciones utilizadas en esta lección:

• fgets(buffer, size, stdin): lee una línea de entrada, incluidos los espacios (a diferencia de scanf, que se detiene ante los espacios en blanco). Almacena la entrada en buffer, leyendo como máximo size - 1 caracteres. También almacena el carácter de nueva línea '\n' al final.
• strcspn(str, "\n"): devuelve el índice de la primera aparición de '\n' en str. Se utiliza para eliminar la nueva línea final que deja fgets: str[strcspn(str, "\n")] = '\0';
• strchr(str, ch): busca el carácter ch en str y devuelve un puntero a su ubicación, o NULL si no se encuentra.

Tu programa debe:

1. Usar la misma definición de la estructura Contact de las lecciones anteriores, con los miembros:
   • Un arreglo de caracteres name con tamaño 50
   • Un arreglo de caracteres phone con tamaño 20
   • Un arreglo de caracteres email con tamaño 40
   • Un entero age
2. Usar la misma función createContact de las lecciones anteriores, que:
   • Asigna memoria dinámicamente para una estructura Contact
   • Inicializa todos los miembros con valores predeterminados
   • Devuelve un puntero al contacto
3. Escribir una función populateContact que:
   • Reciba como parámetro un puntero a una estructura Contact
   • Use fgets() para leer cada campo de cadena (nombre, teléfono y correo electrónico), de modo que se acepten nombres con espacios
   • Use strcspn() para eliminar la nueva línea final de cada campo de cadena después de leerlo
   • Use scanf("%d", ...) para leer el campo entero de edad
   • Nota: Esta versión de populateContact no incluye la validación de la longitud del número de teléfono: no la agregues, ya que las entradas de prueba usan números de teléfono cortos como 555-1234
4. Escribir una función llamada displayContact que:
   • Reciba como parámetro un puntero constante a una estructura Contact: const struct Contact *contactPtr
   • No devuelva nada (void)
   • Imprima la información de contacto con este formato exacto:
     • === CONTACT DETAILS ===
     • Name: [name]
     • Phone: [phone]
     • Email: [email]
     • Age: [age] years old
     • ========================
   • Después de mostrar la información básica, calcular y mostrar detalles adicionales:
     • Calcular la longitud del nombre usando strlen() e imprimir: Name length: [length] characters
     • Determinar la categoría generacional según la edad e imprimir:
       • Si la edad está entre 0 y 12: Generation: Child
       • Si la edad está entre 13 y 19: Generation: Teenager
       • Si la edad está entre 20 y 39: Generation: Young Adult
       • Si la edad está entre 40 y 59: Generation: Middle-aged Adult
       • Si la edad es de 60 o más: Generation: Senior
     • Comprobar si el correo electrónico contiene el carácter '@' usando strchr() e imprimir:
       • Si se encuentra '@': Email format: Valid
       • Si no se encuentra '@': Email format: Invalid
5. En la función principal:
   • Crear un contacto usando la función createContact
   • Comprobar si la creación del contacto se realizó correctamente
   • Llamar a la función populateContact para completar los datos del contacto
   • Llamar a la función displayContact para mostrar la información de contacto estructurada
   • Liberar la memoria asignada dinámicamente
   • Imprimir Program completed successfully

Este desafío demuestra cómo crear una función de visualización que recibe un puntero constante a una estructura, lo que garantiza que la función no pueda modificar los datos originales. Practicarás el uso de fgets() para leer cadenas que contienen espacios, strcspn() para eliminar nuevas líneas finales, el operador flecha para acceder a los miembros de una estructura mediante un puntero, strchr() para buscar caracteres y la lógica condicional para categorizar datos. El uso de const en la declaración del parámetro es una buena práctica que evita la modificación accidental de los datos del contacto dentro de la función de visualización.