How To Do Amazingly Simple Searches With NSArray & NSPredicate

Matthew Campbell, March 25th

Cocoa-Touch ships with an super-useful class that will help you search through your lists of objects just like they were coming from a database. The class is called NSPredicate which also works with Core Data. This is very powerful stuff, especially what you are working with data intensive applications.

First off, keep in mind that generally we are using NSArray to manage lists of objects in our apps. The objects that NSArray stores for us are made up of properties like name, length and whatever is required for the objects in question. NSPredicate works by defining queries that select objects from an array based on the properties of the objects in the array.

Here are the steps required to search arrays with NSPredicate:

Essentially, these three steps are all it takes to filter an array. Of course, you will need some other pieces in place to do some meaningful work. Next, I will show you a concrete example of using NSPredicate with a custom class.

The first thing I did for this example was to create a custom class called RowOfData that could correspond to an individual row of data in a database.

NOTE: this does not mean that you really use SQL per-say with NSPredicate – the types of queries are more like a regex style. Check this Apple documentation for more details on what types of queries are available to you.

Anyway, here is the class definition for RowOfData:

Each RowOfData object in the array we are about to create represents an individual and details about his or her job and salary.

In effect, we are creating a list of objects that is a bit like a database table. Note here that listOfItems is declared as an NSMutableArray at the top of the file where this code would be located since it needs to stay in scope though-out the lifecycle of objects made from the class:

To summarize, we create an array and then create each object and add each object to the array. Here is what the results would look like if we were to present this array in a table view:


So here is what you have been waiting for. To display a subset of the dataset you would need to code an NSPredicate using a query string. For instance, if we wanted to find out who in our dataset were programmers we could do something like this:

Pretty simple huh? All you need to do is create the NSPredicate with our query and send the filterUsingPredicate message to your array using the NSPredicate object as an argument. If we tack this query to the end of our code and again run an app using a table view it would look like this:


Remember that we can do this because “job” is a property of the objects contain in the array. You can query based on other properties as well. Here are some examples of what you can do:

Find out who makes at least $100,000 per year:

Find everyone who has a name that begins with “T”:

I could throw examples at you all day but ultimately this will be useful when you can apply it the objects you use in your own apps. Check this Apple documentation for a complete list of the functions you can use with NSPredicate.

Another nice touch is that this method may be used with classes other than NSArray. One important use of NSPredicate is with Core Data. You can actually use NSPredicate to query the underlying data store managed by Core Data. This gives you a lot of powerful and efficient data management techniques right out of the box.

Learn How To Make Your Own iPhone and iPad iOS apps!

If you are completely new to iPhone programming and want to start to developing iPhone apps this ebook will give you everything you need to get started today.

You Get the 5 Essential Things You Need to Make iPhone Apps

This ebook is much different than the other books out there: it really is a *system* that includes ONLY what you need to know to make iPhone applications. Not only that, but you will get some real insight on how to make a product and how to set up your code in the best way the first time.

Plus, you will get plenty of bonuses including exclusive source code projects. For more information, head on over to the website for the ebook:

Head over to How To Make An iPhone App eBook Website website to find out how to get Matt’s eBook and the bonus source code.

[...] How To Do Amazingly Simple Searches With NSArray & NSPredicate. Here are the steps required to search arrays with NSPredicate: [...]

Matt, this is a great tip/tutorial. Can you make the source code available in the post as a zip file?

I defined my own class exactly how you did and everything works fine. I then tried to run a for loop after the code above. The for loop has an NSLog so I can see the output on the console. The for loop will not work after your code. If I move the for loop above your code it works fine. Here is what I have:

for (int i; i = 2; i++) {
NSLog(@”in loop 1 ****”);

RowOfData = *row = [[RowOfData allco] init];
row.term = @”test 1″;
row.definition = @”def 1″;
[termsAndDefinitions addObject:row];
for (int x; x = 2; x++) {
NSLog(@”in loop 2 ****”);

[row release];

I made the for loops simple to make sure it wasn’t something I was doing wrong. Any ideas why the for loop before the declaration works and the one after does not?

You must be logged in to post a comment.

  • Hours of videos, demos & screen casts
  • Detailed HANDS-ON Exercises
  • Much Much Much More
  • UIKit
  • Objective-C
  • Core Data
  • More!
  • Learn How To Make An iPhone App right now using my proven system.

    PS: Tons of us are having a blast living off our own code, join us now. Click here to get all the details.