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文件。