<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: -",
    "macOS: 10.15.0 -",
    "tvOS: 13.0.0 -",
    "visionOS: -",
    "watchOS: 6.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Accelerate",
  "identifier" : "/documentation/Accelerate/vDSP/subtract(multiplication:_:result:)-6b91s",
  "metadataVersion" : "0.1.0",
  "role" : "Type Method",
  "symbol" : {
    "kind" : "Type Method",
    "modules" : [
      "Accelerate"
    ],
    "preciseIdentifier" : "s:10Accelerate4vDSPO8subtract14multiplication_6resultyq_1a_q0_1bt_xq1_ztAA0A6BufferRzAaIR_AaIR0_AA0a7MutableF0R1_Sf7ElementRtzSfAKRt_SfAKRt0_SfAKRt1_r2_lFZ"
  },
  "title" : "subtract(multiplication:_:result:)"
}
-->

# subtract(multiplication:_:result:)

Calculates the single-precision element-wise difference of a vector and the product of two vectors.

```
static func subtract<S, T, U, V>(multiplication: (a: T, b: U), _ vector: S, result: inout V) where S : AccelerateBuffer, T : AccelerateBuffer, U : AccelerateBuffer, V : AccelerateMutableBuffer, S.Element == Float, T.Element == Float, U.Element == Float, V.Element == Float
```

## Parameters

`multiplication`

A tuple that contains the vectors `A` and `B` in `D = (A * B) - C`.

`vector`

The input vector `C` in `D = (A * B) - C`.

`result`

The output vector `D` in `D = (A * B) - C`.

## Discussion

This function calculates the products of the first `N` elements of `A` and `B`, subtracts each product from the corresponding value in `C`, and writes the result to `D`.

```swift
 for (n = 0; n < N; ++n)
    D[n] = (A[n] * B[n]) - C[n];
```

![A diagram showing the operation of this function. There are four rows. The top row represents the input vectors, A and B, with three boxes of each. The second row represents the operation that multiplies A and B, as well as the input vector C, with three boxes of each. The third row represents the subtraction operation as three boxes.  The bottom row represents the output vector D as three boxes. The diagram has connecting lines from the input vectors to the operations, and from the operations to the output vectors.  ](images/com.apple.accelerate/media-4336999@2x.png)

The following code shows an example of using this function:

```swift
    let count = 5
    
    let a: [Float] = [ 1,  2,  3,  4,  5]
    let b: [Float] = [10, 20, 30, 40, 50]
    let c: [Float] = [ 5,  4,  3,  2,  1]
    
    let d = [Float](unsafeUninitializedCapacity: count) {
        buffer, initializedCount in
        
        vDSP.subtract(multiplication: (a, b), 
                      c,
                      result: &buffer)
        
        initializedCount = count
    }
    
    // Prints "[5.0, 36.0, 87.0, 158.0, 249.0]".
    print(d)
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)