MimeEncodeIfRequired function

function MimeEncodeIfRequired ($str, $force_b64 = false);

Parameters:

str

force_b64 – optional, default: false

Return value:

either the plain string or encoded data as array('cenc' => "B"|"Q"|"", 'data')

Remarks:

checks whether any encoding is needed and which one (quoted-printable/base64) is more efficient in this case and
since quoted_printable_encode is used, this function is NOT BINARY SAFE!
set ($force_b64 = true) to reliably encode binary data here

any multi-line options are enabled in this function

Implementation file: unb_lib/mime.lib.php, line 335