bind

Namespace: FsToolkit.ErrorHandling

Function Signature

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

Examples

Take the following function for example

type Account =
  { EmailAddress : string
    Name : string }

// string -> Task<Account option>
let lookupAccountByEmail email = task {
  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 : Task<Account option> =
    TaskOption.some "[e-mail]" // Task<string option>
    |> TaskOption.bind lookupAccountByEmail // Task<Account option>

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

Example 2

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

// task { None }

Example 3

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

// task { None }