Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "EDT:EGL Language Primitive Type Conversions"

(Key)
 
(6 intermediate revisions by 3 users not shown)
Line 14: Line 14:
 
| bgcolor="#cccccc" | bigint<br>  
 
| bgcolor="#cccccc" | bigint<br>  
 
| bgcolor="#cccccc" | boolean<br>  
 
| bgcolor="#cccccc" | boolean<br>  
| bgcolor="#ffff00" | bytes<br>  
+
| bgcolor="#cccccc" | bytes<br>  
 
| bgcolor="#cccccc" | date<br>  
 
| bgcolor="#cccccc" | date<br>  
 
| bgcolor="#cccccc" | decimal<br>  
 
| bgcolor="#cccccc" | decimal<br>  
Line 23: Line 23:
 
| bgcolor="#cccccc" | smallint<br>  
 
| bgcolor="#cccccc" | smallint<br>  
 
| bgcolor="#cccccc" | string<br>  
 
| bgcolor="#cccccc" | string<br>  
 +
| bgcolor="#cccccc" | time
 
| bgcolor="#cccccc" | timestamp<br>
 
| bgcolor="#cccccc" | timestamp<br>
 
|-
 
|-
Line 28: Line 29:
 
| align="center" | a<br>  
 
| align="center" | a<br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
| bgcolor="ffff00" align="center" | g<br>  
+
| align="center" | g<br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
 
| align="center" | f<br>  
 
| align="center" | f<br>  
Line 37: Line 38:
 
| align="center" | f<br>  
 
| align="center" | f<br>  
 
| align="center" | d<br>  
 
| align="center" | d<br>  
 +
| align="center" | <br>
 
| align="center" | <br>
 
| align="center" | <br>
 
|-
 
|-
Line 42: Line 44:
 
| align="center" | <br>  
 
| align="center" | <br>  
 
| align="center" | a<br>  
 
| align="center" | a<br>  
| bgcolor="ffff00" align="center" | <br>  
+
| align="center" | <br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
Line 51: Line 53:
 
| align="center" | <br>  
 
| align="center" | <br>  
 
| align="center" | b<br>  
 
| align="center" | b<br>  
 +
| align="center" | <br>
 
| align="center" | <br>
 
| align="center" | <br>
 
|-
 
|-
| bgcolor="#ffff00" | bytes<br>  
+
| bgcolor="#cccccc" | bytes<br>  
| bgcolor="ffff00" align="center" | h<br>  
+
| align="center" | h<br>  
| bgcolor="ffff00" align="center" | <br>  
+
| align="center" | <br>  
| bgcolor="ffff00" align="center" | j<br>  
+
| align="center" | j<br>  
| bgcolor="ffff00" align="center" | <br>  
+
| align="center" | <br>  
| bgcolor="ffff00" align="center" | i<br>  
+
| align="center" | i<br>  
| bgcolor="ffff00" align="center" | h<br>  
+
| align="center" | h<br>  
| bgcolor="ffff00" align="center" | h<br>  
+
| align="center" | h<br>  
| bgcolor="ffff00" align="center" | <br>  
+
| align="center" | <br>  
| bgcolor="ffff00" align="center" | h<br>  
+
| align="center" | h<br>  
| bgcolor="ffff00" align="center" | h<br>  
+
| align="center" | h<br>  
| bgcolor="ffff00" align="center" | <br>  
+
| align="center" | e<br>
| bgcolor="ffff00" align="center" | <br>
+
| align="center" | <br>
 +
| align="center" | <br>
 
|-
 
|-
 
| bgcolor="#cccccc" | date<br>  
 
| bgcolor="#cccccc" | date<br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
| bgcolor="ffff00" align="center" | <br>  
+
| align="center" | <br>  
 
| align="center" | a<br>  
 
| align="center" | a<br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
Line 79: Line 83:
 
| align="center" | <br>  
 
| align="center" | <br>  
 
| align="center" | k<br>  
 
| align="center" | k<br>  
 +
| align="center" | <br>
 
| align="center" | l<br>
 
| align="center" | l<br>
 
|-
 
|-
Line 84: Line 89:
 
| align="center" | f<br>  
 
| align="center" | f<br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
| bgcolor="ffff00" align="center" | g<br>  
+
| align="center" | g<br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
 
| align="center" | j<br>  
 
| align="center" | j<br>  
Line 93: Line 98:
 
| align="center" | f<br>  
 
| align="center" | f<br>  
 
| align="center" | d<br>  
 
| align="center" | d<br>  
 +
| align="center" | <br>
 
