NSBundle

NSBundle Mac OS X 10.0

This class represents directories in the filesystem that contain executable binaries, and any resources needed by the executable, such as images, sounds, or nibs. For more information about NSBundle, see Chapter 2.

figs/cocn_1311.gif

@interface NSBundle : NSObject
 // Convenience Constructors
   + (NSBundle *)bundleForClass:(Class)aClass;
   + (NSBundle *)bundleWithIdentifier:(NSString *)identifier;
   + (NSBundle *)bundleWithPath:(NSString *)path;
 // Initializers
   - (id)initWithPath:(NSString *)path;
 // Class Methods
   + (NSArray *)allBundles;
   + (NSArray *)allFrameworks;
   + (BOOL)loadNibFile:(NSString *)fileName externalNameTable:(NSDictionary *)context withZone:(NSZone *)zone;
   + (BOOL)loadNibNamed:(NSString *)nibName owner:(id)owner;
   + (NSBundle *)mainBundle;
   + (NSString *)pathForResource:(NSString *)name ofType:(NSString *)ext inDirectory:(NSString *)path;
   + (NSArray *)pathsForResourcesOfType:(NSString *)ext inDirectory:(NSString *)subpath;
   + (NSArray *)preferredLocalizationsFromArray:(NSArray *)localizationsArray;
   + (NSArray *)preferredLocalizationsFromArray:(NSArray *)localizationsArray           
        forPreferences:(NSArray *)preferencesArray;
 // Instance Methods
   - (NSString *)builtInPlugInsPath;
   - (NSString *)bundleIdentifier;
   - (NSString *)bundlePath;
   - (Class)classNamed:(NSString *)className;
   - (NSAttributedString *)contextHelpForKey:(NSString *)key;
   - (NSString *)developmentLocalization;
   - (NSString *)executablePath;
   - (NSDictionary *)infoDictionary;
   - (BOOL)isLoaded;
   - (BOOL)load;
   - (BOOL)loadNibFile:(NSString *)fileName externalNameTable:(NSDictionary *)context withZone:(NSZone *)zone;
   - (NSArray *)localizations;
   - (NSDictionary *)localizedInfoDictionary;
   - (NSString *)localizedStringForKey:(NSString *)key value:(NSString *)value table:(NSString *)tableName;
   - (id)objectForInfoDictionaryKey:(NSString *)key;
   - (NSString *)pathForAuxiliaryExecutable:(NSString *)executableName;
   - (NSString *)pathForImageResource:(NSString *)name;
   - (NSString *)pathForResource:(NSString *)name ofType:(NSString *)ext;
   - (NSString *)pathForResource:(NSString *)name ofType:(NSString *)ext inDirectory:(NSString *)subpath;
   - (NSString *)pathForResource:(NSString *)name ofType:(NSString *)ext inDirectory:(NSString *)subpath
        forLocalization:(NSString *)localizationName;
   - (NSString *)pathForSoundResource:(NSString *)name;
   - (NSArray *)pathsForResourcesOfType:(NSString *)ext inDirectory:(NSString *)subpath;
   - (NSArray *)pathsForResourcesOfType:(NSString *)ext inDirectory:(NSString *)subpath
        forLocalization:(NSString *)localizationName;
   - (NSArray *)preferredLocalizations;
   - (Class)principalClass;
   - (NSString *)privateFrameworksPath;
   - (NSString *)resourcePath;
   - (NSString *)sharedFrameworksPath;
   - (NSString *)sharedSupportPath;



    Part II: API Quick Reference
    Chapter 13. Foundation Classes