xref: /trunk/main/helpcontent2/source/text/sbasic/shared/03020303.xhp (revision 72b84558979a0665883a3fe8b193179cd239c447)
1cdf0e10cSrcweir<?xml version="1.0" encoding="UTF-8"?>
2cdf0e10cSrcweir
3226a8927SAndrew Rist<!--***********************************************************
4cdf0e10cSrcweir *
5226a8927SAndrew Rist * Licensed to the Apache Software Foundation (ASF) under one
6226a8927SAndrew Rist * or more contributor license agreements.  See the NOTICE file
7226a8927SAndrew Rist * distributed with this work for additional information
8226a8927SAndrew Rist * regarding copyright ownership.  The ASF licenses this file
9226a8927SAndrew Rist * to you under the Apache License, Version 2.0 (the
10226a8927SAndrew Rist * "License"); you may not use this file except in compliance
11226a8927SAndrew Rist * with the License.  You may obtain a copy of the License at
12cdf0e10cSrcweir *
13226a8927SAndrew Rist *   http://www.apache.org/licenses/LICENSE-2.0
14cdf0e10cSrcweir *
15226a8927SAndrew Rist * Unless required by applicable law or agreed to in writing,
16226a8927SAndrew Rist * software distributed under the License is distributed on an
17226a8927SAndrew Rist * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
18226a8927SAndrew Rist * KIND, either express or implied.  See the License for the
19226a8927SAndrew Rist * specific language governing permissions and limitations
20226a8927SAndrew Rist * under the License.
21cdf0e10cSrcweir *
22226a8927SAndrew Rist ***********************************************************-->
23226a8927SAndrew Rist
24cdf0e10cSrcweir<helpdocument version="1.0">
25cdf0e10cSrcweir<meta>
26cdf0e10cSrcweir<topic id="textsbasicshared03020303xml" indexer="include" status="PUBLISH">
27cdf0e10cSrcweir<title id="tit" xml-lang="en-US">Lof Function [Runtime]</title>
28cdf0e10cSrcweir<filename>/text/sbasic/shared/03020303.xhp</filename>
29cdf0e10cSrcweir</topic>
30cdf0e10cSrcweir</meta>
31cdf0e10cSrcweir<body>
32cdf0e10cSrcweir<section id="lof">
33cd3ec106Smseidel<bookmark xml-lang="en-US" branch="index" id="bm_id3156024">
34cd3ec106Smseidel<bookmark_value>Lof function</bookmark_value>
35cdf0e10cSrcweir</bookmark>
36*72b84558Smseidel<paragraph role="heading" id="hd_id3156024" xml-lang="en-US" level="1" l10n="U"><link href="text/sbasic/shared/03020303.xhp" name="Lof Function [Runtime]">Lof Function [Runtime]</link></paragraph>
37*72b84558Smseidel<paragraph role="paragraph" id="par_id3146794" xml-lang="en-US" l10n="U">Returns the size of an open file in bytes.</paragraph>
38cdf0e10cSrcweir</section>
39*72b84558Smseidel<paragraph role="heading" id="hd_id3153380" xml-lang="en-US" level="2" l10n="U">Syntax:</paragraph>
40*72b84558Smseidel<paragraph role="code" id="par_id3150359" xml-lang="en-US" l10n="U">Lof (FileNumber)</paragraph>
41*72b84558Smseidel<paragraph role="heading" id="hd_id3154141" xml-lang="en-US" level="2" l10n="U">Return value:</paragraph>
42*72b84558Smseidel<paragraph role="paragraph" id="par_id3147230" xml-lang="en-US" l10n="U">Long</paragraph>
43*72b84558Smseidel<paragraph role="heading" id="hd_id3156281" xml-lang="en-US" level="2" l10n="U">Parameters:</paragraph>
44*72b84558Smseidel<paragraph role="paragraph" id="par_id3150869" xml-lang="en-US" l10n="U"><emph>FileNumber:</emph> Any numeric expression that contains the file number that is specified in the Open statement.</paragraph>
45*72b84558Smseidel<paragraph role="tip" id="par_id3147349" xml-lang="en-US" l10n="U">To obtain the length of a file that is not open, use the <emph>FileLen</emph> function.</paragraph>
46cdf0e10cSrcweir<embed href="text/sbasic/shared/00000003.xhp#errorcode"/>
47cdf0e10cSrcweir<embed href="text/sbasic/shared/00000003.xhp#err5"/>
48cdf0e10cSrcweir<embed href="text/sbasic/shared/00000003.xhp#err52"/>
49*72b84558Smseidel<paragraph role="heading" id="hd_id3155415" xml-lang="en-US" level="2" l10n="U">Example:</paragraph>
50*72b84558Smseidel<paragraph role="code" id="par_id3151074" xml-lang="en-US" l10n="U">Sub ExampleRandomAccess</paragraph>
51*72b84558Smseidel<paragraph role="code" id="par_id3145251" xml-lang="en-US" l10n="U">Dim iNumber As Integer</paragraph>
52*72b84558Smseidel<paragraph role="code" id="par_id3154730" xml-lang="en-US" l10n="U">Dim sText As Variant REM must be a Variant</paragraph>
53*72b84558Smseidel<paragraph role="code" id="par_id3145646" xml-lang="en-US" l10n="U">Dim aFile As String</paragraph>
54*72b84558Smseidel<paragraph role="code" id="par_id3153157" xml-lang="en-US" l10n="U">aFile = "c:\data.txt"</paragraph>
55*72b84558Smseidel<paragraph role="code" id="par_id3149403" xml-lang="en-US" l10n="U">iNumber = Freefile</paragraph>
56*72b84558Smseidel<paragraph role="code" id="par_id3149121" xml-lang="en-US" l10n="U">Open aFile For Random As #iNumber Len=32</paragraph>
57*72b84558Smseidel<paragraph role="code" id="par_id3156276" xml-lang="en-US" l10n="U">Seek #iNumber,1 REM Position at start</paragraph>
58*72b84558Smseidel<paragraph role="code" id="par_id3148405" xml-lang="en-US" l10n="U">Put #iNumber,, "This is the first line of text" REM Fill with text</paragraph>
59*72b84558Smseidel<paragraph role="code" id="par_id3154756" xml-lang="en-US" l10n="U">Put #iNumber,, "This is the second line of text"</paragraph>
60*72b84558Smseidel<paragraph role="code" id="par_id3145643" xml-lang="en-US" l10n="U">Put #iNumber,, "This is the third line of text"</paragraph>
61*72b84558Smseidel<paragraph role="code" id="par_id3156383" xml-lang="en-US" l10n="U">Seek #iNumber,2</paragraph>
62*72b84558Smseidel<paragraph role="code" id="par_id3155333" xml-lang="en-US" l10n="U">Get #iNumber,,sText</paragraph>
63*72b84558Smseidel<paragraph role="code" id="par_id3149255" xml-lang="en-US" l10n="U">Print sText</paragraph>
64*72b84558Smseidel<paragraph role="code" id="par_id3154702" xml-lang="en-US" l10n="U">Close #iNumber</paragraph>
65*72b84558Smseidel<paragraph role="code" id="par_id3153965" xml-lang="en-US" l10n="U">iNumber = Freefile</paragraph>
66*72b84558Smseidel<paragraph role="code" id="par_id3163807" xml-lang="en-US" l10n="U">Open aFile For Random As #iNumber Len=32</paragraph>
67*72b84558Smseidel<paragraph role="code" id="par_id3155607" xml-lang="en-US" l10n="U">Get #iNumber,2,sText</paragraph>
68*72b84558Smseidel<paragraph role="code" id="par_id3150299" xml-lang="en-US" l10n="U">Put #iNumber,,"This is a new line of text"</paragraph>
69*72b84558Smseidel<paragraph role="code" id="par_id3147002" xml-lang="en-US" l10n="U">Get #iNumber,1,sText</paragraph>
70*72b84558Smseidel<paragraph role="code" id="par_id3149036" xml-lang="en-US" l10n="U">Get #iNumber,2,sText</paragraph>
71*72b84558Smseidel<paragraph role="code" id="par_id3166425" xml-lang="en-US" l10n="U">Put #iNumber,20,"This is the text in record 20"</paragraph>
72*72b84558Smseidel<paragraph role="code" id="par_id3149817" xml-lang="en-US" l10n="U">Print Lof(#iNumber)</paragraph>
73*72b84558Smseidel<paragraph role="code" id="par_id3146811" xml-lang="en-US" l10n="U">Close #iNumber</paragraph>
74*72b84558Smseidel<paragraph role="code" id="par_id3154200" xml-lang="en-US" l10n="U">end sub</paragraph>
75cdf0e10cSrcweir</body>
76cdf0e10cSrcweir</helpdocument>
77