| align="center" | <br>
 
| align="center" | <br>
 
|-
 
|-
Line 98: Line 104:
 
| align="center" | f<br>  
 
| align="center" | f<br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
| bgcolor="ffff00" align="center" | g<br>  
+
| align="center" | g<br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
 
| align="center" | f<br>  
 
| align="center" | f<br>  
Line 107: Line 113:
 
| align="center" | f<br>  
 
| align="center" | f<br>  
 
| align="center" | d<br>  
 
| align="center" | d<br>  
 +
| align="center" | <br>
 
| align="center" | <br>
 
| align="center" | <br>
 
|-
 
|-
Line 112: Line 119:
 
| align="center" | f<br>  
 
| align="center" | f<br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
| bgcolor="ffff00" align="center" | g<br>  
+
| align="center" | g<br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
 
| align="center" | f<br>  
 
| align="center" | f<br>  
Line 121: Line 128:
 
| align="center" | f<br>  
 
| align="center" | f<br>  
 
| align="center" | d<br>  
 
| align="center" | d<br>  
 +
| align="center" | <br>
 
| align="center" | <br>
 
| align="center" | <br>
 
|-
 
|-
Line 126: Line 134:
 
| align="center" | f<br>  
 
| align="center" | f<br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
| bgcolor="ffff00" align="center" | g<br>  
+
| align="center" | g<br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
 
| align="center" | f<br>  
 
| align="center" | f<br>  
Line 135: Line 143:
 
| align="center" | f<br>  
 
| align="center" | f<br>  
 
| align="center" | d<br>  
 
| align="center" | d<br>  
 +
| align="center" | <br>
 
| align="center" | <br>
 
| align="center" | <br>
 
|-
 
|-
Line 140: Line 149:
 
| align="center" | f<br>  
 
| align="center" | f<br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
| bgcolor="ffff00" align="center" | g<br>  
+
| align="center" | g<br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
 
| align="center" | f<br>  
 
| align="center" | f<br>  
Line 149: Line 158:
 
| align="center" | f<br>  
 
| align="center" | f<br>  
 
| align="center" | d<br>  
 
| align="center" | d<br>  
 +
| align="center" | <br>
 
| align="center" | <br>
 
| align="center" | <br>
 
|-
 
|-
Line 154: Line 164:
 
| align="center" | f<br>  
 
| align="center" | f<br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
| bgcolor="ffff00" align="center" | g<br>  
+
| align="center" | g<br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
 
| align="center" | f<br>  
 
| align="center" | f<br>  
Line 163: Line 173:
 
| align="center" | a<br>  
 
| align="center" | a<br>  
 
| align="center" | d<br>  
 
| align="center" | d<br>  
 +
| align="center" | <br>
 
| align="center" | <br>
 
| align="center" | <br>
 
|-
 
|-
Line 168: Line 179:
 
| align="center" | d<br>  
 
| align="center" | d<br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
| bgcolor="ffff00" align="center" | e<br>  
+
| align="center" | e<br>  
 
| align="center" | k<br>  
 
| align="center" | k<br>  
 
| align="center" | d<br>  
 
| align="center" | d<br>  
Line 177: Line 188:
 
| align="center" | d<br>  
 
| align="center" | d<br>  
 
| align="center" | a<br>  
 
| align="center" | a<br>  
 +
| align="center" | m
 
| align="center" | c<br>
 
| align="center" | c<br>
 +
|-
 +
| bgcolor="#cccccc" | time
 +
| align="center" | <br>
 +
| align="center" | <br>
 +
| align="center" | <br>
 +
| align="center" | <br>
 +
| align="center" | <br>
 +
| align="center" | <br>
 +
| align="center" | <br>
 +
| align="center" | <br>
 +
| align="center" | <br>
 +
| align="center" | <br>
 +
| align="center" | m
 +
| align="center" | a
 +
| align="center" | l
 
|-
 
|-
 
| bgcolor="#cccccc" | timestamp<br>  
 
| bgcolor="#cccccc" | timestamp<br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
| bgcolor="ffff00" align="center" | <br>  
+
| align="center" | <br>  
 
| align="center" | l<br>  
 
| align="center" | l<br>  
 
| align="center" | <br>  
 
| align="center" | <br>  
Line 191: Line 218:
 
| align="center" | <br>  
 
| align="center" | <br>  
 
| align="center" | c<br>  
 
| align="center" | c<br>  
 +
| align="center" | l
 
| align="center" | j<br>
 
| align="center" | j<br>
 
|}
 
|}
Line 206: Line 234:
 
