Instance Method

localizedCaseInsensitiveCompare:

Compares the string with a given string using a case-insensitive, localized, comparison.

Declaration

- (NSComparisonResult)localizedCaseInsensitiveCompare:(NSString *)string;

Parameters

aString

The string with which to compare the receiver.

This value must not be nil. If this value is nil, the behavior is undefined and may change in future versions of macOS.

Return Value

Returns an NSComparisonResult value that indicates the lexical ordering. NSOrderedAscending the receiver precedes aString in lexical ordering, NSOrderedSame the receiver and aString are equivalent in lexical value, and NSOrderedDescending if the receiver follows aString.

Discussion

This method uses the current locale.

See Also

Identifying and Comparing Strings

- caseInsensitiveCompare:

Returns the result of invoking compare:options: with NSCaseInsensitiveSearch as the only option.

- compare:

Returns the result of invoking compare:options:range: with no options and the receiver’s full extent as the range.

- localizedCompare:

Compares the string and a given string using a localized comparison.

- compare:options:

Compares the string with the specified string using the given options.

- compare:options:range:

Returns the result of invoking compare:options:range:locale: with a nil locale.

- compare:options:range:locale:

Compares the string using the specified options and returns the lexical ordering for the range.

- localizedStandardCompare:

Compares strings as sorted by the Finder.

- hasPrefix:

Returns a Boolean value that indicates whether a given string matches the beginning characters of the receiver.

- hasSuffix:

Returns a Boolean value that indicates whether a given string matches the ending characters of the receiver.

- isEqualToString:

Returns a Boolean value that indicates whether a given string is equal to the receiver using a literal Unicode-based comparison.

hash

An unsigned integer that can be used as a hash table address.

NSStringCompareOptions

These values represent the options available to many of the string classes’ search and comparison methods.

NSStringEncodingConversionOptions

Options for converting string encodings.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software