Tcl

Get a Related Item as Text with CRLF Line Endings

Demonstrates the Chilkat Email.GetRelatedStringCrLf method, which returns the text of a related item with CRLF (\r\n) line-endings, interpreting the item's bytes using the supplied charset. It is intended for text-based related items such as style sheets. This example reads an embedded CSS style sheet with normalized CRLF line endings.

Background: Embedded text may arrive with any style of line ending — bare LF, bare CR, or CRLF. This method normalizes them all to CRLF, which is what internet protocols and many Windows tools expect, avoiding mixed-newline problems when the text is written out or re-transmitted. It is the CRLF counterpart to GetRelatedString (which uses bare CR).

Chilkat Tcl Downloads

Download Chilkat for Tcl

Tcl


load ./chilkat.dll

#  Demonstrates the GetRelatedStringCrLf method, which returns the text of a related item
#  with CRLF line-endings, interpreting the bytes using the specified charset.  This is
#  intended for text-based related items such as style sheets.  The index is zero-based.

set email [new_CkEmail]

CkEmail_put_Subject $email "GetRelatedStringCrLf example"

#  The HTML references a related style sheet by name (Content-Location).
CkEmail_SetHtmlBody $email "<html><head><link rel=\"stylesheet\" href=\"styles.css\"/></head><body>Styled.</body></html>"

#  Add the related style sheet (index 0).
CkEmail_AddRelatedString2 $email "styles.css" "body { color: navy; }\nh1 { color: teal; }" "utf-8"

#  Get the first related item (index 0) as text with CRLF line endings.
set content [CkEmail_getRelatedStringCrLf $email 0 "utf-8"]
puts "Related item 0 text (CRLF-normalized):"
puts "$content"

delete_CkEmail $email