|
|
| Line 1: |
Line 1: |
| − | == Syntax == | + | == Overview == |
| | | | |
| − | array[type,d<sub>1</sub>,d<sub>2</sub>,...,d<sub>n</sub>]
| + | This open(n,a) function will open the file of name ''n'' with mode of ''a''. |
| | | | |
| − | == Semantics ==
| + | * '''Pass:''' The name of the file to open of type [[String]] and mode of type [[String]] |
| − | | + | * '''Returns:''' A file handle of type [[File]] |
| − | An array, where ''type'' is the element or record 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 uses the traditional ''name[index]'' syntax.<br><br>
| |
| − | ''Note:'' If the dimensions are omitted then it is assumed to be a one dimensional array of infinite size without any explicit memory allocation (i.e. data provided into a function.) Be aware, without any size information then it is not possible to bounds check indexes.
| |
| − | | |
| − | === Default typing ===
| |
| − | | |
| − | In the absence of further type information, the following types are added to the chain:
| |
| − | | |
| − | * [[allocated]]
| |
| − | * [[multiple]]
| |
| − | * [[heap]] | |
| − | * [[onesided]]
| |
| − | | |
| − | == 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.
| |
| − | | |
| − | {| border="1" cellspacing="0" cellpadding="5" align="center"
| |
| − | ! Assigned Variable
| |
| − | ! Assigning Variable
| |
| − | ! Semantics
| |
| − | |-
| |
| − | | multiple[]
| |
| − | | multiple[]
| |
| − | | local assignment
| |
| − | |-
| |
| − | | single[on[i]]
| |
| − | | multiple[]
| |
| − | | Communication to 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 == | | == Example == |
| | | | |
| | #include <io> | | #include <io> |
| − | #include <string> | + | |
| − | var a:array[String,2]; | + | function void main() { |
| − | a[0]:="Hello";
| + | var f:=open("myfile.txt","r"); |
| − | a[1]:="World";
| + | close(f); |
| − | print(itostring(a[0])+" "+itostring(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 1.0'' |
| | | | |
| − | [[Category:Type Library]] | + | [[Category:Function Library]] |
| − | [[Category:Composite Types]] | + | [[Category:IO Functions]] |
| − | [[Category:Collection Types]]
| |
