elements.c File Reference

Element names and symbols. See: https://iupac.org/what-we-do/periodic-table-of-elements. More...

#include "tpcclibConfig.h"
#include <stdio.h>
#include <stdlib.h>
#include <math.h>
#include <time.h>
#include <string.h>
#include "tpcisotope.h"

Go to the source code of this file.

Functions
char *	elementName (unsigned short int z)
char *	elementSymbol (unsigned short int z)
unsigned short int	elementIdentify (const char *str)

Detailed Description

Element names and symbols. See: https://iupac.org/what-we-do/periodic-table-of-elements.

Definition in file elements.c.

Function Documentation

elementIdentify()

unsigned short int elementIdentify

(

const char *

str

)

Identify the given string representation of element name or symbol.

See also

elementName, elementSymbol, isotopeIdentify

Returns

Element atomic number Z, or 0 if not identified.

Parameters

str	Name or symbol of element, for example 'Carbon' or 'C'.

Definition at line 298 of file elements.c.

  {
  if(str==NULL || strnlen(str, 5)<1) return(0); 
 
  /* First, search string from the list of element names */
  for(unsigned short int z=1; z<MAX_ATOMIC_NUMBER; z++)
    if(strcasecmp(str, element_name[z])==0) return(z);
 
  /* Then, search string from the list of element symbols */
  for(unsigned short int z=1; z<MAX_ATOMIC_NUMBER; z++)
    if(strcasecmp(str, element_symbol[z])==0) return(z);
 
  /* Not yet successful; then try to find element name as part of the string */
  for(unsigned short int z=1; z<MAX_ATOMIC_NUMBER; z++)
    if(strcasestr(str, element_name[z])!=NULL) return(z);
 
  /* Then try to find two-char element symbol as part of the string */
  for(unsigned short int z=1; z<MAX_ATOMIC_NUMBER; z++)
    if(strlen(element_symbol[z])>1 && strstr(str, element_symbol[z])!=NULL) return(z);
  /* Desperate last step... try to find one-char element symbol as part of the string */
  for(unsigned short int z=1; z<MAX_ATOMIC_NUMBER; z++)
    if(strlen(element_symbol[z])==1 && strstr(str, element_symbol[z])!=NULL) return(z);
 
  return(0);
}

Referenced by isotopeIdentify().

elementName()

char * elementName

(

unsigned short int

z

)

Return pointer to element name.

See also

elementSymbol, elementIdentify

Returns

pointer to the name string.

Parameters

z	Atomic number (Z) of the element.

Definition at line 270 of file elements.c.

  {
  if(z>MAX_ATOMIC_NUMBER) return(element_name[0]);
  return(element_name[z]);
}

elementSymbol()

char * elementSymbol

(

unsigned short int

z

)

Return pointer to element symbol.

See also

elementName, elementIdentify

Returns

pointer to the symbol string.

Parameters

z	Atomic number (Z) of the element.

Definition at line 284 of file elements.c.

  {
  if(z>MAX_ATOMIC_NUMBER) return(element_name[0]);
  return(element_symbol[z]);
}