sds_cvunit

int sds_cvunit (double oldreal, const char *before, const char *after, double *newreal);


Convert these units to those units.


This function performs a conversion of units. Given a number representing a value in before units (eg.: 3 feet), sds_cvunit converts the number to an equivalent value, expressed in after units (eg.: 36 inches).

The before and after units must be of the same type, such as units of length, or units of time. Sds_cvunit will not, for example, convert furlongs to fortnights.

Commonly used units and conversion factors are stored in the ICAD.UNT file. You may modify this file to include any additional types of units or conversions you need.

The argument oldreal represents the number to be converted, expressed in units defined by the before variable. The argument before represents the units in which the number is originally expressed. after is the units to which the given number will be converted. answer is the converted number, now expressed in units defined by the after variable.

This function returns one of the following: RTNORM or RTERROR

Example

sds_real real1,*answer;

char *before="foot";

char *after="inch";

sds_getreal("\nEnter feet to convert to inches: ",&real1);

sds_cvunit(real1,before,after,&answer);

sds_printf("\n%f feet equals %f inches. ",real1,answer);

Tell me about...

Programming Overview of SDS™ (Solutions Development System™)