-- CXB3011.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 version of Function Value with a chars_ptr parameter -- that returns a String result returns an Ada string containing the -- characters pointed to by the chars_ptr parameter, up to (but not -- including) the terminating nul. -- -- Check that the version of Function Value with a chars_ptr parameter -- and a size_t parameter that returns a String result returns the -- shorter of: -- 1) a String of the first size_t number of characters, or -- 2) a String of characters up to (but not including) the -- terminating nul. -- -- Check that the Function Strlen returns a size_t result that -- corresponds to the number of chars in the array pointed to by Item, -- up to but not including the terminating nul. -- -- Check that both of the above versions of Function Value and -- Function Strlen propagate Dereference_Error if the Item parameter -- is Null_Ptr. -- -- TEST DESCRIPTION: -- This test validates two versions of Function Value, and the Function -- Strlen. A series of char_ptr values are provided as input, and -- results are compared for length or content. -- -- This test assumes that the following characters are all included -- in the implementation defined type Interfaces.C.char: -- ' ', 'a'..'z', 'A'..'Z', '0'..'9', '*' and '.'. -- -- APPLICABILITY CRITERIA: -- This test is applicable to all implementations that provide -- package Interfaces.C.Strings. If an implementation provides -- package Interfaces.C.Strings, this test must compile, execute, -- and report "PASSED". -- -- -- CHANGE HISTORY: -- 28 Sep 95 SAIC Initial prerelease version. -- 13 May 96 SAIC Incorporated reviewer comments for ACVC 2.1. -- 26 Oct 96 SAIC Incorporated reviewer comments. -- --! with Report; with Ada.Characters.Latin_1; with Interfaces.C.Strings; -- N/A => ERROR procedure CXB3011 is begin Report.Test ("CXB3011", "Check that the two versions of Function Value " & "returning a String result, and the Function " & "Strlen, produce correct results"); Test_Block: declare package IC renames Interfaces.C; package ICS renames Interfaces.C.Strings; package ACL1 renames Ada.Characters.Latin_1; use type IC.char_array; use type IC.size_t; use type ICS.chars_ptr; Null_Char_Array_Access : constant ICS.char_array_access := null; TC_String : String(1..5) := (others => 'X'); TC_String_1 : constant String := "*.3*0"; TC_String_2 : constant String := "Two"; TC_String_3 : constant String := "Five5"; TC_Blank_String : constant String(1..5) := (others => ' '); TC_char_array : IC.char_array := IC.To_C(TC_Blank_String, True); TC_char_array_1 : constant IC.char_array := IC.To_C(TC_String_1, True); TC_char_array_2 : constant IC.char_array := IC.To_C(TC_String_2, True); TC_char_array_3 : constant IC.char_array := IC.To_C(TC_String_3, True); TC_Blank_char_array : constant IC.char_array := IC.To_C(TC_Blank_String, True); TC_chars_ptr : ICS.chars_ptr := ICS.New_Char_Array(TC_Blank_char_array); TC_size_t : IC.size_t := IC.size_t'First; begin -- Check that the version of Function Value with a chars_ptr parameter -- that returns a String result returns an Ada string containing the -- characters pointed to by the chars_ptr parameter, up to (but not -- including) the terminating nul. TC_chars_ptr := ICS.New_Char_Array(TC_char_array_1); TC_String := ICS.Value(Item => TC_chars_ptr); if TC_String /= TC_String_1 or TC_String(TC_String'Last) = ACL1.NUL then Report.Failed("Incorrect result from Function Value - 1"); end if; TC_chars_ptr := ICS.New_Char_Array(TC_char_array_2); if ICS.Value(Item => TC_chars_ptr) /= IC.To_Ada(ICS.Value(TC_chars_ptr), Trim_Nul => True) then Report.Failed("Incorrect result from Function Value - 2"); end if; TC_chars_ptr := ICS.New_Char_Array(TC_char_array_3); TC_String := ICS.Value(TC_chars_ptr); if TC_String /= TC_String_3 or TC_String(TC_String'Last) = ACL1.NUL then Report.Failed("Incorrect result from Function Value - 3"); end if; -- Check that the version of Function Value with a chars_ptr parameter -- and a size_t parameter that returns a String result returns the -- shorter of: -- 1) a String of the first size_t number of characters, or -- 2) a String of characters up to (but not including) the -- terminating nul. -- -- Case 1 : Length parameter specifies a length shorter than total -- length. TC_chars_ptr := ICS.New_Char_Array(TC_char_array_1); TC_String := "XXXXX"; -- Reinitialize all characters in string. TC_String(1..5) := ICS.Value(Item => TC_chars_ptr, Length => 6); if TC_String(1..4) /= TC_String_1(1..4) or TC_String(TC_String'Last) = ACL1.NUL then Report.Failed("Incorrect result from Function Value - 4"); end if; -- Case 2 : Length parameter specifies total length. TC_chars_ptr := ICS.New_Char_Array(TC_char_array_2); if ICS.Value(TC_chars_ptr, Length => 5) /= IC.To_Ada(ICS.Value(TC_chars_ptr), Trim_Nul => True) then Report.Failed("Incorrect result from Function Value - 5"); end if; -- Case 3 : Length parameter specifies a length longer than total -- length. TC_chars_ptr := ICS.New_Char_Array(TC_char_array_3); TC_String := "XXXXX"; -- Reinitialize all characters in string. TC_String := ICS.Value(TC_chars_ptr, 7); if TC_String /= TC_String_3 or TC_String(TC_String'Last) = ACL1.NUL then Report.Failed("Incorrect result from Function Value - 6"); end if; -- Check that the Function Strlen returns a size_t result that -- corresponds to the number of chars in the array pointed to by -- parameter Item, up to but not including the terminating nul. TC_chars_ptr := ICS.New_Char_Array(IC.To_C("A longer string value")); TC_size_t := ICS.Strlen(TC_chars_ptr); if TC_size_t /= 21 then Report.Failed("Incorrect result from Function Strlen - 1"); end if; TC_chars_ptr := ICS.New_Char_Array(TC_char_array_2); TC_size_t := ICS.Strlen(TC_chars_ptr); if TC_size_t /= 3 then -- Nul not included in length. Report.Failed("Incorrect result from Function Strlen - 2"); end if; TC_chars_ptr := ICS.New_Char_Array(IC.To_C("")); TC_size_t := ICS.Strlen(TC_chars_ptr); if TC_size_t /= 0 then Report.Failed("Incorrect result from Function Strlen - 3"); end if; -- Check that both of the above versions of Function Value and -- function Strlen propagate Dereference_Error if the Item parameter -- is Null_Ptr. begin TC_chars_ptr := ICS.Null_Ptr; TC_String := ICS.Value(Item => TC_chars_ptr); Report.Failed("Function Value (without Length parameter) did not " & "raise Dereference_Error when provided a null Item " & "parameter input value"); if TC_String(1) = '1' then -- Defeat optimization. Report.Comment("Should never be printed"); end if; exception when ICS.Dereference_Error => null; -- OK, expected exception. when others => Report.Failed("Incorrect exception raised by Function Value " & "with Item parameter, when the Item parameter " & "is Null_Ptr"); end; begin TC_chars_ptr := ICS.Null_Ptr; TC_String := ICS.Value(Item => TC_chars_ptr, Length => 4); Report.Failed("Function Value (with Length parameter) did not " & "raise Dereference_Error when provided a null Item " & "parameter input value"); if TC_String(1) = '1' then -- Defeat optimization. Report.Comment("Should never be printed"); end if; exception when ICS.Dereference_Error => null; -- OK, expected exception. when others => Report.Failed("Incorrect exception raised by Function Value " & "with both Item and Length parameters, when " & "the Item parameter is Null_Ptr"); end; begin TC_chars_ptr := ICS.Null_Ptr; TC_size_t := ICS.Strlen(Item => TC_chars_ptr); Report.Failed("Function Strlen did not raise Dereference_Error" & "when provided a null Item parameter input value"); if TC_size_t = 35 then -- Defeat optimization. Report.Comment("Should never be printed"); end if; exception when ICS.Dereference_Error => null; -- OK, expected exception. when others => Report.Failed("Incorrect exception raised by Function Strlen " & "when the Item parameter is Null_Ptr"); end; exception when others => Report.Failed ("Exception raised in Test_Block"); end Test_Block; Report.Result; end CXB3011;