binary

Set FTP transfer mode to binary

Syntax

binary(ftpobj)

Description

binary(ftpobj) sets the FTP transfer mode for the server associated with ftpobj to binary, which is the default for FTP objects. If you previously called the ascii function, then call binary before transferring a nontext file, such as an executable file or zip archive.

Examples

collapse all

Set Transfer Mode to Binary

Open Live Script

Download a text file from an FTP server, using the ASCII transfer mode. After you download the file, set the transfer mode back to binary.

First, connect to the National Centers for Environmental Information (NCEI) FTP server.

ftpobj = ftp('ftp.ngdc.noaa.gov')

  FTP with properties:

                         Host: "ftp.ngdc.noaa.gov"
                     Username: "anonymous"
                         Port: 21
                 ServerLocale: "en_US"
                 DirParserFcn: @matlab.io.ftp.parseDirListingForUnix
                         Mode: "binary"
    LocalDataConnectionMethod: "passive"
       RemoteWorkingDirectory: "/"

The default transfer mode is binary. When you download a text file, you can use ASCII mode instead so that newline characters are converted correctly.

Set the transfer mode to ASCII. To show the current transfer mode, display the FTP object.

ascii(ftpobj)
ftpobj

  FTP with properties:

                         Host: "ftp.ngdc.noaa.gov"
                     Username: "anonymous"
                         Port: 21
                 ServerLocale: "en_US"
                 DirParserFcn: @matlab.io.ftp.parseDirListingForUnix
                         Mode: "ascii"
    LocalDataConnectionMethod: "passive"
       RemoteWorkingDirectory: "/"

Download a text file.

mget(ftpobj,'README.txt');

Use the ASCII transfer mode only for text files. To download nontext files, such as images or ZIP archives, use the binary transfer mode.

Set the transfer mode back to binary. To check that the mode is now binary, display the FTP object again.

binary(ftpobj)
ftpobj

  FTP with properties:

                         Host: "ftp.ngdc.noaa.gov"
                     Username: "anonymous"
                         Port: 21
                 ServerLocale: "en_US"
                 DirParserFcn: @matlab.io.ftp.parseDirListingForUnix
                         Mode: "binary"
    LocalDataConnectionMethod: "passive"
       RemoteWorkingDirectory: "/"

FTP service courtesy of the National Centers for Environmental Information (NCEI). See the NCEI Privacy Policy, Disclaimer, and Copyright for NCEI terms of service.