searchBar(_:shouldChangeTextInRanges:replacementText:)

Declaration

optional func searchBar(_ searchBar: UISearchBar, shouldChangeTextInRanges ranges: [NSValue], replacementText: String) -> Bool

Parameters

• searchBar:

  The search bar asking the delegate

• ranges:

  The ranges of the text that should be deleted before replacing

• replacementText:

  The replacement text

Return Value

Returns true if the text at the ranges should be replaced.

Discussion

Asks the delegate if the text at the specified ranges should be replaced with text.

If this method returns YES then the search bar will, at its own discretion, choose any one of the specified ranges of text and replace it with the specified replacementText before deleting the text at the other ranges. If the delegate does not implement this method then the searchBar:shouldChangeTextInRange:replacementText: method will be called and passed the union range instead. If the delegate also does not implement that method then YES is assumed.