X# Runtime and VO SDK Reference
X# Runtime and SDK Reference
XSharp.RT
Functions 类
Functions 方法
_accept 方法
_ArrayToObjectArray 方法
_ArrayToUsualArray 方法
_Break 方法
_CallClipFunc 方法
_CreateInstance 方法
_GetMRandID 方法
_HasClipFunc 方法
_MClear 方法
_MRelease 方法
_MRestore 方法
_MSave 方法
_MxRelease 方法
_NoAlias 方法
_ObjectArrayToUsualArray 方法
_PrivateCount 方法
_PrivateEnum 方法
_PrivateFirst 方法
_PrivateNext 方法
_PublicCount 方法
_PublicEnum 方法
_PublicFirst 方法
_PublicNext 方法
_RegisterExit 方法
_Select 方法
_SelectString 方法
_SequenceError 方法
_SequenceRecover 方法
_Str 方法
_Str3 方法
_TextRestore 方法
_TextSave 方法
_UsualArrayToObjectArray 方法
_VoDbErrInfoPtr 方法
_wait 方法
AAdd 方法
Abs 方法
AbsFloat 方法
AClone 方法
ACloneShallow 方法
ACopy 方法
ACos 方法
ACot 方法
ADel 方法
ADim 方法
ADimPic 方法
ADir 方法
AEval 方法
AEvalA 方法
AEvalOld 方法
AFields 方法
AFill 方法
AIns 方法
ALen 方法
Alias 方法
Alias0 方法
Alias0Sym 方法
AllowCollectThread 方法
Ansi2OemBuff 方法
AReplicate 方法
Array 方法
ArrayBuild 方法
ArrayCreate 方法
ArrayDeProtect 方法
ArrayGet 方法
ArrayInit 方法
ArrayNew 方法
ArrayProtect 方法
ArrayPut 方法
ArrayStore 方法
ArraySwap 方法
AScan 方法
AScanBin 方法
AScanBinExact 方法
AScanExact 方法
ASend 方法
AsHexString 方法
ASin 方法
ASize 方法
ASort 方法
AsPadr 方法
AsString 方法
AsSymbol 方法
ATail 方法
ATan 方法
Atan2 方法
ATrueDel 方法
Between 方法
Bin2Date 方法
Bin2F 方法
Bin2Logic 方法
BLOBDirectExport 方法
BLOBDirectGet 方法
BLOBDirectImport 方法
BLOBDirectPut 方法
BLOBExport 方法
BLOBGet 方法
BLOBImport 方法
BLOBRootGet 方法
BLOBRootLock 方法
BLOBRootPut 方法
BLOBRootUnlock 方法
Bof 方法
CanBreak 方法
CDoW 方法
Ceil 方法
CheckInstanceOf 方法
ClassCount 方法
ClassList 方法
ClassName 方法
ClassTree 方法
ClassTreeClass 方法
cls 方法
CMonth 方法
Col 方法
Collect 方法
CollectCount 方法
CollectForced 方法
ConcatAtom 方法
ConcatAtom3 方法
ConcatAtom4 方法
ConcatAtom5 方法
ConDate 方法
Cos 方法
Cot 方法
CParamCount 方法
CreateInstance 方法
CSend 方法
CToD 方法
CToDAnsi 方法
Date 方法
Date2Bin 方法
Day 方法
DbApp 方法
DbAppDelim 方法
DbAppend 方法
DbAppSdf 方法
DbAutoLock 方法
DbAutoLockArea 方法
DbAutoUnLock 方法
DbAutoUnLockArea 方法
DbBlobInfo 方法
DbBuffRefresh 方法
DbClearFilter 方法
DbClearIndex 方法
DBClearOrderCondition 方法
DbClearRelation 方法
DbClearScope 方法
DbCloseAll 方法
DbCloseArea 方法
DbCommit 方法
DbCommitAll 方法
DbContinue 方法
DbCopy 方法
DbCopyDelim 方法
DbCopySDF 方法
DbCopyStruct 方法
DbCopyXStruct 方法
DbCreate 方法
DbCreateIndex 方法
DbCreateOrder 方法
DbDelete 方法
DbDeleteOrder 方法
DbDriver 方法
DbEval 方法
DBF 方法
DbFieldInfo 方法
DBFileCopy 方法
DbFilter 方法
DbGetSelect 方法
DbGoBottom 方法
DbGoto 方法
DbGoTop 方法
DbInfo 方法
DbJoin 方法
DbJoinAppend 方法
DbLocate 方法
DbMemoExt 方法
DbMemoField 方法
DbOrderInfo 方法
DbPack 方法
DbRecall 方法
DbRecordInfo 方法
DbReindex 方法
DbRelation 方法
DbRLock 方法
DbRLockList 方法
DbRSelect 方法
DbRUnLock 方法
DbScope 方法
DbSeek 方法
DbSelect 方法
DbSelectArea 方法
DbSetDriver 方法
DbSetFilter 方法
DbSetFound 方法
DbSetIndex 方法
DbSetOrder 方法
DbSetOrderCondition 方法
DbSetRelation 方法
DbSetScope 方法
DbSetSelect 方法
DbSkip 方法
DbSort 方法
DbStruct 方法
DbSymSelect 方法
DbTotal 方法
DbTrans 方法
DbUnLock 方法
DbUnLockAll 方法
DbUpdate 方法
DbUseArea 方法
DbZap 方法
DebOut 方法
Default 方法
Deleted 方法
Descend 方法
DescendA 方法
DirChange 方法
Directory 方法
DirMake 方法
DirRemove 方法
DiskChange 方法
DoError 方法
DoW 方法
DOY 方法
DToC 方法
DToR 方法
DToS 方法
Empty 方法
EmptyField 方法
EmptyPSZ 方法
EmptyRecord 方法
EmptyString 方法
EmptyUsual 方法
EnableArrayIndexCheck 方法
EnableLBOptimizations 方法
EnforceNumeric 方法
EnforceType 方法
Eof 方法
ErrorBlock 方法
ErrorExec 方法
ErrorSys 方法
Eval 方法
Evaluate 方法
ExecScript 方法
ExecScriptFast 方法
ExecScriptSlow 方法
Exp 方法
F2Bin 方法
Fact 方法
FCount 方法
FieldBlock 方法
FieldBlockSym 方法
FieldGet 方法
FieldGetAlias 方法
FieldGetArea 方法
FieldGetBytes 方法
FieldGetSelect 方法
FieldGetSym 方法
FieldName 方法
FieldPos 方法
FieldPosSym 方法
FieldPut 方法
FieldPutAlias 方法
FieldPutArea 方法
FieldPutBytes 方法
FieldPutSelect 方法
FieldPutSym 方法
FieldSym 方法
FieldWBlock 方法
FieldWBlockSym 方法
FindClass 方法
Float2Long 方法
FloatFormat 方法
Flock 方法
Floor 方法
Found 方法
FParamCount 方法
Frac 方法
FRead 方法
FRead3 方法
FRead4 方法
FReadLine 方法
FReadText3 方法
FSeek 方法
FWrite 方法
FWrite3 方法
FWriteLine 方法
FWriteText 方法
GetColor 方法
GetRTFullPath 方法
GetThreadCount 方法
GetTickCountLow 方法
Header 方法
InCollect 方法
IndexCount 方法
IndexExt 方法
IndexHPLock 方法
IndexKey 方法
IndexOrd 方法
InList 方法
InListExact 方法
Integer 方法
IsAccess 方法
IsArray 方法
IsAssign 方法
IsBinary 方法
IsByRef 方法
IsClass 方法
IsClassOf 方法
IsCodeBlock 方法
IsCurrency 方法
IsDate 方法
IsDateTime 方法
IsDecimal 方法
IsFloat 方法
IsFractional 方法
IsInstanceOf 方法
IsInstanceOfUsual 方法
IsInt64 方法
IsInteger 方法
IsLogic 方法
IsLong 方法
IsMethod 方法
IsMethodClass 方法
IsMethodUsual 方法
IsNil 方法
IsNumeric 方法
IsObject 方法
IsPtr 方法
IsString 方法
IsSymbol 方法
IVarGet 方法
IVarGetInfo 方法
IVarGetSelf 方法
IvarList 方法
IvarListClass 方法
IVarPut 方法
IVarPutInfo 方法
IVarPutSelf 方法
JCDOW 方法
JCMONTH 方法
JCYEAR 方法
LastRec 方法
Len 方法
LOG 方法
Log10 方法
LUpdate 方法
MAssign 方法
Max 方法
MaxAtom 方法
MCompile 方法
Mem2String 方法
MemAlloc 方法
MemAtSpecial 方法
MemByte 方法
MemCAlloc 方法
MemChr 方法
MemClear 方法
MemComp 方法
MemCopy 方法
MemCopyString 方法
MemDWord 方法
MemFree 方法
MemGrpAlloc 方法
MemGrpCAlloc 方法
MemGrpClose 方法
MemGrpEnum 方法
MemGrpOpen 方法
MemInt 方法
MemLen 方法
MemLong 方法
MemLower 方法
MemMove 方法
MemoTran 方法
MemRealloc 方法
MemSet 方法
MemShort 方法
MemTotal 方法
MemTrace 方法
MemUpper 方法
MemVarBlock 方法
MemVarBlockSym 方法
MemVarClear 方法
MemVarGet 方法
MemVarGetSym 方法
MemVarPut 方法
MemVarPutSym 方法
MemVarRelease 方法
MemVarTryGet 方法
MemWalk 方法
MemWord 方法
MethodList 方法
MethodListClass 方法
MExec 方法
Min 方法
MLCount 方法
MLcToPos 方法
MLPos 方法
Mod 方法
Month 方法
MParamCount 方法
MPosToLc 方法
NewIndexLock 方法
NewLocks 方法
NoMethod 方法
NTrim 方法
Object2Array 方法
Object2Float 方法
Oem2AnsiBuff 方法
OOPTree 方法
OOPTreeClass 方法
OrdBagExt 方法
OrdBagName 方法
OrdCondSet 方法
OrdCount 方法
OrdCreate 方法
OrdDescend 方法
OrdDestroy 方法
OrdFor 方法
OrdIsUnique 方法
OrdKey 方法
OrdKeyAdd 方法
OrdKeyCount 方法
OrdKeyDel 方法
OrdKeyGoto 方法
OrdKeyNo 方法
OrdKeyVal 方法
OrdList 方法
OrdListAdd 方法
OrdListClear 方法
OrdListRebuild 方法
OrdName 方法
OrdNumber 方法
OrdScope 方法
OrdSetFocus 方法
OrdSetRelation 方法
OrdSkipUnique 方法
Pad 方法
PadC 方法
PadL 方法
PadR 方法
PaletteRGB 方法
Pause 方法
PI 方法
Pow 方法
Psz2String 方法
Psz2Usual 方法
PszAlloc 方法
PszLen 方法
QOut 方法
QQOut 方法
Rand 方法
RddCount 方法
RddInfo 方法
RddList 方法
RddName 方法
RddSetDefault 方法
RddVersion 方法
RecCount 方法
RecNo 方法
RecSize 方法
RegisterAxit 方法
RLock 方法
Round 方法
Row 方法
RToD 方法
Select 方法
Send 方法
Set 方法
SetAlternate 方法
SetAltFile 方法
SetColor 方法
SetConsole 方法
SetFDateTime 方法
SetFloatDelta 方法
SetPos 方法
SetTextFile 方法
SetTextOutPut 方法
SEval 方法
SEvalA 方法
ShowArray 方法
ShowObject 方法
ShowPrivates 方法
ShowPublics 方法
Sin 方法
SplitPath 方法
SQrt 方法
SToD 方法
Str 方法
Str1 方法
Str2 方法
Str3 方法
StrEvaluate 方法
StrFloat 方法
String2Atom 方法
String2Symbol 方法
StringAlloc 方法
StrInt 方法
StrLong 方法
StrToFloat 方法
StrTran 方法
StrZero 方法
SubS 方法
SubStr 方法
Symbol2String 方法
SysAddAtom 方法
SysAddAtomUpperA 方法
SysCompAtom 方法
SysFindAtom 方法
SysGetAtomName 方法
Tan 方法
TimePsz 方法
TimePsz24 方法
Today 方法
Tone 方法
ToWord 方法
Transform 方法
TString 方法
Type 方法
Unformat 方法
UnRegisterAxit 方法
Used 方法
UsualType 方法
UsualVal 方法
Val 方法
ValType 方法
VarGet 方法
VarGetSym 方法
VarPut 方法
VarPutSym 方法
Version 方法
VoDbAlias 方法
VoDbAliasSym 方法
VoDbAppend 方法
VoDbBlobInfo 方法
VoDbBof 方法
VoDbBuffRefresh 方法
VoDbClearFilter 方法
VoDbClearLocate 方法
VoDbClearRelation 方法
VoDbClearScope 方法
VoDbCloseAll 方法
VoDbCloseArea 方法
VoDbCommit 方法
VoDbCommitAll 方法
VoDbContinue 方法
VoDbCreate 方法
VoDbDelete 方法
VoDbDeleted 方法
VoDbEof 方法
VoDbEval 方法
VoDbFieldGet 方法
VoDbFieldGetBytes 方法
VoDbFieldInfo 方法
VoDbFieldPut 方法
VoDbFieldPutBytes 方法
VoDbFileGet 方法
VoDbFilePut 方法
VoDbFilter 方法
VoDbFlock 方法
VoDbFound 方法
VoDbGetScope 方法
VoDbGetSelect 方法
VoDbGoBottom 方法
VoDbGoto 方法
VoDbGoTop 方法
VoDbInfo 方法
VoDbJoinAppend 方法
VoDbLastRec 方法
VoDbLocate 方法
VoDbMemoExt 方法
VoDbOrdBagExt 方法
VoDbOrdCondSet 方法
VoDbOrdCreate 方法
VoDbOrdDestroy 方法
VoDbOrderInfo 方法
VoDbOrdListAdd 方法
VoDbOrdListClear 方法
VoDbOrdListRebuild 方法
VoDbOrdSetFocus 方法
VoDbPack 方法
VoDbRddCount 方法
VoDbRddInfo 方法
VoDbRddList 方法
VoDbRddName 方法
VoDbRddSetDefault 方法
VoDbRecall 方法
VoDbRecno 方法
VoDbRecordGet 方法
VoDbRecordInfo 方法
VoDbRecordPut 方法
VoDbRelation 方法
VoDbRlock 方法
VoDbRSelect 方法
VoDbSeek 方法
VoDbSelect 方法
VoDbSetFilter 方法
VoDbSetFound 方法
VoDbSetLocate 方法
VoDbSetRelation 方法
VoDbSetScope 方法
VoDbSetSelect 方法
VoDbSkip 方法
VoDbSkipScope 方法
VoDbSort 方法
VoDbSymSelect 方法
VoDbTrans 方法
VoDbTransRec 方法
VoDbUnlock 方法
VoDbUnLockAll 方法
VoDbUseArea 方法
VoDbZap 方法
XSharpLoadLibrary 方法
Year 方法
点击或拖拽改变大小