d = <span style="background: none repeat scroll 0% 0% rgb(255, 165, 0);">Strings convert to/from numbers using our literal syntax for numbers.&nbsp; The conversions are not controlled by variables like RBD's defaultNumericFormat.&nbsp; Functions will be provided which convert to/from strings and numbers with a format string supplied by the program.</span>  
 
d = <span style="background: none repeat scroll 0% 0% rgb(255, 165, 0);">Strings convert to/from numbers using our literal syntax for numbers.&nbsp; The conversions are not controlled by variables like RBD's defaultNumericFormat.&nbsp; Functions will be provided which convert to/from strings and numbers with a format string supplied by the program.</span>  
  
e = Strings convert to bytes using the bit pattern of the Unicode characters in the string.  
+
e = Strings and bytes are not compatible types, however there are functions defined on EString to allow conversion between them. Instance functions are provided for myString.toBytes(); no argument means use the default encoding, and a string argument specifies the encoding to use. There are also static EString.fromBytes(bytes) functions; one argument means use the default encoding, and a string argument specifies the encoding to use. To programmatically find the default encoding, use EString.getDefaultEncoding().<br>
  
 
f = All numeric types are compatible with each other, but some conversions can result in overflow or truncation.  
 
f = All numeric types are compatible with each other, but some conversions can result in overflow or truncation.  
Line 220: Line 248:
 
k = <span style="background: none repeat scroll 0% 0% rgb(255, 165, 0);">Strings convert to/from dates using a predefined format for dates (to be defined later). The conversions are not controlled by variables like RBD's defaultDateFormat. Functions will be provided which convert to/from strings and dates with a format string supplied by the program.</span><br>  
 
k = <span style="background: none repeat scroll 0% 0% rgb(255, 165, 0);">Strings convert to/from dates using a predefined format for dates (to be defined later). The conversions are not controlled by variables like RBD's defaultDateFormat. Functions will be provided which convert to/from strings and dates with a format string supplied by the program.</span><br>  
  
l = Conversions between dates and timestamps work as they do in RBD.<br>  
+
l = Conversions between dates/times and timestamps work as they do in RBD.<br>  
  
 +
m = <span style="background: none repeat scroll 0% 0% rgb(255, 165, 0);">Strings convert to/from times using a predefined format of "HH:mm:ss". The conversions are not controlled by variables like RBD's defaultTimeFormat.</span>
  
 +
