matlab.io.fits.readKeyLongLong

Read key as 64-bit integer value

Syntax

[value,comment] = matlab.io.fits.readKeyLongLong(fptr,keyname)


Description

[value,comment] = matlab.io.fits.readKeyLongLong(fptr,keyname) returns the specified key value and comment. Specify the keyname argument as a string scalar or character vector. The function returns value as an int64 scalar value and comment as a character vector.

Examples

Read Long Integer Key Value

Read the key value and comment for the keyword NAXIS2 in a sample FITS file.

import matlab.io.*
fptr = fits.openFile("tst0012.fits");
[value,comment] = fits.readKeyLongLong(fptr,"NAXIS2")

value = int64

109

comment = 
'No. of pixels in Y'

fits.closeFile(fptr)

Tips

• This function corresponds to the fits_read_key_lnglng (ffgkyjj) 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.readKeyLongLong 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.