Delphi操作XML:函数详解(二)

4.2.30.sdDateTimeFromStringDefault

　　Unit
NativeXml

　　function
sdDateTimeFromStringDefault(const ADate: UTF8String; ADefault: TDateTime;
UseLocalBias: Boolean): TDateTime;

　　根据W3C日期/时间规范，转换UTF8String类型的ADate为日期时间(TDateTime)类型，可以在http://www.w3.org/TR/NOTE-datetime找到该规范。如果有一个转换错误，返回缺省值ADefault。

4.2.31.sdDateTimeToString

　　Unit
NativeXml

　　function
sdDateTimeToString(ADate: TDateTime; UseLocalBias: Boolean): UTF8String;

　　根据W3C日期/时间规范，转换日期时间(TDateTime)类型的ADate为UTF8String类型，可以在http://www.w3.org/TR/NOTE-datetime找到该规范。

4.2.32.sdRemoveControlChars

　　Unit
NativeXml

　　function
sdRemoveControlChars(const AValue: UTF8String): UTF8String;

　　这个函数从UTF8String类型的AValue中移除控制字符(Tab, CR, LF and Space)。

4.2.33.sdUnicodeToUtf8

　　Unit
NativeXml

　　function
sdUnicodeToUtf8(const W: UnicodeString): UTF8String;

　　转换一个UnicodeString到UTF8编码字符串。

4.2.34.sdUpCase

　　Unit
NativeXml

　　function
sdUpCase(Ch: AnsiChar): AnsiChar;

　　将字符转换为大写('a'..'z'
变为 'A'..'Z')。

4.2.35.sdUTF8EscapeString

　　Unit
NativeXml

　　function
sdUTF8EscapeString(const AValue: UTF8String): UTF8String;

　　将AValue的所有转义字符转换成相应的字符串。

4.2.36.sdUTF8FindString

　　Unit
NativeXml

　　function
sdUTF8FindString(const SubString: UTF8String; const S: UTF8String; Start:
integer; Close: integer; var APos: integer): boolean;

　　在UTF8String格式的S中查找子字符串SubString，仅在Start和Close之间查找字符。如果找到，函数返回True。APos体现找到的第一个位置。

4.2.37.sdUTF8MatchString

　　Unit
NativeXml

　　function
sdUTF8MatchString(const SubString: UTF8String; const S: UTF8String; Start:
integer): boolean;

　　检查UTF8String格式的S中，Start位置是否有子字符串SubString。

4.2.38.sdUTF8ParseAttributes

　　Unit
NativeXml

　　procedure
sdUTF8ParseAttributes(const AValue: UTF8String; Start: integer; Close: integer;
Attributes: TsdUTF8StringList);

　　在UTF8String格式的AValue中查找所有Name =“Value”片段(从Start到Close – 1)，并把所产生的属性写入StringList中。调用这个函数前这StringList必须已初始化。

4.2.39.sdUTF8QuotedString

　　Unit
NativeXml

　　function
sdUTF8QuotedString(const AValue: UTF8String): UTF8String;

　　用引号将字符串AValue括起来。

4.2.40.sdUTF8StringReplace

　　Unit
NativeXml

　　function
sdUTF8StringReplace(const S: UTF8String; const OldPattern: UTF8String; const
NewPattern: UTF8String): UTF8String;

4.2.41.sdUtf8ToAnsi

　　Unit
NativeXml

　　function
sdUtf8ToAnsi(const S: UTF8String): AnsiString;

　　UTF8编码的字符串转换为AnsiString类型。可能会导致损失！

4.2.42 .sdUtf8ToUnicode

　　 Unit NativeXml

　　 function sdUtf8ToUnicode(const
S: UTF8String): UnicodeString;

　　转换一个 UTF8 编码字符串到 UnicodeString 。

4.2.43.sdUTF8Trim

　　 Unit NativeXml

　　 function sdUTF8Trim(const
AValue: UTF8String): UTF8String;

　　修剪 UTF8String 类型字符串 AValue 两端的控制字符 (Tab 、 LF 、 CR 、 Space) 。

4.2.44.sdUTF8TrimPos

　　 Unit NativeXml

　　 function
sdUTF8TrimPos(const AValue: UTF8String; var Start: integer; var Close:
integer): boolean;

　　在 Start 和 Close - 1 之间修剪 UTF8String 字符串 AValue （删除 Start 和 Close – 1 之间空格）。如果结果 UTF8String 仍然有一个长度 > 0 ，函数返回 True 。

4.2.45.sdUTF8UnEscapeString

　　 Unit NativeXml

　　 function
sdUTF8UnEscapeString(const AValue: UTF8String): UTF8String;

　　替换字符串 AValue 中所有转义的原始字符。这些字符包括 &#...; 和 &#x..;

4.2.46.sdUTF8UnQuotedString

　　 Unit NativeXml

　　 function
sdUTF8UnQuotedString(const AValue: UTF8String): UTF8String;

　　从字符串 AValue 中移除引号。

4.2.47.sdUTF8WriteStringToStream

　　 Unit NativeXml

　　 procedure
sdUTF8WriteStringToStream(S: TStream; const AString: UTF8String);

　　写一个 UTF8String 字符串到流 S 。

4.2.48.sdWriteNumber

　　 Unit NativeXml

　　 function
sdWriteNumber(Value: double; SignificantDigits: integer; AllowScientific:
boolean): UTF8String;

　　转换一个数值到一个 UTF8String 字符串，使用 SignificantDigits 来表示有效位数，如果想要更短的结果，设置 AllowScientific 允许使用科学记数法。

4.2.49.XmlAppendToExistingFile

　　 Unit: NativeXmlAppend

　　 procedure
XmlAppendToExistingFile(const AFilename: string; ANode: TXmlNode; ALevel:
integer {$IFDEF D4UP});

　　有了这个程序，我们可以添加一个节点（ TXmlNode ）到现有的 XML 文件。该文件将不会被完整读入，其数据将只是在最后追加。为了做到这一点，该文件是从最终扫描，找到最后的位于 ALevel 层次的节点。 ALevel = 0 将添加在最后的新节点。这是不明智的，因为 XML 不允许多个根节点。选择 ALevel = 1 添加在根目录下（默认）第 1 级的新节点。

　　提示：如果你想开始一个空的（模板） XmlDocument 中，一定要保存它之前设置 TsdXmlDocument.UseFullNodes 为 True 。这将确保在根节点上正确增加。

　　注 1 ：此方法不适用于 Unicode 文件。