MATLAB®

pcode - Create preparsed pseudocode file (P-file)

Syntax

pcode fun
pcode *.m
pcode fun1 fun2 ...
pcode... -inplace

Description

pcode fun parses the M-file fun.m into the P-file fun.p and puts it into the current directory. The original M-file can be anywhere on the search path.

If the input file resides within a package and/or class directory, then the same package and class directories are applied to the output file. See example 2, below.

pcode *.m creates P-files for all the M-files in the current directory.

pcode fun1 fun2 ... creates P-files for the listed functions.

pcode... -inplace creates P-files in the same directory as the M-files. An error occurs if the files cannot be created.

Examples

Example 1 – PCoding Multiple Files

Convert selected M-files from the sparfun directory into pcode files:

dir([matlabroot '\toolbox\matlab\sparfun\spr*.m'])

   .   ..   sprand.m   sprandn.m  sprandsym.m  sprank.m

cd C:\work\pcodetest
pcode([matlabroot '\toolbox\matlab\sparfun\spr*.m'])

dir C:\work\pcodetest

.       sprand.m     sprandn.m    sprandsym.m  sprank.m
..      sprand.p     sprandn.p    sprandsym.p  sprank.p

Example 2 – Parsing Files That Belong to a Package and/or Class

This example takes an input file that is part of a package and class, and generates a pcode file for it in a separate directory. M-file test.m resides in the following package and class directory:

C:\work\+mypkg\@char\test.m	

Set your current working directory to empty directory math\pcodetest. This is where you will generate the pcode file. This directory has no package or class structure associated with it at this time:

cd C:\math\pcodetest
dir
   .   ..

Generate pcode for test.m. Because the input file is part of a package and class, MATLAB creates directories +mypkg and @char so that the output file belongs to the same:

pcode C:\work\+mypkg\@char\test.m
dir('C:\math\pcodetest\+mypkg\@char')
    .    ..     test.p

Example 3 – PCoding In Place

When you generate a pcode file inplace, MATLAB writes the output file to the same directory as the input file:

pcode C:\work\+mypkg\@char\test.m -inplace
dir C:\work\+mypkg\@char

.        ..       test.m  test.p

pchip

pcolor