C Utilities - J.P.S.

This is a C header and source file containing constants and functions I find myself copy-and-pasting from previous programs I wrote.

This is intended for baremetal systems, where importing <math.h> may be undesirable.

Functions

int jps_Eng_Not(char returnStr[15], double inputNum, int sigFigs)

This function formats a double number in engineering notation, from yocto- (10^-24) to yotta- (10²⁴).
String is 9 chars long, and is always right-justified so the prefix is always the 9th char.

Inputs:

• returnStr is the pointer to the string to pass the formatted string back to.
• inputNum is the double that is going to be converted to a string in engineering notation.
• sigFigs is the integer number of significant figures the number will be displayed with. Number of significant figures must be between or including 1 to 7.

Returns:

• 0 if a success
• 1 if error
  • "SigFigErr" in returnStr if significant figure not in range.
  • "OutOfRng" in returnStr if value not in range.

int jps_Eng_Power(double inputNum)

This function finds the power of 10 for the engineering notation formatting of doubles.
The purpose of this function is to allow for specific formatting by only returning the exponent and allowing the formatting to be handled by the parent function.

Inputs:

• inputNum is the double that will be used to find the exponent for engineering notation.

Returns:

• integer exponent for engineering notation formatting

double jps_Power(double base, int power)

This function raises a double to an integer power and returns the product as a double.

Inputs:

• base is the type double base of the operation.
• power is the exponent, and can be any whole integer.

Returns:

• The value found by exponentiation (base^power).

double jps_abs(double value)

This function returns the absolute value of a double.

Inputs:

• value_in is the double to find the absolute value of.

Returns:

• the absolute value of value_in; |value_in|

jps_Int_to_Char(int IntToConv)

This function converts an integer between and including 0 and 9 to its ASCII char representation.

Inputs:

• IntToConv is the integer to convert between and including 0 and 9

Returns:

• The ASCII representation of the integer. Returns 'E' if greater than 9 or less than 0.

jps_Char_to_Int(char CharToConv)

This function converts an ASCII char between and including '0' and '9' to its integer equivalent.

Inputs:

• CharToConv is the char to convert

Returns:

• The converted integer value of the char. Returns 0xEEEE if not a number.

Constants

All of these constants are guarded in case they are defined elsewhere.

• TRUE: boolean 1
• FALSE: boolean 0
• PI: 3.1415926535897932384626433832795028841971693993751058209749445923