matlab.io.fits.getNumCols

Get number of columns in table

Syntax

ncols = matlab.io.fits.getNumCols(fptr)


Description

ncols = matlab.io.fits.getNumCols(fptr) returns the number of columns in the current FITS table.

Examples

Get Number of Columns in Table

Open a sample FITS file that has a table in the second HDU. Get the number of columns in the table. Then close the file.

import matlab.io.*
fptr = fits.openFile("tst0012.fits");
fits.movAbsHDU(fptr,2);
ncols = fits.getNumCols(fptr)

ncols = 
13

fits.closeFile(fptr)

Tips

• This function corresponds to the fits_get_num_cols (ffgncl) function in the CFITSIO library C API.

• To use this function, you must be familiar with the CFITSIO C interface. You can access the CFITSIO documentation at the CFITSIO website.

Extended Capabilities

Thread-Based Environment

Run code in the background using MATLAB® backgroundPool or accelerate code with Parallel Computing Toolbox™ ThreadPool. (since R2026a)

The matlab.io.fits.getNumCols function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.

Version History

R2026a: Use function in thread-based environments

You can use this function in thread-based environments.