CURL.GetHeaderAsText
--------------------

Returns the headers of the transaction as text.

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

### Deprecated

This function was [deprecated](deprecated.md). Use [CURL.GetHeaders](CURLGetHeaders.md) instead.

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

**MBS**( **"CURL.GetHeaderAsText";** /\* 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.   Possible encoding names: ANSI, ISO-8859-1, Latin1, Mac, Native, UTF-8, DOS, Hex, Base64 or Windows. More listed in the [FAQ](https://www.monkeybreadsoftware.com/filemaker/faq.shtml). | "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.

### 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).  
  
Function renamed in v23.0 to [CURL.GetHeaders](CURLGetHeaders.md). Old name will stay valid for the foreseeable future.  
### Examples

Get header lines:

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

 Set Variable \[ $name ; Value: "" \]   
Set Variable \[ $headers ; Value: MBS ( "[CURL.GetHeaders](CURLGetHeaders.md)”; $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.GetDebugAsText](CURLGetDebugAsText.md)
- [CURL.GetHeaderAsJSON](CURLGetHeaderAsJSON.md)
- [CURL.GetHeaders](CURLGetHeaders.md)
- [CURL.GetHeaderSize](CURLGetHeaderSize.md)
- [CURL.GetResultAsContainer](CURLGetResultAsContainer.md)
- [CURL.GetResultAsText](CURLGetResultAsText.md)
- [List.MatchesPrefix](ListMatchesPrefix.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).
- **Version 9.3**
    - Added preserveLineEndings parameter for [CURL.GetDebugAsText](http://www.mbsplugins.eu/CURLGetDebugAsText.shtml), [CURL.GetHeaderAsText](http://www.mbsplugins.eu/CURLGetHeaderAsText.shtml), [CURL.GetInputAsText](http://www.mbsplugins.eu/CURLGetInputAsText.shtml) and [CURL.GetResultAsText](http://www.mbsplugins.eu/CURLGetResultAsText.shtml) function.

### Example Databases

- [CURL/CURL Download Text](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/CURL/CURL%20Download%20Text.shtml#4ScriptAnchor_)
- [Third Party/Google OAUTH 2 example](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Third%20Party/Google%20OAUTH%202%20example.shtml#1ScriptAnchor_)

### Blog Entries

- [MBS FileMaker Plugin, version 13.0pr6](https://www.mbsplugins.de/archive/2023-01-09/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)
- [Translating Insert from URL options for CURL to MBS Plugin calls](https://www.mbsplugins.de/archive/2020-12-14/Translating_Insert_from_URL_op/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 9.3pr6](https://www.mbsplugins.de/archive/2019-07-17/MBS_FileMaker_Plugin_version_9/monkeybreadsoftware_blog_filemaker)
- [Comparing Base Elements Plugin to MBS FileMaker Plugin](https://www.mbsplugins.de/archive/2017-10-24/Comparing_Base_Elements_Plugin/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 5.2pr7](https://www.mbsplugins.de/archive/2015-07-16/MBS_FileMaker_Plugin_version_5/monkeybreadsoftware_blog_filemaker)
- [MBS Filemaker Plugin, version 3.2pr3](https://www.mbsplugins.de/archive/2013-03-05/MBS_Filemaker_Plugin_version_3/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 18th August 2014 , last changed 3th January 2023

  
[CURL.GetHeaderAsJSON](CURLGetHeaderAsJSON.md) - [CURL.GetHeaderLength](CURLGetHeaderLength.md)

[HTML Version](CURLGetHeaderAsText.shtml)