Changes between Version 5 and Version 6 of FDORfc30

Timestamp:

11/19/08 06:03:44 (16 years ago)

Author:

brentrobinson

Comment:

--

FDORfc30

@@ -143 +143 @@
 where: 
 
-dataType – specifies the destination type. This parameter is only specified for FdoDataValue::Create(). For the other functions, the destination type is determined by the return type. 
-
-src – specifies the source type and value. It is converted to an FdoDataValue of the destination type. 
-
-nullIfIncompatible – determines what happens if the source and destination types are incompatible (e.g. pass FdoDataTimeValue as src to FdoBoolean::Create()): 
-
-true: returns a null FdoDataValue (FdoDataValue::IsNull() = true)
-
-Note that the pointer returned is not null, the FdoDataValue returned has its null flag set
-
-false: throw an exception. 
-
-shift – determines what happens if conversion would cause the value to change. This can happen when converting between numeric types and the destination type does not have enough precision to hold the value as is (e.g convert 1.9 from Double to Int32 ). Applicable only when both source and destination types are one of Byte, Decimal, Double, Int16, Int32, Int64 or Single: 
-
-true: shift the value by rounding it to the precision allowed by the destination type
-false: depends on the value of nullIfIncompatible:
-
-true: return a null FdoDataValue (FdoDataValue::IsNull() = true). Note that the pointer returned is not null, the FdoDataValue returned has its null flag set
-
-false: throw an exception
-
-truncate – determines what happens if the value is outside the valid range for the destination type (e.g. convert 1000000 from FdoInt32Value to FdoInt16Value). Applicable only when both source and destination types are one of Boolean, Byte, Decimal, Double, Int16, Int32, Int64 or Single: 
-
-true: truncate the value to: 
-
-the maximum value for the destination type if the input value is greater than the maximum value
-the minimum value for the destination type if the input value is less than the minimum value
-
-false: depends on the value of nullIfIncompatible:
-
-true: return a null FdoDataValue (FdoDataValue::IsNull() = true). Note that the pointer returned is not null, the FdoDataValue returned has its null flag set
-
-false: throw an exception
-
-When the source type is numeric and the destination type is Boolean, the behaviour differs from the above and is as follows: 
-
-true: convert 0 to false and other values to true
-false: convert 0 to false and 1 to true. Throw an exception for other values
-
-See the chart in the attached document for information on which pairs of types are compatible and which are incompatible. 
-
-Supporting Functions ¶
-The following function will be added: 
-
+ '''dataType''' – specifies the destination type. This parameter is only specified for FdoDataValue::Create(). For the other functions, the destination type is determined by the return type. 
+
+ '''src''' – specifies the source type and value. It is converted to an FdoDataValue of the destination type. 
+
+ '''nullIfIncompatible''' – determines what happens if the source and destination types are incompatible (e.g. pass FdoDateTimeValue as src to FdoBoolean::Create()): 
+
+  ''true'': returns a null FdoDataValue (FdoDataValue::IsNull() = true). Note that the pointer returned is not null, the FdoDataValue returned has its null flag set
+
+  ''false'': throw an exception. 
+
+ '''shift''' – determines what happens if conversion would cause the value to change. This can happen when converting between numeric types and the destination type does not have enough precision to hold the value as is (e.g convert 1.9 from Double to Int32 ). Applicable only when both source and destination types are one of Byte, Decimal, Double, Int16, Int32, Int64 or Single: 
+
+  ''true'': shift the value by rounding it to the precision allowed by the destination type
+
+  ''false'': depends on the value of nullIfIncompatible:
+
+   ''true'': return a null FdoDataValue (FdoDataValue::IsNull() = true). Note that the pointer returned is not null, the FdoDataValue returned has its null flag set
+
+   ''false'': throw an exception
+
+ '''truncate''' – determines what happens if the value is outside the valid range for the destination type (e.g. convert 1000000 from FdoInt32Value to FdoInt16Value). Applicable only when both source and destination types are one of Boolean, Byte, Decimal, Double, Int16, Int32, Int64 or Single: 
+
+  ''true'': truncate the value to: 
+
+   the maximum value for the destination type if the input value is greater than the maximum value
+  
+   the minimum value for the destination type if the input value is less than the minimum value
+
+  ''false'': depends on the value of nullIfIncompatible:
+ 
+   ''true'': return a null FdoDataValue (FdoDataValue::IsNull() = true). Note that the pointer returned is not null, the FdoDataValue returned has its null flag set
+
+   ''false'': throw an exception
+
+ When the source type is numeric and the destination type is Boolean, the behaviour differs from the above and is as follows: 
+
+  ''true'': convert 0 to false and other values to true
+
+  ''false'': convert 0 to false and 1 to true. Throw an exception for other values
+
+ See the chart in the attached document for information on which pairs of types are compatible and which are incompatible. 
+
+=== Supporting Functions ===
+
+The following functions will be added: 
+
+{{{
 FDO_API FdoInt64 FdoStringP::ToInt64()
+}}}
+
 which converts a string to int64 value, and 
 
+{{{
 FDO_API FdoStringP::FdoStringP( FdoInt64 value )
-to convert an int64 to string. These functions hide the Win32 and Linux specific differences in doing these conversions. 
-
-T
+}}}
+
+to convert an int64 to string. These functions hide the Windows and Linux specific differences in doing these conversions. 
 
 == Implications ==