imageNamed

imageNamed:

Returns the image object associated with the specified filename.

+ (UIImage *)imageNamed:(NSString *)name

Parameters

name

The name of the file, including its filename extension. If this is the first time the image is being loaded, the method looks for an image with the specified name in the application’s main bundle.

Return Value

The image object for the specified file, or nil if the method could not find the specified image.

Discussion

This method looks in the system caches for an image object with the specified name and returns that object if it exists. If a matching image object is not already in the cache, this method loads the image data from the specified file, caches it, and then returns the resulting object.

Availability

• Available in iPhone OS 2.0 and later.

Related Sample Code

• BubbleLevel
• CrashLanding
• TableViewSuite
• TheElements
• UICatalog

Declared In

UIImage.h