Difference between pages "Directref" and "Array"

From Mesham
(Difference between pages)
Jump to navigationJump to search
m (5 revisions imported)
 
(Created page with '-- Syntax -- array[type,d1$,d2$,...,dn] -- Semantics -- An array, where ''type'' is the element type, followed by the dimensions. The programmer can provide any number of dime…')
 
Line 1: Line 1:
== Syntax ==
+
-- Syntax --
  
directref[ ]
+
array[type,d1$,d2$,...,dn]
  
== Semantics ==
+
-- Semantics --
  
This tells the compiler that the programmer might use this variable outside of the language (e.g. Via embedded C code) and not to perform certain optimisations which might not allow for this.
+
An array, where ''type'' is the element type, followed by the dimensions. The programmer can provide any number of dimensions to create an n dimension array. Default is row major allocation (although this can be overridden via types.) In order to access an element of an array, the programmer can either use the traditional ''name[index]'' syntax or, alternatively ''name#index'' which is preferred
  
== Example ==
+
-- Communication --
  
  function void main() {
+
When an array variable is assigned to another, depending on where each variable is allocated to, there may be communication to achieve this assignment. The table details the communication rules for this assignment ''assigned variable := assigning variable''. As with the element type, default communication of arrays is safe.
    var pid:Int :: allocated[multiple[]] :: directref[];
+
 
};
+
{| border="1" cellspacing="0" cellpadding="5" align="center"
 +
! Assigned Variable
 +
! Assigning Variable
 +
! Semantics
 +
|-
 +
| multiple[]
 +
| multiple[]
 +
| local assignment
 +
|-
 +
| single[on[i]]
 +
| multiple[]
 +
| local assignment on process i
 +
|-
 +
| multiple[]
 +
| single[on[i]]
 +
| broadcast from process i
 +
|-
 +
| single[on[i]]
 +
| single[on[i]]
 +
| local assignment where i==i
 +
|-
 +
| single[on[i]]
 +
| single[on[j]]
 +
| communication from j to i where i!=j
 +
|}
 +
 
 +
-- Example --
 +
 
 +
var a:array[String,2] :: allocated[multiple[]];
 +
(a#0):="Hello";
 +
(a#1):="World";
 +
print[(a#0)," ",(a#1),"\n"];
 +
 
 +
This example will declare variable ''a'' to be an array of 2 Strings. Then the first location in the array will be set to ''Hello'' and the second location set to ''World''. Lastly the code will display on stdio both these array string locations followed by newline.
  
''Since: Version 0.5''
 
  
 
[[Category:Type Library]]
 
[[Category:Type Library]]
[[Category:Compound Types]]
+
[[Category:Composite Types]]
[[Category:Attribute Types]]
+
[[Category:Collection Types]]

Revision as of 19:15, 10 January 2010

-- Syntax --

array[type,d1$,d2$,...,dn]

-- Semantics --

An array, where type is the element type, followed by the dimensions. The programmer can provide any number of dimensions to create an n dimension array. Default is row major allocation (although this can be overridden via types.) In order to access an element of an array, the programmer can either use the traditional name[index] syntax or, alternatively name#index which is preferred

-- Communication --

When an array variable is assigned to another, depending on where each variable is allocated to, there may be communication to achieve this assignment. The table details the communication rules for this assignment assigned variable := assigning variable. As with the element type, default communication of arrays is safe.

Assigned Variable Assigning Variable Semantics
multiple[] multiple[] local assignment
single[on[i]] multiple[] local assignment on process i
multiple[] single[on[i]] broadcast from process i
single[on[i]] single[on[i]] local assignment where i==i
single[on[i]] single[on[j]] communication from j to i where i!=j

-- Example --

var a:array[String,2] :: allocated[multiple[]];
(a#0):="Hello";
(a#1):="World";
print[(a#0)," ",(a#1),"\n"];

This example will declare variable a to be an array of 2 Strings. Then the first location in the array will be set to Hello and the second location set to World. Lastly the code will display on stdio both these array string locations followed by newline.