Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Whether to use ASCII mode for FTP transfer.

Component Version macOS Windows Linux Server iOS SDK
CURL 2.5 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "CURL.SetOptionTransferText"; curl; Value )   More


Parameter Description Example
curl The CURL session handle. $curl
Value Whether to use ASCII mode. 1


Returns "OK" on success.


Whether to use ASCII mode for FTP transfer.
A parameter set to 1 tells the library to use ASCII mode for FTP transfers, instead of the default binary transfer. For win32 systems it does not set the stdout to binary mode. This option can be usable when transferring text data between systems with different views on certain characters, such as newlines or similar.

libcurl does not do a complete ASCII conversion when doing ASCII transfers over FTP. This is a known limitation/flaw that nobody has rectified. libcurl simply sets the mode to ASCII and performs a standard transfer.

See also TRANSFERTEXT option in CURL manual.


Set transfer mode to binary data:

MBS( "CURL.SetOptionTransferText"; $curl; 0 )

Set transfer mode to text:

MBS( "CURL.SetOptionTransferText"; $curl; 1 )

See also

Blog Entries

Created 18th August 2014, last changed 7th December 2016

CURL.SetOptionTransferEncoding - CURL.SetOptionURL