CURL.SetOptionAppend
--------------------

Whether to append file instead of overwriting it.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [CURL](component_CURL.md) | [2.5](newinversion25.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "CURL.SetOptionAppend"; curl; Value ) 

**MBS**( **"CURL.SetOptionAppend";** /\* Whether to append file instead of overwriting it. \*/  
**$curl**; /\* The CURL session handle. \*/   
**$Value**) /\* Whether to append.e.g. 1 \*/ 

(old name: CURL.SetOptionFTPAppend)

### Parameters

| Parameter | Description | Example |
|---|---|---|
| curl | The CURL session handle. | $curl |
| Value | Whether to append. | 1 |

### Result

Returns "OK" on success.

### Description

Whether to append file instead of overwriting it.  
A parameter set to 1 tells the library to append to the remote file instead of overwrite it. This is only useful when uploading to an FTP site.  
See also [APPEND](https://curl.haxx.se/libcurl/c/CURLOPT_APPEND.html) option in CURL manual.

### Examples

Turns append on:

 MBS ( "CURL.SetOptionAppend"; $curl ; 1 )  
Turns append off:

 MBS ( "CURL.SetOptionAppend"; $curl ; 0 )  
### See also

- [CURL.SetOptionGet](CURLSetOptionGet.md)
- [CURL.SetOptionUpload](CURLSetOptionUpload.md)

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

  
[CURL.SetOptionAddressScope](CURLSetOptionAddressScope.md) - [CURL.SetOptionAutoReferer](CURLSetOptionAutoReferer.md)

[HTML Version](CURLSetOptionAppend.shtml)