bind

Namespace: FsToolkit.ErrorHandling

Function Signature

('input -> CancellableTask<'output option>) -> CancellableTask<'input option> -> CancellableTask<'output option>

Examples

Take the following function for example

type Account =
  { EmailAddress : string
    Name : string }

// string -> CancellableTask<Account option>
let lookupAccountByEmail email = cancellableTask {
  let john = { EmailAddress = "[e-mail]"; Name = "John Johnson" }
  let jeff = { EmailAddress = "[e-mail]"; Name = "Jeff Jefferson" }
  let jack = { EmailAddress = "[e-mail]"; Name = "Jack Jackson" }
  
  // Just a map lookup, but imagine we look up an account in our database
  let accounts = Map.ofList [
      ("[e-mail]", john)
      ("[e-mail]", jeff)
      ("[e-mail]", jack)
  ]
  
  return Map.tryFind email accounts
}

Example 1

let taskOpt : CancellableTask<Account option> =
    CancellableTaskOption.some "[e-mail]" // CancellableTask<string option>
    |> CancellableTaskOption.bind lookupAccountByEmail // CancellableTask<Account option>

// cancellableTask { Some { EmailAddress = "[e-mail]"; Name = "John Johnson" } }

Example 2

let taskOpt : CancellableTask<Account option> =
    CancellableTaskOption.some "[e-mail]" // CancellableTask<string option>
    |> CancellableTaskOption.bind lookupAccountByEmail // CancellableTask<Account option>

// cancellableTask { None }

Example 3

let taskOpt : CancellableTask<Account option> =
    CancellableTask.singleton None // CancellableTask<string option>
    |> CancellableTaskOption.bind lookupAccountByEmail // CancellableTask<Account option>

// cancellableTask { None }