Monkeybread Software - MBS FileMaker Plugin: CURL.GetDebugAsText

Topics All Mac OS X (Only) Windows (Only) Linux (Only, Not) iOS (Only, Not)
Components Crossplatform Mac & Win Server Client Old Guides Examples
New in version: 8.5 9.0 9.1 9.2 9.3 9.4 9.5 10.0 10.1 10.2 Statistic

CURL.GetDebugAsText

Returns the debug output of the transaction as text.

Component	Version	macOS	Windows	Server	FileMaker Cloud	FileMaker iOS SDK
CURL	2.5	Yes	Yes	Yes	Yes	Yes

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

Parameters

Parameter Description Example value

curl The CURL session handle. $curl

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.
Possible encoding names: ANSI, Arabic-Mac, Arabic-Win, Baltic-Win, CentralEurope-Mac, ChineseSimp-Mac, ChineseSimp-Win, ChineseTrad-Mac, ChineseTrad-Win, Cyrillic-Mac, Cyrillic-Win, EasternEurope-Win, Greek-Mac, Greek-Win, Hebrew-Mac, Hebrew-Win, ISO-8859-1, ISO-8859-2, ISO-8859-3, ISO-8859-4, ISO-8859-5, ISO-8859-6, ISO-8859-7, ISO-8859-8, ISO-8859-9, ISO-8859-15, Korean-Johab, Korean-Mac, Korean-Win, Latin1, Mac, Native, ShiftJIS-Mac, ShiftJIS-Win, Turkish-Mac, Turkish-Win, UTF-8, DOS or Windows. Pass native to use the native encoding of the current platform. "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. 0

Parameter	Description	Example value
curl	The CURL session handle.	$curl
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. Possible encoding names: ANSI, Arabic-Mac, Arabic-Win, Baltic-Win, CentralEurope-Mac, ChineseSimp-Mac, ChineseSimp-Win, ChineseTrad-Mac, ChineseTrad-Win, Cyrillic-Mac, Cyrillic-Win, EasternEurope-Win, Greek-Mac, Greek-Win, Hebrew-Mac, Hebrew-Win, ISO-8859-1, ISO-8859-2, ISO-8859-3, ISO-8859-4, ISO-8859-5, ISO-8859-6, ISO-8859-7, ISO-8859-8, ISO-8859-9, ISO-8859-15, Korean-Johab, Korean-Mac, Korean-Win, Latin1, Mac, Native, ShiftJIS-Mac, ShiftJIS-Win, Turkish-Mac, Turkish-Win, UTF-8, DOS or Windows. Pass native to use the native encoding of the current platform.	"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.	0

Result

The headers as text.

Description

Returns the debug output of the transaction as text.
You are responsible for detecting decoding.
Use CURL.SetOptionVerbose to enable debug messages.

Plugin version 5.2 and newer replace newlines automatically for you to match what FileMaker uses (Mac line endings).
See CURL.SetDebugWithData, CURL.SetDebugWithProgress and CURL.SetDebugWithTime to include data/time in the debug log.