accumneg

Subtract two fi objects or values

Syntax

c = accumneg(a,b)

c = accumneg(a,b,RoundingMethod)

c = accumneg(a,b,RoundingMethod,OverflowAction)

Description

c = accumneg(a,b) subtracts b from a using the data type of a. b is cast into the data type of a. If a is a fi object, the default 'Floor' rounding method and default 'Wrap' overflow action are used. The fimath properties of a and b are ignored.

c = accumneg(a,b,RoundingMethod) subtracts b from a using the rounding method specified by RoundingMethod if a is a fi object.

c = accumneg(a,b,RoundingMethod,OverflowAction) subtracts b from a using the rounding method specified by RoundingMethod and the overflow action specified by OverflowAction if a is a fi object.

Examples

Subtract Two fi Objects or Values

This example shows how to subtract two fi numbers using accumneg.

Subtract Two fi Numbers

Subtract b from a, where a and b are both fi numbers, using the default rounding method of 'Floor' and overflow action of 'Wrap'.

a = fi(pi,1,16,13);
b = fi(1.5,1,16,14);
subtr_default = accumneg(a,b)

subtr_default = 
    1.6416

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 13

Subtract Two fi Numbers Using Specified Rounding and Overflow Action

Subtract b from a, where a and b are both fi numbers, using specified rounding method of 'Nearest' and overflow action of 'Saturate'.

a = fi(pi,1,16,13);
b = fi(1.5,1,16,14);
subtr_custom = accumneg(a,b,'Nearest','Saturate')

subtr_custom = 
    1.6416

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 13

Input Arguments

a — Number to subtract from

fi object (default) | double | single | logical | integer

Number from which to subtract. The data type of a is used to compute the output data type.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | fi

b — Number to subtract

fi object (default) | double | single | logical | integer

Number to subtract.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | fi

RoundingMethod — Rounding method to use

'Floor' (default) | 'Ceiling' | 'Convergent' | 'Nearest' | 'Round' | 'Zero'

Rounding method to use if a is a fi object.

Example: c = accumneg(a,b,'Ceiling')

Data Types: string

OverflowAction — Overflow action to take

'Wrap' (default) | 'Saturate'

Overflow action to take if a is a fi object.

Example: c = accumneg(a,b,'Ceiling','Saturate')

Data Types: string

Output Arguments

c — Difference of inputs

fi object | double | single | logical | integer

Result of subtracting input b from input a.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

GPU Code Generation
Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.

Version History

Introduced in R2012a