home *** CD-ROM | disk | FTP | other *** search
/ Kompuutteri Kaikille K-CD 2002 #3 / K-CD_2002-03.iso / OpenOffice / f_0046 / sbasic.jar / text / sbasic / common / 03102100.xml < prev    next >
Extensible Markup Language  |  2001-09-07  |  9KB  |  118 lines

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <html><head><title>Dim Statement [Runtime]</title><meta name="filename" content="text/sbasic/common/03102100"/><help:css-file-link xmlns:help="http://openoffice.org/2000/help"/><!--The CSS style header method for setting styles--><style type="text/css">
  3.  
  4.         table.Tabelle1{
  5.                 }
  6.         span.Tabelle1A{
  7.                 width:1.499cm;}
  8.         span.Tabelle1B{
  9.                 width:16.498cm;}
  10.         tr.Tabelle11{
  11.                 }
  12.         td.Tabelle1A1{
  13.                 }
  14.         table.Tabelle2{
  15.                 }
  16.         span.Tabelle2A{
  17.                 width:1.499cm;}
  18.         span.Tabelle2B{
  19.                 width:16.498cm;}
  20.         tr.Tabelle21{
  21.                 }
  22.         td.Tabelle2A1{
  23.                 }
  24.         p.P1{
  25.                 }
  26.         span.T1{
  27.                 font-weight:bold;}
  28.         span.fr1{
  29.                 }
  30.         </style></head><body>
  31.   
  32.   
  33.   <help:to-be-embedded Eid="dimtext" xmlns:help="http://openoffice.org/2000/help">
  34.   <p class="Head1"><help:link Id="66441">Dim Statement [Runtime]</help:link></p>
  35.   <p class="Paragraph">Declares a variable or an <help:key-word value="array" tag="kw66441_2"/>array.</p>
  36.   </help:to-be-embedded>
  37.   <table><tr class="Tabelle11"><th class="Tabelle1A1" style="text-align:left;"><span class="Tabelle1A">
  38.       <p class="TextInTable"><draw:image draw:style-name="fr1" draw:name="HIND_1" text:anchor-type="paragraph" svg:width="0.847cm" svg:height="0.847cm" draw:z-index="0" xlink:href="65980" xlink:type="simple" xlink:show="embed" xlink:actuate="onRequest" draw:filter-name="GIF - Graphics Interchange" xmlns:draw="http://openoffice.org/2000/drawing" xmlns:text="http://openoffice.org/2000/text" xmlns:svg="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"/>
  39.       </p>
  40.      </span></th><th class="Tabelle1A1" style="text-align:left;"><span class="Tabelle1B">
  41.       <p class="TextInTable">If the variables are separated with comma (e.g. DIM sPar1, sPar2, sPar3 AS STRING), only Variant variables will be defined up to the last variable. An own definition line should be used for each variable.</p>
  42.      </span></th></tr><tr class=""><td class="Tabelle1A1" style="text-align:left;"><span class="Tabelle1A">
  43.      <p class="TextInTable"/>
  44.     </span></td><td class="Tabelle1A1" style="text-align:left;"><span class="Tabelle1B">
  45.      <p class="TextInTable">DIM sPar1 AS STRING</p>
  46.     </span></td></tr><tr class=""><td class="Tabelle1A1" style="text-align:left;"><span class="Tabelle1A">
  47.      <p class="TextInTable"/>
  48.     </span></td><td class="Tabelle1A1" style="text-align:left;"><span class="Tabelle1B">
  49.      <p class="TextInTable">DIM sPar2 AS STRING</p>
  50.     </span></td></tr><tr class=""><td class="Tabelle1A1" style="text-align:left;"><span class="Tabelle1A">
  51.      <p class="TextInTable"/>
  52.     </span></td><td class="Tabelle1A1" style="text-align:left;"><span class="Tabelle1B">
  53.      <p class="TextInTable">DIM sPar3 AS STRING</p>
  54.     </span></td></tr></table>
  55.   <p class="Paragraph"/>
  56.   <p class="Paragraph"/>
  57.   <table><tr class="Tabelle21"><th class="Tabelle2A1" style="text-align:left;"><span class="Tabelle2A">
  58.       <p class="TextInTable"><draw:image draw:style-name="fr1" draw:name="HIND_2" text:anchor-type="paragraph" svg:width="0.847cm" svg:height="0.847cm" draw:z-index="1" xlink:href="65980" xlink:type="simple" xlink:show="embed" xlink:actuate="onRequest" draw:filter-name="GIF - Graphics Interchange" xmlns:draw="http://openoffice.org/2000/drawing" xmlns:text="http://openoffice.org/2000/text" xmlns:svg="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"/>
  59.       </p>
  60.      </span></th><th class="Tabelle2A1" style="text-align:left;"><span class="Tabelle2B">
  61.       <p class="TextInTable">Dim is used to declare local variables within Subs. Global variables outside of Subs are declared with the PUBLIC or PRIVATE statements.</p>
  62.      </span></th></tr></table>
  63.   <p class="Paragraph"/>
  64.   <p class="Paragraph"><span class="T1">Syntax</span>:</p>
  65.   <p class="Paragraph">[ReDim]Dim VarName [(start To end)] [As VarType][, VarName2 [(start To end)] [As VarType][,...]] <help:key-word value="Dim" tag="kw66441_1" xmlns:help="http://openoffice.org/2000/help"/></p>
  66.   <p class="Paragraph"><span class="T1">Parameter</span>:</p>
  67.   <p class="Paragraph">VarName: Any variable or array name.</p>
  68.   <p class="Paragraph">Start, End: Numerical values or constants ranging from -32768 to 32767 which define the number of elements (NumberElements=(end-start)+1) and the index range.</p>
  69.   <p class="Paragraph">Start and End can be numerical expressions, if ReDim is applied at the procedure level.</p>
  70.   <p class="Paragraph">VarType: Key word used to declare the data type of a variable.</p>
  71.   <p class="Paragraph">Keyword: Variable type</p>
  72.   <p class="Paragraph">Bool: Boolean variable (True, False)</p>
  73.   <p class="Paragraph">Currency: Currency-Variable (Currency with 4 Decimal places)</p>
  74.   <p class="Paragraph">Date: Date variable</p>
  75.   <p class="Paragraph">Double: Double-precision floating-point variable (1,79769313486232┬áx┬á10E308 - 4,94065645841247 x 10E-324)</p>
  76.   <p class="Paragraph">Integer : Integer variable (-32768 - 32767)</p>
  77.   <p class="Paragraph">Long: Long integer variable (-2.147.483.648 - 2.147.483.647)</p>
  78.   <p class="Paragraph">Object: Object variable (Note: can only be subsequently defined with Set!)</p>
  79.   <p class="Paragraph">Single: Single-precision floating-point variable (3,402823 x 10E38 - 1,401298 x 10E-45).</p>
  80.   <p class="Paragraph">String: String variable consisting of a maximum of 64,000 ASCII characters.</p>
  81.   <p class="Paragraph">[Variant] : Variant variable type (contains all types, specified by definition). If no key word is given, variables are automatically defined as Variant Type , unless a statement from DefBool to DefVar was used.</p>
  82.   <p class="Paragraph">In OpenOffice.org Basic, variables need not to be declared explicitly. Only arrays must declared before use. A variable can be declared with the Dim statement, using commas to separate multiple declarations. To declare a variable type, enter a type-declaration character following the name or use a corresponding key word.</p>
  83.   <p class="Paragraph">OpenOffice.org Basic supports single or multi-dimensional arrays, defined by a specified variable type. Arrays are suitable if the program contains lists or tables to be edited. The advantage of arrays is that it is possible to address individual elements according to indexes, which can be formulated as numeric expressions or variables.</p>
  84.   <p class="Paragraph">Arrays are declared with the Dim statement. There are two methods to define the index range:</p>
  85.   <p class="Paragraph">DIM text(20) as String REM 21 elements numbered from 0 to 20</p>
  86.   <p class="Paragraph">DIM text(5 to 25) as String REM 21 elements numbered from 5 to 25</p>
  87.   <p class="Paragraph">DIM text(-15 to 5) as String REM 21 elements (including 0)</p>
  88.   <p class="Paragraph">REM numbered from -15 to 5</p>
  89.   <p class="Paragraph">Two-dimensional data field</p>
  90.   <p class="Paragraph">DIM text(20,2) as String REM 63 elements; form 0 to 20 level 1, from 0 to 20 level 2 and from 0 to 20 level 3.</p>
  91.   <p class="Paragraph">All array types can be declared dynamic if the ReDim statement is used within the procedure (in Subs or functions) to define the number of dimensions. Generally, array dimensions can only be defined once, and cannot be subsequently modified. Within a procedure, an array can be declared with <span class="T1">ReDim</span>; dimensions can only be defined by numeric expressions, ensuring that the fields are only as large as necessary.</p>
  92.   <p class="Paragraph"><span class="T1">Example:</span></p>
  93.   <p class="PropText">Sub ExampleDim1</p>
  94.   <p class="PropText">Dim sVar As String</p>
  95.   <p class="PropText">Dim iVar As Integer</p>
  96.   <p class="PropText">sVar = "Star Office"</p>
  97.   <p class="PropText">End Sub</p>
  98.   <p class="PropText"/>
  99.   <p class="PropText">Sub ExampleDim2</p>
  100.   <p class="PropText">REM Two-dimensional data field</p>
  101.   <p class="PropText">Dim stext(20,2) as String</p>
  102.   <p class="PropText">Const sDim as String = " Dimension:"</p>
  103.   <p class="PropText"/>
  104.   <p class="PropText">for i = 0 to 20</p>
  105.   <p class="PropText">for ii = 0 to 2</p>
  106.   <p class="PropText">stext(i,ii) = str(i) & sDim & str(ii)</p>
  107.   <p class="PropText">next ii</p>
  108.   <p class="PropText">next i</p>
  109.   <p class="PropText"/>
  110.   <p class="PropText">for i = 0 to 20</p>
  111.   <p class="PropText">for ii = 0 to 2</p>
  112.   <p class="PropText">msgbox stext(i,ii)</p>
  113.   <p class="PropText">next ii</p>
  114.   <p class="PropText">next i</p>
  115.   <p class="PropText">End Sub</p>
  116.   <p class="PropText"/>
  117.   <p class="PropText"/>
  118.  </body></html>