<br>
  
 
{| cellspacing="1" cellpadding="1" border="1" style="width: 461px; height: 587px;"
 
{| cellspacing="1" cellpadding="1" border="1" style="width: 461px; height: 587px;"
Line 232: Line 262:
 
|-
 
|-
 
| bgcolor="#cccccc" | ''Any to everything''  
 
| bgcolor="#cccccc" | ''Any to everything''  
| <br>2d - entire table (to verify validation lets all the valid conversions through and catches invalid)  
+
| <br>2d - entire table (to verify validation lets all the valid conversions through and catches invalid) <br> {{bug|354161}}
 
| 1d<br>  
 
| 1d<br>  
| 1d {{bug|353673}}<br>
+
| done {{bug|353673}}<br>
 
|-
 
|-
 
| bgcolor="#cccccc" | ''Everything to any''  
 
| bgcolor="#cccccc" | ''Everything to any''  
 
| <br>--  
 
| <br>--  
 
| 1d<br>  
 
| 1d<br>  
| 1d {{bug|353674}}<br>
+
| done {{bug|353674}}<br>
 
|-
 
|-
 
| bgcolor="#cccccc" | ''Conversion Matrix b''  
 
| bgcolor="#cccccc" | ''Conversion Matrix b''  
Line 291: Line 321:
 
| 1d {{bug|353678}}
 
| 1d {{bug|353678}}
 
|-
 
|-
| bgcolor="#cccccc" | ''Conversion Matrix l''
+
| bgcolor="#cccccc" | ''Conversion Matrix l''  
| --
+
| --  
|  
+
| <br>
 
| 1d {{bug|353922}}
 
| 1d {{bug|353922}}
 
|-
 
|-

Latest revision as of 16:57, 2 October 2012

Please see the parent of this page, EDT:EGL Language.

Conversions Between Primitive Types (Table 4)

Conversion Matrix

To see if there's a conversion from one type to another, find the cell in "from" type's row and the "to" type's column.

This matrix might contain differences from RBD.


bigint
boolean
bytes
date
decimal
float
  int 
number
smallfloat
smallint
string
time timestamp
bigint
a

g

f
f
f
f
f
f
d


boolean

a








b


bytes
h

j

i
h
h

h
h
e


date



a






k

l
decimal
f

g

j
f
f
f
f
f
d


float
f

g

f
a
f
f
f
f
d


int
f

g

f
f
a
f
f
f
d


number
f

g

f
f
f
a
f
f
d


smallfloat
f

g

f
f
f
f
a
f
d


smallint
f

g

f
f
f
f
f
a
d


string
d

e
k
d
d
d
d
d
d
a
m c
time









m a l
timestamp



l






c
l j

Key

blank cell = The types are incompatible.  Conversion is not supported.

a = Same types (not a conversion).

b = Booleans convert to strings as "true" or "false" (lowercase).

c = Strings convert to/from timestamps using a predefined format for timestamps (to be defined later).  The required fields come from the timestamp's pattern.   The conversions are not controlled by variables like RBD's defaultTimestampFormat.  Because of this, we can't convert from a string to a timestamp with no pattern.  We can convert from a timestamp with no pattern to a string.  Functions will be provided which convert to/from strings and timestamps with a format string supplied by the program.

d = Strings convert to/from numbers using our literal syntax for numbers.  The conversions are not controlled by variables like RBD's defaultNumericFormat.  Functions will be provided which convert to/from strings and numbers with a format string supplied by the program.

e = Strings and bytes are not compatible types, however there are functions defined on EString to allow conversion between them. Instance functions are provided for myString.toBytes(); no argument means use the default encoding, and a string argument specifies the encoding to use. There are also static EString.fromBytes(bytes) functions; one argument means use the default encoding, and a string argument specifies the encoding to use. To programmatically find the default encoding, use EString.getDefaultEncoding().

f = All numeric types are compatible with each other, but some conversions can result in overflow or truncation.

g = Numeric types convert to bytes using the number's bit pattern. When the bytes type includes a length (i.e. "bytes(4)" not just "bytes") the conversion is legal only if the size of the number in bytes equals the length of the bytes type.

h = Conversion from bytes to numeric types is done by interpreting the bytes data as a value in the format of the numeric type.  If the bytes type includes a length (i.e. "bytes(4)" not just "bytes") the conversion is legal only if the size of the number in bytes equals the length of the bytes type.  If the bytes type doesn't include a length, the conversion will fail at run time if the size of the number in bytes is not equal to the length of the bytes data.

i = This is like h, with the additional rule that the decimal type must include a length.  (Without the decimal's length we don't know how to interpret the bytes data.)

j = Conversion is necessary if the "from" and "to" types both have parameters (i.e. "bytes(4)" not just "bytes"), and the type parameters aren't identical.

k = Strings convert to/from dates using a predefined format for dates (to be defined later). The conversions are not controlled by variables like RBD's defaultDateFormat. Functions will be provided which convert to/from strings and dates with a format string supplied by the program.

l = Conversions between dates/times and timestamps work as they do in RBD.

m = Strings convert to/from times using a predefined format of "HH:mm:ss". The conversions are not controlled by variables like RBD's defaultTimeFormat.


Conversions Between Primitive Types1 Core JavaScript Java
Any to everything
2d - entire table (to verify validation lets all the valid conversions through and catches invalid)
bug 354161
1d
done bug 353673
Everything to any
--
1d
done bug 353674
Conversion Matrix b
--
0.1d
done
Conversion Matrix c
--
0.1d
1d bug 353675
Conversion Matrix d --
0.2d
1d bug 353676
Conversion Matrix e
--
0.5d
0.5d
Conversion Matrix f
--
done
2d bug 353677
Conversion Matrix g
--
1d
1d
Conversion Matrix h

--
2d
2d
Conversion Matrix i

--
1d
1d
Conversion Matrix j

--
1d
1d
Conversion Matrix k -- 1d 1d bug 353678
Conversion Matrix l --
1d bug 353922
Numeric overflows2

done
4d
4d

Notes on Table 4

  1. We'll document error conditions of conversions, and their resulting exceptions. Whenever possible this documentation will be comments in the EGL source file for a type.
  2. Our philosophy is that we can't make EDT be both efficient, and also behave the same in every environment when it comes to edge cases like numeric overflow. This means that in normal circumstances conversions to numeric types do not check for overflow: EGL does whatever the underlying language does in that situation. There will be special syntax for users to indicate that overflow checking is required. The syntax is To Be Determined. It may be an operation, something that looks like a function call where the source expression and target variable are passed in. What happens when an overflow is detected? We might throw an exception, but that's also To Be Determined.


Back to the top