You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
278 lines
8.7 KiB
278 lines
8.7 KiB
15 years ago
|
<!DOCTYPE KSpreadFunctions>
|
||
|
|
<KSpreadFunctions>
|
||
|
|
|
||
|
|
<Group>
|
||
|
|
<GroupName>Conversion</GroupName>
|
||
|
|
|
||
|
|
<Function>
|
||
|
|
<Name>BOOL2STRING</Name>
|
||
|
|
<Type>String</Type>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>Bool value to convert</Comment>
|
||
|
|
<Type range="false">Boolean</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Help>
|
||
|
|
<Text>The BOOL2STRING() function returns a string value for a given boolean value. This method is intended for using a boolean in methods which require a string</Text>
|
||
|
|
<Syntax>BOOL2STRING(value)</Syntax>
|
||
|
|
<Example>BOOL2STRING(true) returns "True"</Example>
|
||
|
|
<Example>BOOL2STRING(false) returns "False"</Example>
|
||
|
|
<Example>upper(BOOL2STRING(find("nan";"banana"))) returns TRUE</Example>
|
||
|
|
</Help>
|
||
|
|
</Function>
|
||
|
|
|
||
|
|
<Function>
|
||
|
|
<Name>INT2BOOL</Name>
|
||
|
|
<Type>Boolean</Type>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>Integer value to convert</Comment>
|
||
|
|
<Type range="false">Int</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Help>
|
||
|
|
<Text>The INT2BOOL() function returns a boolean value for a given integer number. This method is intended for using an integer in methods which require a boolean. It only accepts 0 or 1. If any other value is given, false is returned.</Text>
|
||
|
|
<Syntax>INT2BOOL(value)</Syntax>
|
||
|
|
<Example>INT2BOOL(1) returns true</Example>
|
||
|
|
<Example>INT2BOOL(0) returns false</Example>
|
||
|
|
<Example>OR(INT2BOOL(1); false) returns true</Example>
|
||
|
|
<Related>BOOL2INT</Related>
|
||
|
|
</Help>
|
||
|
|
</Function>
|
||
|
|
|
||
|
|
<Function>
|
||
|
|
<Name>BOOL2INT</Name>
|
||
|
|
<Type>Int</Type>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>Bool value to convert</Comment>
|
||
|
|
<Type range="false">Boolean</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Help>
|
||
|
|
<Text>The BOOL2INT() function returns an integer value for a given boolean value. This method is intended for using a boolean value in methods which require an integer.</Text>
|
||
|
|
<Syntax>BOOL2INT(value)</Syntax>
|
||
|
|
<Example>BOOL2INT(True) returns 1</Example>
|
||
|
|
<Example>BOOL2INT(False) returns 0</Example>
|
||
|
|
<Related>INT2BOOL</Related>
|
||
|
|
</Help>
|
||
|
|
</Function>
|
||
|
|
|
||
|
|
<Function>
|
||
|
|
<Name>NUM2STRING</Name>
|
||
|
|
<Type>String</Type>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>Number to convert into string</Comment>
|
||
|
|
<Type range="false">Float</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Help>
|
||
|
|
<Text>The NUM2STRING() function returns a string value for a given number. Note that KSpread can auto-covert numbers to strings if needed, so this function should rarely be needed.</Text>
|
||
|
|
<Syntax>NUM2STRING(value)</Syntax>
|
||
|
|
<Example>NUM2STRING(10) returns "10"</Example>
|
||
|
|
<Example>NUM2STRING(2.05) returns "2.05"</Example>
|
||
|
|
<Example>=find("101";NUM2STRING(A1)) (A1 = 2.010102) returns True</Example>
|
||
|
|
<Related>STRING</Related>
|
||
|
|
</Help>
|
||
|
|
</Function>
|
||
|
|
|
||
|
|
<Function>
|
||
|
|
<Name>STRING</Name>
|
||
|
|
<Type>String</Type>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>Number to convert into string</Comment>
|
||
|
|
<Type range="false">Float</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Help>
|
||
|
|
<Text>The STRING() function returns a string value for a given number. It is the same as the NUM2STRING function.</Text>
|
||
|
|
<Related>NUM2STRING</Related>
|
||
|
|
</Help>
|
||
|
|
</Function>
|
||
|
|
|
||
|
|
<Function>
|
||
|
|
<Name>CHARTOASCII</Name>
|
||
|
|
<Type>Int</Type>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>A one character string to convert</Comment>
|
||
|
|
<Type>String</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Help>
|
||
|
|
<Text>The CHARTOASCII() function returns the ASCII code for the given character.</Text>
|
||
|
|
<Syntax>CHARTOASCII(value)</Syntax>
|
||
|
|
<Example>CHARTOASCII("v") returns 118</Example>
|
||
|
|
<Example>CHARTOASCII(r) is an error. The character must be in quotes.</Example>
|
||
|
|
</Help>
|
||
|
|
</Function>
|
||
|
|
|
||
|
|
<Function>
|
||
|
|
<Name>ASCIITOCHAR</Name>
|
||
|
|
<Type>String</Type>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>The ASCII values to convert</Comment>
|
||
|
|
<Type>Int</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Help>
|
||
|
|
<Text>The ASCIITOCHAR() function returns the character for each given ASCII code</Text>
|
||
|
|
<Syntax>ASCIITOCHAR(value)</Syntax>
|
||
|
|
<Example>ASCIITOCHAR(118) returns "v"</Example>
|
||
|
|
<Example>ASCIITOCHAR(75; 68; 69) returns "KDE"</Example>
|
||
|
|
</Help>
|
||
|
|
</Function>
|
||
|
|
|
||
|
|
<Function>
|
||
|
|
<Name>POLR</Name>
|
||
|
|
<Type>Double</Type>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>Value in X</Comment>
|
||
|
|
<Type>Double</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>Value in Y</Comment>
|
||
|
|
<Type>Double</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Help>
|
||
|
|
<Text>The POLR() function returns the radius corresponding to the position of a point in a cartesian landmark.</Text>
|
||
|
|
<Syntax>POLR(X;Y)</Syntax>
|
||
|
|
<Example>POLR(12;12) returns 16.9705</Example>
|
||
|
|
<Example>POLR(12;0) returns 12</Example>
|
||
|
|
<Related>POLA</Related>
|
||
|
|
<Related>CARX</Related>
|
||
|
|
<Related>CARY</Related>
|
||
|
|
</Help>
|
||
|
|
</Function>
|
||
|
|
|
||
|
|
<Function>
|
||
|
|
<Name>POLA</Name>
|
||
|
|
<Type>Double</Type>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>Value in X</Comment>
|
||
|
|
<Type>Double</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>Value in Y</Comment>
|
||
|
|
<Type>Double</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Help>
|
||
|
|
<Text>The POLA() function returns the angle (in radians) corresponding to the position of a point in a cartesian landmark.</Text>
|
||
|
|
<Syntax>POLA(X;Y)</Syntax>
|
||
|
|
<Example>POLA(12;12) returns 0.78539816</Example>
|
||
|
|
<Example>POLA(12;0) returns 0</Example>
|
||
|
|
<Example>POLA(0;12) returns 1.5707</Example>
|
||
|
|
<Related>POLR</Related>
|
||
|
|
<Related>CARX</Related>
|
||
|
|
<Related>CARY</Related>
|
||
|
|
</Help>
|
||
|
|
</Function>
|
||
|
|
|
||
|
|
<Function>
|
||
|
|
<Name>CARX</Name>
|
||
|
|
<Type>Double</Type>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>Radius</Comment>
|
||
|
|
<Type>Double</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>Angle (radians)</Comment>
|
||
|
|
<Type>Double</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Help>
|
||
|
|
<Text>The CARX() function returns the X position corresponding to the position of a point in a polar landmark.</Text>
|
||
|
|
<Syntax>CARX(Radius;Angle)</Syntax>
|
||
|
|
<Example>CARX(12;1.5707) returns 0.00115592</Example>
|
||
|
|
<Example>CARX(12;0) returns 12</Example>
|
||
|
|
<Related>CARY</Related>
|
||
|
|
<Related>POLA</Related>
|
||
|
|
<Related>POLR</Related>
|
||
|
|
</Help>
|
||
|
|
</Function>
|
||
|
|
|
||
|
|
<Function>
|
||
|
|
<Name>DECSEX</Name>
|
||
|
|
<Type>Double</Type>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>Value</Comment>
|
||
|
|
<Type>Double</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Help>
|
||
|
|
<Text>The DECSEX() function converts a double value to a time value.</Text>
|
||
|
|
<Syntax>DECSEX(double)</Syntax>
|
||
|
|
<Example>DECSEX(1.6668) returns 1:40 </Example>
|
||
|
|
<Example>DECSEX(7.8) returns 7:47</Example>
|
||
|
|
</Help>
|
||
|
|
</Function>
|
||
|
|
|
||
|
|
<Function>
|
||
|
|
<Name>SEXDEC</Name>
|
||
|
|
<Type>Double</Type>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>Hours</Comment>
|
||
|
|
<Type>Int</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>Minutes</Comment>
|
||
|
|
<Type>Int</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>Seconds</Comment>
|
||
|
|
<Type>Int</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Help>
|
||
|
|
<Text>The SEXDEC() function returns a decimal value. You can also supply a time value.</Text>
|
||
|
|
<Syntax>SEXDEC(time value) or SEXDEC(hours;minutes;seconds)</Syntax>
|
||
|
|
<Example>SEXDEC(1;5;7) returns 1.0852778 </Example>
|
||
|
|
<Example>DECSEX("8:05") returns 8.08333333</Example>
|
||
|
|
</Help>
|
||
|
|
</Function>
|
||
|
|
|
||
|
|
<Function>
|
||
|
|
<Name>CARY</Name>
|
||
|
|
<Type>Double</Type>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>Radius</Comment>
|
||
|
|
<Type>Double</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>Angle (radians)</Comment>
|
||
|
|
<Type>Double</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Help>
|
||
|
|
<Text>The CARY() function returns the Y position corresponding to the position of a point in a polar landmark.</Text>
|
||
|
|
<Syntax>CARY(Radius;Angle)</Syntax>
|
||
|
|
<Example>CARY(12;1.5707) returns 12</Example>
|
||
|
|
<Example>CARY(12;0) returns 0</Example>
|
||
|
|
<Related>CARX</Related>
|
||
|
|
<Related>POLA</Related>
|
||
|
|
<Related>POLR</Related>
|
||
|
|
</Help>
|
||
|
|
</Function>
|
||
|
|
|
||
|
|
<Function>
|
||
|
|
<Name>ROMAN</Name>
|
||
|
|
<Type>String</Type>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>Number</Comment>
|
||
|
|
<Type>Int</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Help>
|
||
|
|
<Text>The ROMAN() function returns the number in roman format. Number should be positive and entire.</Text>
|
||
|
|
<Syntax>ROMAN(Number)</Syntax>
|
||
|
|
<Example>ROMAN(99) returns "XCIX"</Example>
|
||
|
|
<Example>ROMAN(-55) returns "Err"</Example>
|
||
|
|
<Related>ARABIC</Related>
|
||
|
|
</Help>
|
||
|
|
</Function>
|
||
|
|
|
||
|
|
<Function>
|
||
|
|
<Name>ARABIC</Name>
|
||
|
|
<Type>Int</Type>
|
||
|
|
<Parameter>
|
||
|
|
<Comment>Numeral</Comment>
|
||
|
|
<Type>String</Type>
|
||
|
|
</Parameter>
|
||
|
|
<Help>
|
||
|
|
<Text>The ARABIC() function converts a roman numeral into a number.</Text>
|
||
|
|
<Syntax>ARABIC(Numeral)</Syntax>
|
||
|
|
<Example>ARABIC("IV") returns 4</Example>
|
||
|
|
<Example>ARABIC("XCIX") returns 99</Example>
|
||
|
|
<Related>ROMAN</Related>
|
||
|
|
</Help>
|
||
|
|
</Function>
|
||
|
|
|
||
|
|
</Group>
|
||
|
|
|
||
|
|
</KSpreadFunctions>
|