Long Utility

This chapter describes APIs of the utility for Long data processing.

1. pfmLongRoundAt

Rounds off an input value to a given position of decimal places.

  • Prototype

    long pfmLongRoundAt(long inputValue, long pos);
  • Parameters

    Parameter Description

    inputValue (input)

    Input value.

    pos (input)

    Position.

  • Return values

    Returns the result value.

  • Example

    long val = 12345;
    long rtnval;
    
    rtnval = pfmLongRoundAt( val, 3 );
    /* rtnval = 12000 */
    
    rtnval = pfmLongRoundAt( val, 1 );
    /* rtnval = 12350 */

2. pfmLongCeilAt

Rounds up an input value to a given position of decimal places.

  • Prototype

    long pfmLongCeilAt(long inputValue, long pos);
  • Parameters

    Parameter Description

    inputValue (input)

    Input value.

    pos (input)

    Position.

  • Return values

    Returns the result value.

  • Example

    long val = 12345;
    long rtnval;
    
    rtnval = pfmLongCeilAt( val, 3 );
    /* rtnval = 13000 */
    
    rtnval = pfmLongCeilAt ( val, 1 );
    /* rtnval = 12350 */

3. pfmLongFloorAt

Rounds down an input value to a given position of decimal places.

  • Prototype

    long pfmLongFloorAt(long inputValue, long pos);
  • Parameters

    Parameter Description

    inputValue (input)

    Input value.

    pos (input)

    Position.

  • Return values

    Returns the result value.

  • Example

    long val = 12345;
    long rtnval;
    
    rtnval = pfmLongFloorAt( val, 3 );
    /* rtnval = 12000 */
    
    rtnval = pfmLongFloorAt ( val, 1 );
    /* rtnval = 12340 */