append


Description:

[ Version ( since = "2.24" ) ]
public int append (int fd) throws Error

Adds a file descriptor to this.

The file descriptor is duplicated using dup. You keep your copy of the descriptor and the copy contained in this will be closed when this is finalized.

A possible cause of failure is exceeding the per-process or system-wide file descriptor limit.

The index of the file descriptor in the list is returned. If you use this index with @get then you will receive back a duplicated copy of the same file descriptor.

Parameters:

this

a UnixFDList

fd

a valid open file descriptor

Returns:

the index of the appended fd in case of success, else -1 (and throws is set)