Functions.Str 方法

X#
将数值表达式转换为字符串。

命名空间：  XSharp.RT
程序集：  XSharp.RT (在 XSharp.RT.dll 中) 版本：2.22 GA
语法
复制
 FUNCTION Str(
	nNumber,
	nLength,
	nDecimals
) AS STRING CLIPPER
查看代码

参数

nNumber (Optional)
类型：__Usual
要转换为字符串的数值表达式。
nLength (Optional)
类型：__Usual
要返回的字符串长度，包括小数位、小数点和符号。
值为 -1 表示禁止任何右侧填充。但是，小数位仍然根据 nDecimals 指定的数量返回。
如果未指定 nLength，则由 SetDigit() 和 SetDigitFixed() 决定返回的数字位数。
nDecimals (Optional)
类型：__Usual
返回值中的小数位数。
值为 -1 表示仅返回小数点右侧的有效数字（见下例）。
返回值中的整数位数仍由 nLength 参数决定。
如果未指定 nDecimals，则由 SetDecimal() 和 SetFixed() 决定返回的小数位数。
小数点的表示由 SetDecimalSep() 的当前设置决定。

返回值

类型：String
一个字符串，具有以下例外： 如果 nNumber 是产生数值溢出的表达式，则会产生运行时错误，该错误可以通过当前安装的错误处理程序处理。错误处理程序返回 "+INF" 或 "-INF"，表示最大可能的浮点数。
如果 nLength 小于 nNumber 中的整数位数，则结果将以科学计数法返回。
如果科学计数法的结果不适合，则返回一系列星号。 取整由以下内容决定： 如果 nLength 小于返回字符串的小数部分所需的小数位数，则返回值四舍五入到可用的小数位数。 如果指定了 nLength，但省略了 nDecimals（没有小数位），则返回值四舍五入为整数。 如果未指定 nLength 和 nDecimals，则它们将从 FLOAT 内部浮点格式中获取，或者从 SetDigit() 中获取，如果内部数字位数为 0。
如果 SetFixed() 或 SetDigitFixed() 为 TRUE，则这些值将被 SetDecimal() 或 SetDigit() 的值覆盖。 如果 SetScience() 为 TRUE，则返回值将以科学计数法返回。此外，如果 SetDigit() 指定的数字小于 nNumber 的整数位数，并且 SetDigitFixed() 设置为 TRUE，则结果将以科学计数法返回。但如果科学计数法不适合，则结果是一系列星号。
备注
Str() 通常用于将数字连接到字符串。因此，它对于根据数字创建项的代码（例如，部件编号）以及创建结合数值和字符数据的订单键非常有用。 Str() 类似于 Transform()，它使用掩码而不是长度和小数规格来格式化数字为字符串。 Str() 的逆函数是 Val()，它将格式为字符串的数字转换为数值。
示例
这些示例演示了 Str() 返回值范围，具体取决于指定的参数：
X#
复制
 1nNumber := 123.45
 2? Str(nNumber)                            //      123.45
 3? Str(nNumber, 4)                        // 123.
 4? Str(nNumber, 2)                        // **
 5? Str(nNumber * 10, 7, 2)                    // 1234.50
 6? Str(nNumber * 10, 12, 4)                //    1234.5000
 7? Str(nNumber, 10, 1)                    //      123.5
 8? Str(123.45, -1)                    // 123.45
 9? Str(123.45, -1, 2)                    // 123.45
