Main Content

binary

Set FTP transfer mode to binary

collapse all in page

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.

example

Examples

collapse all

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: "/"
          CertificateFilename: "default"
            ConnectionTimeout: 5 min
              TransferTimeout: Inf sec

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: "/"
          CertificateFilename: "default"
            ConnectionTimeout: 5 min
              TransferTimeout: Inf sec

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: "/"
          CertificateFilename: "default"
            ConnectionTimeout: 5 min
              TransferTimeout: Inf sec

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

Input Arguments

collapse all

Connection to an FTP server, specified as an FTP object.

Version History

Introduced before R2006a

See Also

|