1------------------------------------------------------------------------------ 2-- -- 3-- GNAT RUN-TIME COMPONENTS -- 4-- -- 5-- A D A . T E X T _ I O . G E T _ L I N E -- 6-- -- 7-- B o d y -- 8-- -- 9-- Copyright (C) 1992-2010, Free Software Foundation, Inc. -- 10-- -- 11-- GNAT is free software; you can redistribute it and/or modify it under -- 12-- terms of the GNU General Public License as published by the Free Soft- -- 13-- ware Foundation; either version 3, or (at your option) any later ver- -- 14-- sion. GNAT is distributed in the hope that it will be useful, but WITH- -- 15-- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY -- 16-- or FITNESS FOR A PARTICULAR PURPOSE. -- 17-- -- 18-- As a special exception under Section 7 of GPL version 3, you are granted -- 19-- additional permissions described in the GCC Runtime Library Exception, -- 20-- version 3.1, as published by the Free Software Foundation. -- 21-- -- 22-- You should have received a copy of the GNU General Public License and -- 23-- a copy of the GCC Runtime Library Exception along with this program; -- 24-- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see -- 25-- <http://www.gnu.org/licenses/>. -- 26-- -- 27-- GNAT was originally developed by the GNAT team at New York University. -- 28-- Extensive contributions were provided by Ada Core Technologies Inc. -- 29-- -- 30------------------------------------------------------------------------------ 31 32-- The implementation of Ada.Text_IO.Get_Line is split into a subunit so that 33-- different implementations can be used on different systems. This is the 34-- standard implementation (it uses low level features not suitable for use 35-- in the JVM or .NET implementations). 36 37with System; use System; 38with System.Storage_Elements; use System.Storage_Elements; 39 40separate (Ada.Text_IO) 41procedure Get_Line 42 (File : File_Type; 43 Item : out String; 44 Last : out Natural) 45is 46 Chunk_Size : constant := 80; 47 -- We read into a fixed size auxiliary buffer. Because this buffer 48 -- needs to be pre-initialized, there is a trade-off between size and 49 -- speed. Experiments find returns are diminishing after 50 and this 50 -- size allows most lines to be processed with a single read. 51 52 ch : int; 53 N : Natural; 54 55 procedure memcpy (s1, s2 : chars; n : size_t); 56 pragma Import (C, memcpy); 57 58 function memchr (s : chars; ch : int; n : size_t) return chars; 59 pragma Import (C, memchr); 60 61 procedure memset (b : chars; ch : int; n : size_t); 62 pragma Import (C, memset); 63 64 function Get_Chunk (N : Positive) return Natural; 65 -- Reads at most N - 1 characters into Item (Last + 1 .. Item'Last), 66 -- updating Last. Raises End_Error if nothing was read (End_Of_File). 67 -- Returns number of characters still to read (either 0 or 1) in 68 -- case of success. 69 70 --------------- 71 -- Get_Chunk -- 72 --------------- 73 74 function Get_Chunk (N : Positive) return Natural is 75 Buf : String (1 .. Chunk_Size); 76 S : constant chars := Buf (1)'Address; 77 P : chars; 78 79 begin 80 if N = 1 then 81 return N; 82 end if; 83 84 memset (S, 10, size_t (N)); 85 86 if fgets (S, N, File.Stream) = Null_Address then 87 if ferror (File.Stream) /= 0 then 88 raise Device_Error; 89 90 -- If incomplete last line, pretend we found a LM 91 92 elsif Last >= Item'First then 93 return 0; 94 95 else 96 raise End_Error; 97 end if; 98 end if; 99 100 P := memchr (S, LM, size_t (N)); 101 102 -- If no LM is found, the buffer got filled without reading a new 103 -- line. Otherwise, the LM is either one from the input, or else one 104 -- from the initialization, which means an incomplete end-of-line was 105 -- encountered. Only in first case the LM will be followed by a 0. 106 107 if P = Null_Address then 108 pragma Assert (Buf (N) = ASCII.NUL); 109 memcpy (Item (Last + 1)'Address, 110 Buf (1)'Address, size_t (N - 1)); 111 Last := Last + N - 1; 112 113 return 1; 114 115 else 116 -- P points to the LM character. Set K so Buf (K) is the character 117 -- right before. 118 119 declare 120 K : Natural := Natural (P - S); 121 122 begin 123 -- Now Buf (K + 2) should be 0, or otherwise Buf (K) is the 0 124 -- put in by fgets, so compensate. 125 126 if K + 2 > Buf'Last or else Buf (K + 2) /= ASCII.NUL then 127 128 -- Incomplete last line, so remove the extra 0 129 130 pragma Assert (Buf (K) = ASCII.NUL); 131 K := K - 1; 132 end if; 133 134 memcpy (Item (Last + 1)'Address, 135 Buf (1)'Address, size_t (K)); 136 Last := Last + K; 137 end; 138 139 return 0; 140 end if; 141 end Get_Chunk; 142 143-- Start of processing for Get_Line 144 145begin 146 FIO.Check_Read_Status (AP (File)); 147 148 -- Immediate exit for null string, this is a case in which we do not 149 -- need to test for end of file and we do not skip a line mark under 150 -- any circumstances. 151 152 if Item'First > Item'Last then 153 return; 154 end if; 155 156 N := Item'Last - Item'First + 1; 157 158 Last := Item'First - 1; 159 160 -- Here we have at least one character, if we are immediately before 161 -- a line mark, then we will just skip past it storing no characters. 162 163 if File.Before_LM then 164 File.Before_LM := False; 165 File.Before_LM_PM := False; 166 167 -- Otherwise we need to read some characters 168 169 else 170 while N >= Chunk_Size loop 171 if Get_Chunk (Chunk_Size) = 0 then 172 N := 0; 173 else 174 N := N - Chunk_Size + 1; 175 end if; 176 end loop; 177 178 if N > 1 then 179 N := Get_Chunk (N); 180 end if; 181 182 -- Almost there, only a little bit more to read 183 184 if N = 1 then 185 ch := Getc (File); 186 187 -- If we get EOF after already reading data, this is an incomplete 188 -- last line, in which case no End_Error should be raised. 189 190 if ch = EOF and then Last < Item'First then 191 raise End_Error; 192 193 elsif ch /= LM then 194 195 -- Buffer really is full without having seen LM, update col 196 197 Last := Last + 1; 198 Item (Last) := Character'Val (ch); 199 File.Col := File.Col + Count (Last - Item'First + 1); 200 return; 201 end if; 202 end if; 203 end if; 204 205 -- We have skipped past, but not stored, a line mark. Skip following 206 -- page mark if one follows, but do not do this for a non-regular file 207 -- (since otherwise we get annoying wait for an extra character) 208 209 File.Line := File.Line + 1; 210 File.Col := 1; 211 212 if File.Before_LM_PM then 213 File.Line := 1; 214 File.Before_LM_PM := False; 215 File.Page := File.Page + 1; 216 217 elsif File.Is_Regular_File then 218 ch := Getc (File); 219 220 if ch = PM and then File.Is_Regular_File then 221 File.Line := 1; 222 File.Page := File.Page + 1; 223 else 224 Ungetc (ch, File); 225 end if; 226 end if; 227end Get_Line; 228