1*b1cdbd2cSJim Jagielski<?xml version="1.0" encoding="UTF-8"?> 2*b1cdbd2cSJim Jagielski 3*b1cdbd2cSJim Jagielski 4*b1cdbd2cSJim Jagielski<!--*********************************************************** 5*b1cdbd2cSJim Jagielski * 6*b1cdbd2cSJim Jagielski * Licensed to the Apache Software Foundation (ASF) under one 7*b1cdbd2cSJim Jagielski * or more contributor license agreements. See the NOTICE file 8*b1cdbd2cSJim Jagielski * distributed with this work for additional information 9*b1cdbd2cSJim Jagielski * regarding copyright ownership. The ASF licenses this file 10*b1cdbd2cSJim Jagielski * to you under the Apache License, Version 2.0 (the 11*b1cdbd2cSJim Jagielski * "License"); you may not use this file except in compliance 12*b1cdbd2cSJim Jagielski * with the License. You may obtain a copy of the License at 13*b1cdbd2cSJim Jagielski * 14*b1cdbd2cSJim Jagielski * http://www.apache.org/licenses/LICENSE-2.0 15*b1cdbd2cSJim Jagielski * 16*b1cdbd2cSJim Jagielski * Unless required by applicable law or agreed to in writing, 17*b1cdbd2cSJim Jagielski * software distributed under the License is distributed on an 18*b1cdbd2cSJim Jagielski * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 19*b1cdbd2cSJim Jagielski * KIND, either express or implied. See the License for the 20*b1cdbd2cSJim Jagielski * specific language governing permissions and limitations 21*b1cdbd2cSJim Jagielski * under the License. 22*b1cdbd2cSJim Jagielski * 23*b1cdbd2cSJim Jagielski ***********************************************************--> 24*b1cdbd2cSJim Jagielski 25*b1cdbd2cSJim Jagielski 26*b1cdbd2cSJim Jagielski 27*b1cdbd2cSJim Jagielski<helpdocument version="1.0"> 28*b1cdbd2cSJim Jagielski<meta> 29*b1cdbd2cSJim Jagielski<topic id="textsbasicshared03102101xml" indexer="include" status="PUBLISH"> 30*b1cdbd2cSJim Jagielski<title id="tit" xml-lang="en-US">ReDim Statement [Runtime]</title> 31*b1cdbd2cSJim Jagielski<filename>/text/sbasic/shared/03102101.xhp</filename> 32*b1cdbd2cSJim Jagielski</topic> 33*b1cdbd2cSJim Jagielski<history> 34*b1cdbd2cSJim Jagielski<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> 35*b1cdbd2cSJim Jagielski<lastedited date="2004-12-09T12:04:37">converted from old format - fpe</lastedited> 36*b1cdbd2cSJim Jagielski</history> 37*b1cdbd2cSJim Jagielski</meta> 38*b1cdbd2cSJim Jagielski<body> 39*b1cdbd2cSJim Jagielski<section id="redim"> 40*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="index" id="bm_id3150398"><bookmark_value>ReDim statement</bookmark_value> 41*b1cdbd2cSJim Jagielski</bookmark> 42*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3150398" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03102101.xhp" name="ReDim Statement [Runtime]">ReDim Statement [Runtime]</link></paragraph> 43*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3154685" xml-lang="en-US" l10n="U" oldref="2">Declares a variable or an array.</paragraph> 44*b1cdbd2cSJim Jagielski</section> 45*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3154218" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> 46*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3156214" xml-lang="en-US" l10n="U" oldref="4">[ReDim]Dim VarName [(start To end)] [As VarType][, VarName2 [(start To end)] [As VarType][,...]]</paragraph> 47*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id711996" xml-lang="en-US" l10n="NEW">Optionally, you can add the <emph>Preserve</emph> keyword as a parameter to preserve the contents of the array that is redimensioned.</paragraph> 48*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3148451" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> 49*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3156423" xml-lang="en-US" l10n="U" oldref="6"> 50*b1cdbd2cSJim Jagielski<emph>VarName:</emph> Any variable or array name.</paragraph> 51*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3149562" xml-lang="en-US" l10n="CHG" oldref="7"> 52*b1cdbd2cSJim Jagielski<emph>Start, End:</emph> Numerical values or constants that define the number of elements (NumberElements=(end-start)+1) and the index range.<comment>UFI: deleted the numbers</comment></paragraph> 53*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3155307" xml-lang="en-US" l10n="U" oldref="8">Start and End can be numeric expressions if ReDim is used at the procedure level.</paragraph> 54*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3153951" xml-lang="en-US" l10n="U" oldref="9"> 55*b1cdbd2cSJim Jagielski<emph>VarType:</emph> Keyword that declares the data type of a variable.</paragraph> 56*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3147317" xml-lang="en-US" l10n="U" oldref="10"> 57*b1cdbd2cSJim Jagielski<emph>Keyword:</emph> Variable type</paragraph> 58*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3153728" xml-lang="en-US" l10n="U" oldref="11"> 59*b1cdbd2cSJim Jagielski<emph>Bool: </emph>Boolean variable (True, False)</paragraph> 60*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3146121" xml-lang="en-US" l10n="U" oldref="12"> 61*b1cdbd2cSJim Jagielski<emph>Date:</emph> Date variable</paragraph> 62*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3159156" xml-lang="en-US" l10n="U" oldref="13"> 63*b1cdbd2cSJim Jagielski<emph>Double:</emph> Double floating point variable (1.79769313486232x10E308 - 4.94065645841247x10E-324)</paragraph> 64*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3148616" xml-lang="en-US" l10n="U" oldref="14"> 65*b1cdbd2cSJim Jagielski<emph>Integer:</emph> Integer variable (-32768 - 32767)</paragraph> 66*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3147348" xml-lang="en-US" l10n="U" oldref="15"> 67*b1cdbd2cSJim Jagielski<emph>Long:</emph> Long integer variable (-2,147,483,648 - 2,147,483,647)</paragraph> 68*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3149412" xml-lang="en-US" l10n="U" oldref="16"> 69*b1cdbd2cSJim Jagielski<emph>Object:</emph> Object variable (can only be subsequently defined by Set!)</paragraph> 70*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3154729" xml-lang="en-US" l10n="U" oldref="17"> 71*b1cdbd2cSJim Jagielski<emph>[Single]:</emph> Single floating-point variable (3.402823x10E38 - 1.401298x10E-45). If no key word is specified, a variable is defined as Single, unless a statement from DefBool to DefVar is used.</paragraph> 72*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3148458" xml-lang="en-US" l10n="U" oldref="18"> 73*b1cdbd2cSJim Jagielski<emph>String:</emph> String variable containing a maximum of 64,000 ASCII characters.</paragraph> 74*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3149581" xml-lang="en-US" l10n="U" oldref="19"> 75*b1cdbd2cSJim Jagielski<emph>Variant: </emph>Variant variable type (can contain all types and is set by definition).</paragraph> 76*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3155601" xml-lang="en-US" l10n="U" oldref="20">In $[officename] Basic, you do not need to declare variables explicitly. However, you need to declare an array before you can use them. You can declare a variable 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.</paragraph> 77*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3153415" xml-lang="en-US" l10n="U" oldref="21">$[officename] Basic supports single or multi-dimensional arrays that are defined by a specified variable type. Arrays are suitable if the program contains lists or tables that you want to edit. 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.</paragraph> 78*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3146971" xml-lang="en-US" l10n="U" oldref="22">There are two ways to set the range of indices for arrays declared with the Dim statement:</paragraph> 79*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3153950" xml-lang="en-US" l10n="U" oldref="23">DIM text(20) As String REM 21 elements numbered from 0 to 20</paragraph> 80*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3146912" xml-lang="en-US" l10n="U" oldref="24">DIM text(5 to 25) As String REM 21 elements numbered from 5 to 25</paragraph> 81*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3153709" xml-lang="en-US" l10n="U" oldref="25">DIM text$(-15 to 5) As String REM 21 elements (0 inclusive),</paragraph> 82*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3150321" xml-lang="en-US" l10n="U" oldref="26">rem numbered from -15 to 5</paragraph> 83*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3149018" xml-lang="en-US" l10n="U" oldref="27">Variable fields, regardless of type, can be made dynamic if they are dimensioned by ReDim at the procedure level in subroutines or functions. Normally, you can only set the range of an array once and you cannot modify it. Within a procedure, you can declare an array using the ReDim statement with numeric expressions to define the range of the field sizes.</paragraph> 84*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3148405" xml-lang="en-US" level="2" l10n="U" oldref="28">Example:</paragraph> 85*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3154362" xml-lang="en-US" l10n="U" oldref="29">Sub ExampleRedim</paragraph> 86*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3150042" xml-lang="en-US" l10n="U" oldref="30">Dim iVar() As Integer, iCount As Integer</paragraph> 87*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3147339" xml-lang="en-US" l10n="U" oldref="31">ReDim iVar(5) As integer</paragraph> 88*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3149106" xml-lang="en-US" l10n="U" oldref="32">For iCount = 1 To 5</paragraph> 89*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3155174" xml-lang="en-US" l10n="U" oldref="33">iVar(iCount) = iCount</paragraph> 90*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3163805" xml-lang="en-US" l10n="U" oldref="34">Next iCount</paragraph> 91*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3149568" xml-lang="en-US" l10n="U" oldref="35">ReDim iVar(10) As integer</paragraph> 92*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3147364" xml-lang="en-US" l10n="U" oldref="36">For iCount = 1 To 10</paragraph> 93*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3155335" xml-lang="en-US" l10n="U" oldref="37">iVar(iCount) = iCount</paragraph> 94*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3154662" xml-lang="en-US" l10n="U" oldref="38">Next iCount</paragraph> 95*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3149926" xml-lang="en-US" l10n="U" oldref="39">end sub</paragraph> 96*b1cdbd2cSJim Jagielski</body> 97*b1cdbd2cSJim Jagielski</helpdocument> 98