Platforms to show: All Mac Windows Linux Cross-Platform

CFErrorMBS class

Super class: CFObjectMBS

Type Topic Plugin Version macOS Windows Linux Console & Web iOS
class CoreFoundation MBS MacCF Plugin 10.5 Yes No No Yes, macOS only No
Function: The Core Foundation error class.
A CFError object encapsulates rich and extensible error information than is possible using only an error code or error string. The core attributes of a CFError object are an error domain (represented by a string), a domain-specific error code and a user info dictionary containing application specific information. Errors are required to have a domain and an error code within that domain. The optional "userInfo" dictionary may provide additional information that might be useful for the interpretation and reporting of the error. This dictionary can even contain an "underlying" error, which is wrapped as an error bubbles up through various layers.

Several well-known domains are defined corresponding to Mach, POSIX, and OSStatus errors. In addition, CFError allows you to attach an arbitrary user info dictionary to an error object, and provides the means to return a human-readable description for the error.

In general, a method should signal an error condition by—for example—returning false or nil rather than by the simple presence of an error object. The method can then optionally return an CFError object by reference, in order to further describe the error.

CFError is toll-free bridged to NSError in the Foundation framework—for more details on toll-free bridging, see Interchangeable Data Types. NSError has some additional guidelines which makes it easy to automatically report errors to users and even try to recover from them. See Error Handling Programming Guide for more information on NSError programming guidelines.

Requires Mac OS X 10.5 or newer.
Subclass of the CFObjectMBS class.
This is an abstract class. You can't create an instance, but you can get one from various plugin functions.

Feedback, Comments & Corrections

Super class CFObjectMBS

This class has no sub classes.

Some methods using this class:

Some events for this class:

Some examples which use this class:

Blog Entries

The items on this page are in the following plugins: MBS MacCF Plugin.

CFDictionaryMBS   -   CFGregorianDateMBS

The biggest plugin in space...

MBS FileMaker Plugins