Instance Method

loadAndReturnError:

Loads the bundle’s executable code and returns any errors.

Declaration

- (BOOL)loadAndReturnError:(NSError * _Nullable *)error;

Parameters

error

On input, a pointer to an error object variable. On output, this variable may contain an error object indicating why the bundle’s executable could not be loaded. If no error occurred, this parameter is left unmodified. You may specify nil for this parameter if you are not interested in the error information.

Return Value

YES if the bundle’s executable code was loaded successfully or was already loaded; otherwise, NO if the code could not be loaded.

Discussion

If this method returns NO and you pass a value for the error parameter, a suitable error object is returned in that parameter. Potential errors returned are in the Cocoa error domain and include the types that follow. For a full list of error types, see FoundationErrors.h.

  • NSFileNoSuchFileError - returned if the bundle’s executable file was not located.

  • NSExecutableNotLoadableError - returned if the bundle’s executable file exists but could not be loaded. This error is returned if the executable is not recognized as a loadable executable. It can also be returned if the executable is a PEF/CFM executable but the current process does not support that type of executable.

  • NSExecutableArchitectureMismatchError - returned if the bundle executable does not include code that matches the processor architecture of the current processor.

  • NSExecutableRuntimeMismatchError - returned if the bundle’s required Objective-C runtime information is not compatible with the runtime of the current process.

  • NSExecutableLoadError - returned if the bundle’s executable failed to load for some detectable reason prior to linking. This error might occur if the bundle depends on a framework or library that is missing or if the required framework or library is not compatible with the current architecture or runtime version.

  • NSExecutableLinkError - returned if the executable failed to load due to link errors but is otherwise alright.

The error object may contain additional debugging information in its description that you can use to identify the cause of the error. (This debugging information should not be displayed to the user.) You can obtain the debugging information by invoking the error object’s description method in your code or by using the print-object command on the error object in gdb.

See Also

Loading Code from a Bundle

executableArchitectures

An array of numbers indicating the architecture types supported by the bundle’s executable.

preflightAndReturnError:

Returns a Boolean value indicating whether the bundle’s executable code could be loaded successfully.

load

Dynamically loads the bundle’s executable code into a running program, if the code has not already been loaded.

unload

Unloads the code associated with the receiver.

loaded

The load status of a bundle.

Mach-O Architecture

Constants describing the CPU types that a bundle’s executable code supports.