Main Content

parfor

Parallel for-loop

Syntax

parfor loopvar = initval:endval; statements; end
parfor (loopvar = initval:endval, M); statements; end

Description

parfor loopvar = initval:endval; statements; end executes a series of MATLAB® statements for values of loopvar between initval and endval, inclusive, which specify a vector of increasing integer values. The loop runs in parallel when you have the Parallel Computing Toolbox™ or when you create a MEX function or standalone code with MATLAB Coder™. Unlike a traditional for-loop, iterations are not executed in a guaranteed order. You cannot call scripts directly in a parfor-loop. However, you can call functions that call scripts.

parfor (loopvar = initval:endval, M); statements; end executes statements in a loop using a maximum of M workers or threads, where M is a nonnegative integer.

Examples

Perform three large eigenvalue computations using three workers or cores with Parallel Computing Toolbox software:

parpool(3)
parfor i=1:3, c(:,i) = eig(rand(1000)); end

Tips

  • If you have Parallel Computing Toolbox software, see the function reference pages for parfor (Parallel Computing Toolbox) and parpool (Parallel Computing Toolbox) for additional information.

  • If you have MATLAB Coder software, see the parfor (MATLAB Coder) function reference page for additional information.

Extended Capabilities

Version History

Introduced in R2008a

See Also