.FCSys.Utilities.Chemistry.readElement .FCSys.Utilities.Chemistry.readElementThis function returns the symbol (symbol),
stoichiometric coefficient (n), and electrical charge
(z) associated with an element as it appears in a chemical
formula (formula). After any initial whitespace in the
formula string, which is ignored, the symbol must
begin with a letter and may continue with lowercase letters. The
symbol may be followed by a positive integer and then a charge
number (both independently optional). If present, the charge number
must begin with "+" or "-" and may be followed by optional digits.
The remainder output gives the remainder of the
formula string after the symbol, coefficient, and
charge have been extracted.
If the coefficient is not explicitly given, then it is assumed
to be one. If the charge number is not given, then it is assumed to
be zero. A "+" or "-" without following digits is interpreted as a
charge of +1 or -1, respectively. If there is an error, then
symbol will be an empty string.
Example:
(symbol, n, z, remainder) = readElement("Hg2+2")
returns symbol="Hg", n=2,
z=2, and remainder="".
function readElement
extends Modelica.Icons.Function;
input String formula "Chemical formula";
output String symbol "Name of element (empty if error)";
output Integer n "Stoichiometric coefficient" annotation(
Dialog(__Dymola_label = "<html><i>n</i></html>"));
output Integer z "Charge number" annotation(
Dialog(__Dymola_label = "<html><i>z</i></html>"));
output String remainder "Remainder of the chemical formula";
end readElement;