CURL.GetHeaders
---------------

Returns the headers of the transaction as text.

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

MBS( "CURL.GetHeaders"; curl { ; Encoding; preserveLineEndings } ) 

**MBS**( **"CURL.GetHeaders";** /\* Returns the headers of the transaction as text. \*/  
**$curl**; /\* The CURL session handle. \*/   
**$Encoding**; /\* Optional; The text encoding for result.   
Default is native. This function can also handle UTF-16 as well as UTF-16LE and UTF-16BE for little/big endian byte order.e.g. "UTF-8" \*/   
**$preserveLineEndings**) /\* Optional; Whether to change line endings to CR for FileMaker.  
By default (0) we change the line endings to CR, so FileMaker has no trouble.  
Pass 1 to keep whatever line endings are there.e.g. 0 \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| curl | The CURL session handle. | $curl |  |
| Encoding | The text encoding for result.    Default is native. This function can also handle UTF-16 as well as UTF-16LE and UTF-16BE for little/big endian byte order. | "UTF-8" | Optional |
| preserveLineEndings | Whether to change line endings to CR for FileMaker.   By default (0) we change the line endings to CR, so FileMaker has no trouble.   Pass 1 to keep whatever line endings are there. | 0 | Optional |

### Result

The headers as text or error.

### Description

Returns the headers of the transaction as text.  
You are responsible for detecting decoding.   
  
Plugin version 5.2 and newer replace newlines automatically for you to match what FileMaker uses (Mac line endings).  
### Examples

Get header lines:

 MBS ("CURL.GetHeaders”; $curl )  
Get file name for container from header:

 Set Variable \[ $name ; Value: "" \]   
Set Variable \[ $headers ; Value: MBS ( "CURL.GetHeaders”; $curl ; "UTF-8") \]   
Set Variable \[ $headers ; Value: MBS ( "[List.MatchesPrefix](ListMatchesPrefix.md)"; $headers ; "Content-Disposition: attachment; filename=") \]   
If \[ Length($headers ) &gt; 0 \]   
 Set Variable \[ $name ; Value: Middle ( $headers ; 43 ; Length($headers ) ) \]   
End If  
Set Field \[ CURL Test::File ; MBS ("[CURL.GetResultAsContainer](CURLGetResultAsContainer.md)"; $curl ; $name ) \]  
### See also

- [CURL.CreateHeaderOutputFile](CURLCreateHeaderOutputFile.md)
- [CURL.GetHeaderAsText](CURLGetHeaderAsText.md)
- [CURL.GetHeaderSize](CURLGetHeaderSize.md)
- [CURL.GetResultAsContainer](CURLGetResultAsContainer.md)
- [CURL.SetDebugWithTime](CURLSetDebugWithTime.md)
- [CURL.SetOptionCustomRequest](CURLSetOptionCustomRequest.md)
- [List.MatchesPrefix](ListMatchesPrefix.md)
- [SendMail.PrepareCURL](SendMailPrepareCURL.md)

### Release notes

- **Version 13.0**
    - Added [CURL.GetHeaders](https://www.mbsplugins.eu/CURLGetHeaders.shtml) to replace deprecated [CURL.GetHeaderAsText](https://www.mbsplugins.eu/CURLGetHeaderAsText.shtml).

### Example Databases

- [CURL/Amazon S3/Amazon S3 Download Picture](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/CURL/Amazon%20S3/Amazon%20S3%20Download%20Picture.shtml#1ScriptAnchor_)
- [CURL/Amazon S3/Amazon S3 Upload File](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/CURL/Amazon%20S3/Amazon%20S3%20Upload%20File.shtml#9ScriptAnchor_)
- [CURL/CURL Download in Background](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/CURL/CURL%20Download%20in%20Background.shtml#1ScriptAnchor_)
- [CURL/CURL Download on Server](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/CURL/CURL%20Download%20on%20Server.shtml#1ScriptAnchor_)
- [CURL/CURL Download PDF and add preview with DynaPDF](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/CURL/CURL%20Download%20PDF%20and%20add%20preview%20with%20DynaPDF.shtml#1ScriptAnchor_)
- [CURL/CURL Download Picture](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/CURL/CURL%20Download%20Picture.shtml#1ScriptAnchor_)
- [CURL/CURL Download with Progress](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/CURL/CURL%20Download%20with%20Progress.shtml#1ScriptAnchor_)
- [CURL/CURL Send Form](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/CURL/CURL%20Send%20Form.shtml#1ScriptAnchor_)
- [CURL/Email/List IMAP folders](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/CURL/Email/List%20IMAP%20folders.shtml#1ScriptAnchor_)
- [CURL/WebServices/Twitter oAuth](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/CURL/WebServices/Twitter%20oAuth.shtml#5ScriptAnchor_)

### Blog Entries

- [MBS FileMaker Plugin, version 13.0pr6](https://www.mbsplugins.de/archive/2023-01-09/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 3th January 2023 , last changed 3th January 2023

  
[CURL.GetHeaderSize](CURLGetHeaderSize.md) - [CURL.GetInputAsText](CURLGetInputAsText.md)

[HTML Version](CURLGetHeaders.shtml)