set-funcall-async-limit

set-funcall-async-limit Function

Summary

Limit the number of parallel asynchronous calls.

Package

Signature

set-funcall-async-limit new-limit => result

Arguments

new-limit⇩

An integer in the exclusive range (0,100000) or nil.

Values

result⇩

An integer in the exclusive range (0,100000).

Description

The function set-funcall-async-limit limits the number of asynchronous calls (by funcall-async or funcall-async-list) which can run in parallel. Further asynchronous calls are queued, and when a running call finishes another call starts.

When new-limit is an integer the limit is set to new-limit, and result is the previous limit.

When new-limit is nil, the limit is not changed and result is the current limit.

The default limit is 5, which is adequate if funcall-async and/or funcall-async-list are only used occasionally. If you use them often, you may want to increase this limit to between 10 and 30. A larger limit probably does not make sense.