Instance Method

initWithMachPort:options:

Initializes a newly allocated NSMachPort object with a given Mach port and the specified options.

Declaration

- (instancetype)initWithMachPort:(uint32_t)machPort options:(NSMachPortOptions)f;

Parameters

machPort

The Mach port for the new port. This parameter should originally be of type mach_port_t.

options

Specifies options for what to do with the underlying port rights when the NSMachPort object is invalidated or destroyed. For a list of constants, see Mach Port Rights.

Return Value

Returns an initialized NSMachPort object that uses machPort to send or receive messages. The returned object might be different than the original receiver

Discussion

Depending on the access rights for machPort, the new port may be able to only send messages. If a port with machPort already exists, this method deallocates the receiver, then retains and returns the existing port.

See Also

Creating and Initializing

+ portWithMachPort:

Creates and returns a port object configured with the given Mach port.

+ portWithMachPort:options:

Creates and returns a port object configured with the specified options and the given Mach port.

- initWithMachPort:

Initializes a newly allocated NSMachPort object with a given Mach port.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software