saveAttachment

(Not recommended) Save attachment from MDF file

The saveAttachment function is not recommended and might be removed in a future release. Use mdfSaveAttachment instead. See Version History.

Syntax

saveAttachment(mdfObj,AttachmentName)

saveAttachment(mdfObj,AttachmentName,DestFile)

Description

saveAttachment(mdfObj,AttachmentName) saves the specified attachment from the MDF file to the current MATLAB^® working folder. The attachment is saved with its existing name.

saveAttachment(mdfObj,AttachmentName,DestFile) saves the specified attachment from the MDF file to the given destination. You can specify relative or absolute paths to place the attachment in a specific folder.

Examples

Save Attachment with Original Name

Save an MDF file attachment with its original name in the current folder.

mdfObj = mdf('MDFFile.mf4');
saveAttachment(mdfObj,'AttachmentName.ext')        

Save Attachment with New Name

Save an MDF file attachment with a new name in the current folder.

mdfObj = mdf('MDFFile.mf4');
saveAttachment(mdfObj,'AttachmentName.ext','MyFile.ext')      

Save Attachment in Parent Folder

Save an MDF file attachment in a folder specified with a relative path name, in this case in the parent of the current folder.

mdfObj = mdf('MDFFile.mf4');
saveAttachment(mdfObj,'AttachmentName.ext','..\MyFile.ext')      

Save Attachment in Specified Folder

This example saves an MDF file attachment using an absolute path name.

mdfObj = mdf('MDFFile.mf4');
saveAttachment(mdfObj,'AttachmentName.ext','C:\MyDir\MyFile.ext')

Input Arguments

mdfObj — MDF file

MDF file object

MDF file, specified as an MDF file object.

Example: mdf('MDFFile.mf4')

AttachmentName — MDF file attachment name

char vector | string

MDF file attachment name, specified as a character vector or string. The name of the attachment is available in the Name field of the MDF file object Attachment property.

Example: 'file1.dbc'

Data Types: char | string

DestFile — Destination file name for the saved attachment

existing attachment name (default) | char vector | string

Destination file name for the saved attachment, specified as a character vector or string. The specified destination can include an absolute or relative path, otherwise the attachment is saved in the current folder.

Example: 'MyFile.ext'

Data Types: char | string

Version History

Introduced in R2016b

R2023b: saveAttachment Function Not Recommended

The mdf object and its saveAttachment function are not recommended and might be removed in a future release.

You should update your code to use mdfSaveAttachment and related functions instead.

For more details, see Transition Your mdf Object Code.