| KKmail 邮件组件参考手册 |
| CoreEncoder 对象 |
|
| CoreEncoder 对象是 KKmail
邮件组件核心的编码/解码内置对象，它主要负责对分块的邮件数据进行编码/解码，也可以通过创建 CoreEncoder 对象实例来进行外部数据的编码/解码。 |
|
| 属性列表 |
|
本对象没有属性，只有方法接口。
|
| 方法 |
| 1、BASE64 编码/解码系列 [查看详细] |
- EncodeBase64String
语法: EncodeBase64String pstr2Encode, [plStumpLine]
描述: 对字符串进行 BASE64 编码
返回: 经过 BASE64 编码的文本
参数:
pstr2Encode: 字符串, 固定参数，需要进行编码的原字符串。
plStumpLine: 整数, 可选参数，是否进行自动换行: 0: 否 (默认值); 1:
是。 对于过于长的字符串，可以选择自动换行，自动换行后的 BASE64 文本，不影响解码的结果。
|
- EncodeFileToBase64String
语法: EncodeFileToBase64String strFilePath, [plStumpLine]
描述: 对指定文件进行 BASE64 编码，并返回编码后的文本内容
返回: 经过 BASE64 编码的文本
参数:
strFilePath: 字符串, 固定参数，需要进行编码的文件路径与名称，文件可以是文本文件，也可以是二进制文件。
plStumpLine: 整数, 可选参数，是否进行自动换行: 0: 否 (默认值); 1:
是。 对于过于长的字符串，可以选择自动换行，自动换行后的 BASE64 文本，不影响解码的结果。
|
- EncodeFileToBase64File
语法: EncodeFileToBase64File pstrFileSource, pstrFileBase64, [plStumpLine]
描述: 对指定文件进行 BASE64 编码，并保存为指定的文本文件
返回: (无)
参数:
pstrFileSource: 字符串, 固定参数，需要进行编码的文件路径与名称，文件可以是文本文件，也可以是二进制文件。
pstrFileBase64: 字符串, 固定参数，编码后所保存的目标文件
plStumpLine: 整数, 可选参数，是否进行自动换行: 0: 否 (默认值); 1:
是。 对于过于长的字符串，可以选择自动换行，自动换行后的 BASE64 文本，不影响解码的结果。
实例: Call CoreEncoder.EncodeFileToBase64File("C:\myText.txt",
"C:\myBase64Text.txt", 1)
|
- EncodeBase64Byte
语法: EncodeBase64Byte pbBytes[], [plStumpLine]
描述: 对指定的字节流进行 BASE64 编码，并返回编码后的文本内容
返回: 经过 BASE64 编码的文本
参数:
pbBytes[]: 指针, 固定参数，需要进行编码的字节流指针。
plStumpLine: 整数, 可选参数，是否进行自动换行: 0: 否 (默认值); 1:
是。 对于过于长的字符串，可以选择自动换行，自动换行后的 BASE64 文本，不影响解码的结果。
|
- DecodeBase64String
语法: DecodeBase64String psBase64Str
描述: 将 BASE64 编码
文本还原为原文本内容
返回: 原字符串内容
参数:
psBase64Str: 字符串, 固定参数，需要进行
BASE64 解码的文本内容。
|
- DecodeBase64StringToFile
语法: DecodeBase64StringToFile psBase64Str, strFilePath
描述: 将 BASE64 编码文本还原为原文本内容，并保存到指定文件中。
返回: (无)
参数:
psBase64Str: 字符串, 固定参数，需要进行 BASE64 解码的文本内容。
strFilePath: 字符串, 固定参数，将已经解码的文本内容保存到指定的文件路径与名称。
|
- DecodeBase64FileToFile
语法: DecodeBase64FileToFile psBase64FilePath, strFilePath
描述: 将 BASE64 编码文件还原为原文本内容，并保存到指定文件中。
返回: (无)
参数:
psBase64FilePath: 字符串, 固定参数，需要进行 BASE64 解码的文件路径与名称。
strFilePath: 字符串, 固定参数，将已经解码的文本内容保存到指定的文件路径与名称。
|
- DecodeBase64Byte
语法: DecodeBase64Byte psBase64Str
描述: 将 BASE64 编码文本还原为原文本内容，并返回对应的字节流。
返回: 已经解码的字节流数组
参数:
psBase64Str: 字符串, 固定参数，需要进行 BASE64 解码的文本内容。
实例:
Dim myArr() As Byte
myArr = CoreEncoder.DecodeBase64Byte("suLK1Nb3zOI=")
|
折叠 返回顶部
|
| 2、Quoted-Printable 文本编码/解码系列 [查看详细] |
- EncodeQPString
语法: EncodeQPString psString
描述: 对字符串进行
Quoted-Printable 编码
返回: 经过 Quoted-Printable 编码的文本
参数:
psString: 字符串, 固定参数，需要进行编码的原字符串。
|
- EncodeFileToQPString
语法: EncodeFileToQPString psFilePath
描述: 对指定文件进行 Quoted-Printable 编码，并返回编码后的文本内容
返回: 经过 Quoted-Printable 编码的文本
参数:
psFilePath: 字符串, 固定参数，需要进行编码的文本文件路径与名称。
|
- EncodeFileToQPFile
语法: EncodeFileToQPFile psFilePath, psQPFileDest
描述: 对文本文件进行 Quoted-Printable 编码，并保存为指定的文本文件
返回: (无)
参数:
psFilePath: 字符串, 固定参数，需要进行编码的文本文件路径与名称。
psQPFileDest: 字符串, 固定参数，编码后所保存的目标文件
实例: Call CoreEncoder.EncodeFileToQPFile("C:\myText.txt", "C:\myQPText.txt")
|
- EncodeByteToQPString
语法: EncodeBase64Byte pbBytes[]
描述: 对指定的字节流进行
Quoted-Printable 编码，并返回编码后的文本内容
返回: 经过 Quoted-Printable 编码的文本
参数:
pbBytes[]: 指针, 固定参数，需要进行编码的字节流指针。
|
- DecodeQPString
语法: DecodeQPString psQPString
描述: 将 Quoted-Printable 编码文本还原为原文本内容
返回: 原字符串内容
参数:
psQPString: 字符串, 固定参数，需要进行 Quoted-Printable 解码的文本内容。
|
- DecodeQPStringToFile
语法: DecodeQPStringToFile psQPString, psFileDest
描述: 将 Quoted-Printable 编码文本还原为原文本内容，并保存到指定文件中。
返回: (无)
参数:
psQPString: 字符串, 固定参数，需要进行 Quoted-Printable 解码的文本内容。
psFileDest: 字符串, 固定参数，将已经解码的文本内容保存到指定的文件路径与名称。
|
- DecodeQPFileToFile
语法: DecodeQPFileToFile psQPStrFile, psFileDest
描述: 将 Quoted-Printable 编码文件还原为原文本内容，并保存到指定文件中。
返回: (无)
参数:
psQPStrFile: 字符串, 固定参数，需要进行 Quoted-Printable 解码的文件路径与名称。
psFileDest: 字符串, 固定参数，将已经解码的文本内容保存到指定的文件路径与名称。
|
- DecodeQPStringToByte
语法: DecodeQPStringToByte psQPrintableStr
描述: 将 Quoted-Printable 编码文本还原为原文本内容，并返回对应的字节流。
返回: 已经解码的字节流数组
参数:
psQPrintableStr: 字符串, 固定参数，需要进行 Quoted-Printable 解码的文本内容。
实例:
Dim myArr() As Byte
myArr = CoreEncoder.DecodeQPStringToByte("=D5=E2=CA=C7=D2=BB=B6=CE=B2=E2=CA=D4=CE=C4=B1=BE")
|
折叠 返回顶部
|
| 3、正则表达式系列 [查看详细] |
- RegExpTest
语法: RegExpTest psContent, psPattern, [pIgnoreCase], [pGlobal]
描述: 进行一次正则表达式的匹配测试
返回: True, 匹配上; False, 没有匹配上
参数:
psContent: 字符串, 固定参数, 需要进行匹配测试的内容。
psPattern: 字符串, 固定参数, 正则表达式 Pattern 匹配规则。
pIgnoreCase: 逻辑型, 可选参数, 是否忽略大小写，默认值为 True
pGlobal: 逻辑型, 可选参数, 是否进行全局匹配测试，默认值为
True
|
- RegExpExcute
描述: 执行正则表达式的匹配，并返回匹配结果
返回: MatchCollection 集合对象
参数:
psContent: 字符串, 固定参数, 需要进行匹配测试的内容。
psPattern: 字符串, 固定参数, 正则表达式 Pattern 匹配规则。
pIgnoreCase: 逻辑型, 可选参数, 是否忽略大小写，默认值为 True
pGlobal: 逻辑型, 可选参数, 是否进行全局匹配测试，默认值为
True
实例:
Dim CoreEncoder As Object
Dim fsMatchCollection As Object
Dim fsMatchItem As Object
Dim fsLineString As String
Dim fsPattern As String
fsLineString = "我的电子邮件是: Duclika@hotmail.com 比尔盖茨的，我猜是
bill@microsoft.com"
fsPattern =
"\w+([-+.']\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*"
Set CoreEncoder = CreateObject("KKmail.CoreEncoder")
Set fsMatchCollection =
CoreEncoder.RegExpExcute(fsLineString, fsPattern)
For Each fsMatchItem In fsMatchCollection
Msgbox "邮件地址:" & fsMatchItem.Value
Next
Set fsMatchItem = Nothing
Set fsMatchCollection = Nothing
|
折叠 返回顶部
|
| 4、其他系列 [查看详细] |
- BytesToString
语法: BytesToString pbBytes[], [psCharSet]
描述: 将字节数组转换成字符串内容
返回: 转换后的字符串内容
参数:
pbBytes[]: 指针, 固定参数，需要进行转换的字节流指针。
psCharSet: 字符串, 可选参数，转换的字符集，默认值为 GB2312
|
- StringToBytes
语法: StringToBytes psStrContent, [psCharSet]
描述: 将字符串内容转换成字节流数组
返回: 转换后的字节流数组
参数:
psStrContent: 字符串, 固定参数，需要进行转换的字符串内容。
psCharSet:
字符串, 可选参数，转换的字符集，默认值为 GB2312
|
- HtmlEncode
语法: HtmlEncode psStrContent
描述: 将 HTML
源代码转换为可以在浏览器中显示的内容
返回: 转换后的文本内容
参数:
psStrContent: 字符串, 固定参数，需要进行转换的 HTML 源代码内容。
|
- HtmlDecode
语法: HtmlDecode psStrContent
描述: 将在浏览器中显示的HTML内容，转换成真实的 HTML 代码
返回: 转换后的 HTML 源代码
参数:
psStrContent: 字符串, 固定参数，需要进行转换的文本内容。
|
- HtmlToText
语法: HtmlToText psContent, [pbSetCrLf]
描述: 过滤HTML源代码格式，剩下正文内容。
返回: 过滤后的正文文本内容。
参数:
psContent: 字符串, 固定参数，需要进行转换的 HTML 源代码内容。
pbSetCrLf: 逻辑型, 可选参数，是否将 <br> 转换成真实的换行内容，默认值为 True, 如果是 False
，那么 <br> 会转换成空格。
|
- InternetDateEncode
语法: InternetDateEncode psDateTime
描述: 将常规日期时间格式转换成标准的互联网时间格式。
返回: 互联网格式的日期字符串。
参数:
psDateTime: 字符串, 固定参数，常规日期-时间字符串。
实例: 如本地时间格式: 2009-3-4 18:19:32 转换后的格式为: Wed, 04 Mar 2009
18:19:32 +0800
|
- InternetDateDecode
语法: InternetDateDecode psGMTDate
描述: 将标准的互联网时间格式转换成常规日期时间格式。
返回: 常规日期时间格式字符串。
参数:
psGMTDate: 字符串, 固定参数，标准的互联网时间格式字符串。
实例: 如标准的互联网时间格式: Wed, 04 Mar 2009 18:22:27 +0800 转换后的格式为:
2009-3-4 18:22:27
|
- MD5
语法: MD5 psString, [plLongType]
描述: 将字符串进行 MD5 编码。
返回: 经过编码的 MD5 字符串。
参数:
psString: 字符串, 固定参数，需要进行编码的原字符串。
plLongType: 整数, 可选参数，0 (默认值) 返回16位编码; 1 返回32编码
|
折叠 返回顶部
|
| 参阅 |
| SMTPClient 对象 | POP3Client 对象 | RegAccess 对象 | TaskTimer 对象 | Registration 对象 |
|
|
|