Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 12.2   12.3   12.4   12.5   13.0   13.1   13.2   13.3   13.4   13.5    Statistic    FMM    Blog  

CURL.SetOptionTransferText

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

Parameters

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

Result

Returns "OK" on success.

Description

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.

Examples

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

💬 Ask a question or report a problem