Returns information about a unit in the units table
Unit specifications might include an optional 'physical dimension' qualifier (e.g. 'bfield:g') In this case, 'phys_dim' returns the physical dimension, and the qualifier is used to match the unit. This version is case-insensitive (e.g. 'g' and 'G' could stand for 'Gauss'). As the above example indicates, in the absence of a physical dimension qualifier, 'g' might be ambiguous ('bfield' or 'mass'?). The routine will return 'stat=-1' in this case. Units might be ambiguous in a more serious way: 'meV' and 'MeV' could both be present in the table. In this case, it might be advisable to use a case-sensitive version of this routine (replacing 'leqi' by a 'strict' version). If the unit is not found in the table, the routine returns 'stat=-2'.
| Type | Intent | Optional | Attributes | Name | ||
|---|---|---|---|---|---|---|
| character(len=*), | intent(in) | :: | unit_str |
unit specification |
||
| integer, | intent(out) | :: | stat |
status code |
||
| character(len=*), | intent(out) | :: | phys_dim |
physical dimension (e.g. 'mass') |
||
| character(len=*), | intent(out) | :: | unit_name |
unit name (e.g. 'g') |
||
| real(kind=dp), | intent(out) | :: | unit_value |
actual value (e.g. 1.e-3) |