10? Str(0.45000, 12, -1)                    //      0.45000
通常两个数字显示相同的结果，但它们内部存储的值不同。因此，等式测试将失败（返回 FALSE），除非您对每一侧进行四舍五入。以下是一个示例：
X#
复制
 1? nNum
 2// 显示与下面的 MyFunction() 相同
 3? MyFunction()
 4// 显示与上面的 nNum 相同
 5// 但内部不相等
 6? nNum = MyFunction()                    // FALSE
 7// 在四舍五入后它们相等
 8? Round(nNum, 0) == Round(MyFunction(), 0)    // TRUE
 9// Val(Str()) 也是四舍五入
10? Val(Str(nNum)) = Val(Str(MyFunction()))        // TRUE
将 SetFloatDelta() 设置为比之前更高的值也具有相同效果：
X#
复制
1SetFloatDelta(0.1)
2? nNum == MyFunction()                    // TRUE
当 Decimals 参数 > 0 且 Decimals 参数 > Length-2 时，此函数返回一串星号。 如果数字不适合分配的空间，也会返回一串星号。 示例：
X#
复制
1? Str(9,6,6)    => "******"
2? Str(9,6,5)    => "******"
3? Str(9,6,4)    => "9.0000"
4? Str(9,6,3)    => " 9.000"
5? Str(10,6,6)    => "******"
6? Str(10,6,5)    => "******"
7? Str(10,6,4)    => "******"
8? Str(10,6,3)    => "10.000"
此示例使用 Str() 创建具有复合键的订单，键由订单号和客户名称组成：
X#
复制
1USE customer NEW
2INDEX ON Str(NumOrders, 9) + Custname TO custord
参见