Xbase++

URL-Encode a MIME Body

Demonstrates the Chilkat Mime.UrlEncodeBody method, which replaces the current body with an application/x-www-form-urlencoded-style representation using the named charset. The only argument is the charset; it is a void method.

Background: This transforms the body into the form-encoding used by HTML form submissions — spaces to +, reserved characters to percent-escapes — interpreting the text through the given charset first so non-ASCII characters encode correctly. It is a niche operation for constructing form-style payloads within a MIME part.

Chilkat Xbase++ Downloads

Download Chilkat for Xbase++

Xbase++

LOCAL nSuccess
LOCAL oMime
LOCAL cEncodedBody

nSuccess := 0

//  Demonstrates the Mime.UrlEncodeBody method, which replaces the current body with an
//  application/x-www-form-urlencoded representation using the named charset.  The only argument is
//  the charset.  It is a void method.

oMime := CreateObject("Chilkat.Mime")

nSuccess := oMime:SetBodyFromPlainText("name=John Doe & city=New York")
IF (nSuccess == 0)
    ? oMime:LastErrorText
    oMime:destroy()
    RETURN
ENDIF

//  URL-encode the body: spaces become "+", reserved characters become %-escapes.
oMime:UrlEncodeBody("utf-8")

cEncodedBody := oMime:GetBodyDecoded()
IF (oMime:LastMethodSuccess == 0)
    ? oMime:LastErrorText
    oMime:destroy()
    RETURN
ENDIF

? cEncodedBody

oMime:destroy()