-- CXAA003.A -- -- Grant of Unlimited Rights -- -- Under contracts F33600-87-D-0337, F33600-84-D-0280, MDA903-79-C-0687, -- F08630-91-C-0015, and DCA100-97-D-0025, the U.S. Government obtained -- unlimited rights in the software and documentation contained herein. -- Unlimited rights are defined in DFAR 252.227-7013(a)(19). By making -- this public release, the Government intends to confer upon all -- recipients unlimited rights equal to those held by the Government. -- These rights include rights to use, duplicate, release or disclose the -- released technical data and computer software in whole or in part, in -- any manner and for any purpose whatsoever, and to have or permit others -- to do so. -- -- DISCLAIMER -- -- ALL MATERIALS OR INFORMATION HEREIN RELEASED, MADE AVAILABLE OR -- DISCLOSED ARE AS IS. THE GOVERNMENT MAKES NO EXPRESS OR IMPLIED -- WARRANTY AS TO ANY MATTER WHATSOEVER, INCLUDING THE CONDITIONS OF THE -- SOFTWARE, DOCUMENTATION OR OTHER INFORMATION RELEASED, MADE AVAILABLE -- OR DISCLOSED, OR THE OWNERSHIP, MERCHANTABILITY, OR FITNESS FOR A -- PARTICULAR PURPOSE OF SAID MATERIAL. --* -- -- OBJECTIVE: -- Check that the procedures New_Page, Set_Line, Set_Col, and New_Line -- subprograms perform properly on a text file reset (from Out_File) -- with mode Append_File. -- Check that the attributes Page, Line, and Column are all set to 1 -- following the reset of a text file with mode Append_File. -- Check that the functions Page, Line, and Col perform properly on a -- text file reset with mode Append_File. -- Check that the procedures Put and Put_Line perform properly on text -- files reset with mode Append_File. -- Check that the procedure Set_Line sets the current line number to -- the value specified by the parameter "To" for text files reset with -- mode Append_File. Check that Set_Line has no effect if the specified -- line equals the current line. -- Check that the procedure Set_Col sets the current column number to -- the value specified by the parameter "To" for text files reset with -- mode Append_File. -- -- TEST DESCRIPTION: -- This test is designed to simulate the text processing that could -- occur with files that have been created in Out_File mode, -- and then reset to Append_File mode. -- Various calls to Text_IO formatting subprograms are called to properly -- position text appended to a document. The text content and position -- are subsequently verified for accuracy. -- -- APPLICABILITY CRITERIA: -- This test is applicable only to implementations that support text -- files. -- -- -- CHANGE HISTORY: -- 06 Dec 94 SAIC ACVC 2.0 -- 24 Feb 97 PWB.CTA Allowed for non-support of some IO operations. --! with Ada.Text_IO; with Report; procedure CXAA003 is use Ada; Data_File : Text_IO.File_Type; Data_Filename : constant String := Report.Legal_File_Name ( Nam => "CXAA003" ); Incomplete : exception; begin Report.Test ("CXAA003", "Check that page, line, and column formatting " & "subprograms perform properly on text files " & "reset with mode Append_File"); Test_for_Text_IO_Support: begin -- An implementation that does not support Text_IO in a particular -- environment will raise Use_Error on calls to various -- Text_IO operations. This block statement encloses a call to -- Create, which should raise the exception in a non-supportive -- environment. This exception will be handled to produce a -- Not_Applicable result. Text_IO.Create (File => Data_File, Mode => Text_IO.Out_File, Name => Data_Filename); exception when Text_IO.Use_Error | Text_IO.Name_Error => Report.Not_Applicable ( "Text files not supported - Create as Out_File" ); raise Incomplete; end Test_for_Text_IO_Support; Operational_Test_Block: declare Default_Position : constant Text_IO.Positive_Count := 1; Section_Header : constant String := "IX. "; Glossary_Title : constant String := "GLOSSARY"; Glossary_Content : constant String := "TBD"; -- The following procedure simulates the addition of a Glossary page -- to an existing text file that has been reset with mode -- Append_File. procedure Position_Glossary_Text (The_File : in out Text_IO.File_Type) is use Text_IO; -- To provide visibility to the "/=" operator. begin -- Test control code. -- Verify initial page value. if (Text_IO.Page (The_File) /= Default_Position) then Report.Failed ("Incorrect default page number"); end if; -- Verify initial line number. if (Text_IO.Line (The_File) /= Default_Position) then Report.Failed ("Incorrect default line number"); end if; -- Verify initial column number. if (Text_IO.Col (The_File) /= Default_Position) then Report.Failed ("Incorrect default column number"); end if; -- Simulated usage code. Set new page/line positions. Text_IO.New_Page (The_File); Text_IO.New_Page (The_File); Text_IO.New_Line (File => The_File, Spacing => 1); -- Test control code. if (Integer(Text_IO.Page(The_File)) /= Report.Ident_Int(3)) or else (Integer(Text_IO.Line (The_File)) /= Report.Ident_Int(2)) then Report.Failed ("Incorrect results from page/line positioning"); end if; -- Simulated usage code. Position title of Glossary. Text_IO.Put (The_File, Section_Header); Text_IO.Put_Line (The_File, Glossary_Title); -- Set line to the current line. Text_IO.Set_Line (File => The_File, To => 3); -- Test control code. if (Integer(Text_IO.Page (The_File)) /= Report.Ident_Int(3)) or (Integer(Text_IO.Line (The_File)) /= Report.Ident_Int(3)) or (Integer(Text_IO.Col (The_File)) /= Report.Ident_Int(1)) then Report.Failed ("Set_Line failed for current line"); end if; -- Simulated usage code. Text_IO.Set_Line (File => The_File, To => 4); -- Set new Text_IO.Set_Col (File => The_File, To => 10); -- position. -- Test control code. if (Integer(Text_IO.Line (The_File)) /= Report.Ident_Int(4)) or (Integer(Text_IO.Col (The_File)) /= Report.Ident_Int(10)) then Report.Failed ("Incorrect results from line/column positioning"); end if; -- Simulated usage code. -- Position Text_IO.Put_Line (The_File, Glossary_Content); -- content of -- Glossary. end Position_Glossary_Text; begin -- In the scenario, data is added to the file here. Text_IO.Put_Line (File => Data_File, Item => "Some optional data"); -- This code section simulates a scenario that could occur in a -- text processing environment. Text is to be appended to an -- existing document: -- The file is reset to append mode. -- A procedure is called to perform the positioning and placement -- of text. -- The position on the appended page is set, verified, and text is -- placed in the file. -- -- Note: The text file has been originally created in Out_File -- mode, and has subsequently been reset to Append_File mode. Reset1: begin -- Reset has effect of calling New_Page. Text_IO.Reset (Data_File, Text_IO.Append_File); exception when Text_IO.Use_Error => Report.Not_Applicable ( "Reset to Append_File not supported for Text_IO" ); raise Incomplete; end Reset1; Position_Glossary_Text (The_File => Data_File); Test_Verification_Block: declare TC_Page, TC_Line, TC_Column : Text_IO.Positive_Count; TC_Position : Natural := 0; Blanks : constant String := " "; TC_String : String (1 .. 15) := Blanks; begin Reset2: begin Text_IO.Reset (Data_File, Text_IO.In_File); exception when Text_IO.Use_Error => Report.Not_Applicable ( "Reset to In_File not supported for Text_IO" ); raise Incomplete; end Reset2; Text_IO.Skip_Page (Data_File); Text_IO.Skip_Page (Data_File); -- If the Reset to Append_File mode actually put a page terminator -- on the file, as allowed (but not required) by RM A.10.2(4), then -- we are now on page 3, an empty page. We'll need to skip one more. if Text_IO.End_Of_Page (Data_File) then Text_IO.Skip_Page (Data_File); end if; -- Now we're on the Glossary page. -- Loop to the second line for I in 1 .. 2 loop -- and read the contents. Text_IO.Get_Line (Data_File, TC_String, TC_Position); end loop; if (TC_Position /= 13) or else -- Verify the title line. (TC_String (1..2) /= "IX") or else (TC_String (3..13) /= (". " & Glossary_Title)) then Report.Failed ("Incorrect positioning of title line"); end if; TC_String := Blanks; -- Clear string. -- Loop to the fourth line for I in 3 .. 4 loop -- and read the contents. Text_IO.Get_Line (Data_File, TC_String, TC_Position); end loop; if (TC_Position /= 12) or -- Verify the contents. (TC_String (8..12) /= " " & Glossary_Content) then Report.Failed ("Incorrect positioning of contents line"); end if; exception when Incomplete => raise; when others => Report.Failed ("Error raised during data verification"); end Test_Verification_Block; exception when Incomplete => raise; when others => Report.Failed ("Exception raised during Text_IO processing"); end Operational_Test_Block; Final_Block: begin -- Delete the external file. if Text_IO.Is_Open (Data_File) then Text_IO.Delete (Data_File); else Text_IO.Open (Data_File, Text_IO.In_File, Data_Filename); Text_IO.Delete (Data_File); end if; exception when others => Report.Failed ( "Delete not properly implemented for Text_IO" ); end Final_Block; Report.Result; exception when Incomplete => Report.Result; when others => Report.Failed ( "Unexpected exception" ); Report.Result; end CXAA003;