-- CXB3011.A
|
-- CXB3011.A
|
--
|
--
|
-- Grant of Unlimited Rights
|
-- Grant of Unlimited Rights
|
--
|
--
|
-- Under contracts F33600-87-D-0337, F33600-84-D-0280, MDA903-79-C-0687,
|
-- 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
|
-- 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 in the software and documentation contained herein.
|
-- Unlimited rights are defined in DFAR 252.227-7013(a)(19). By making
|
-- Unlimited rights are defined in DFAR 252.227-7013(a)(19). By making
|
-- this public release, the Government intends to confer upon all
|
-- this public release, the Government intends to confer upon all
|
-- recipients unlimited rights equal to those held by the Government.
|
-- recipients unlimited rights equal to those held by the Government.
|
-- These rights include rights to use, duplicate, release or disclose the
|
-- These rights include rights to use, duplicate, release or disclose the
|
-- released technical data and computer software in whole or in part, in
|
-- 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
|
-- any manner and for any purpose whatsoever, and to have or permit others
|
-- to do so.
|
-- to do so.
|
--
|
--
|
-- DISCLAIMER
|
-- DISCLAIMER
|
--
|
--
|
-- ALL MATERIALS OR INFORMATION HEREIN RELEASED, MADE AVAILABLE OR
|
-- ALL MATERIALS OR INFORMATION HEREIN RELEASED, MADE AVAILABLE OR
|
-- DISCLOSED ARE AS IS. THE GOVERNMENT MAKES NO EXPRESS OR IMPLIED
|
-- DISCLOSED ARE AS IS. THE GOVERNMENT MAKES NO EXPRESS OR IMPLIED
|
-- WARRANTY AS TO ANY MATTER WHATSOEVER, INCLUDING THE CONDITIONS OF THE
|
-- WARRANTY AS TO ANY MATTER WHATSOEVER, INCLUDING THE CONDITIONS OF THE
|
-- SOFTWARE, DOCUMENTATION OR OTHER INFORMATION RELEASED, MADE AVAILABLE
|
-- SOFTWARE, DOCUMENTATION OR OTHER INFORMATION RELEASED, MADE AVAILABLE
|
-- OR DISCLOSED, OR THE OWNERSHIP, MERCHANTABILITY, OR FITNESS FOR A
|
-- OR DISCLOSED, OR THE OWNERSHIP, MERCHANTABILITY, OR FITNESS FOR A
|
-- PARTICULAR PURPOSE OF SAID MATERIAL.
|
-- PARTICULAR PURPOSE OF SAID MATERIAL.
|
--*
|
--*
|
--
|
--
|
-- OBJECTIVE:
|
-- OBJECTIVE:
|
-- Check that the version of Function Value with a chars_ptr parameter
|
-- Check that the version of Function Value with a chars_ptr parameter
|
-- that returns a String result returns an Ada string containing the
|
-- that returns a String result returns an Ada string containing the
|
-- characters pointed to by the chars_ptr parameter, up to (but not
|
-- characters pointed to by the chars_ptr parameter, up to (but not
|
-- including) the terminating nul.
|
-- including) the terminating nul.
|
--
|
--
|
-- Check that the version of Function Value with a chars_ptr parameter
|
-- Check that the version of Function Value with a chars_ptr parameter
|
-- and a size_t parameter that returns a String result returns the
|
-- and a size_t parameter that returns a String result returns the
|
-- shorter of:
|
-- shorter of:
|
-- 1) a String of the first size_t number of characters, or
|
-- 1) a String of the first size_t number of characters, or
|
-- 2) a String of characters up to (but not including) the
|
-- 2) a String of characters up to (but not including) the
|
-- terminating nul.
|
-- terminating nul.
|
--
|
--
|
-- Check that the Function Strlen returns a size_t result that
|
-- Check that the Function Strlen returns a size_t result that
|
-- corresponds to the number of chars in the array pointed to by Item,
|
-- corresponds to the number of chars in the array pointed to by Item,
|
-- up to but not including the terminating nul.
|
-- up to but not including the terminating nul.
|
--
|
--
|
-- Check that both of the above versions of Function Value and
|
-- Check that both of the above versions of Function Value and
|
-- Function Strlen propagate Dereference_Error if the Item parameter
|
-- Function Strlen propagate Dereference_Error if the Item parameter
|
-- is Null_Ptr.
|
-- is Null_Ptr.
|
--
|
--
|
-- TEST DESCRIPTION:
|
-- TEST DESCRIPTION:
|
-- This test validates two versions of Function Value, and the Function
|
-- This test validates two versions of Function Value, and the Function
|
-- Strlen. A series of char_ptr values are provided as input, and
|
-- Strlen. A series of char_ptr values are provided as input, and
|
-- results are compared for length or content.
|
-- results are compared for length or content.
|
--
|
--
|
-- This test assumes that the following characters are all included
|
-- This test assumes that the following characters are all included
|
-- in the implementation defined type Interfaces.C.char:
|
-- in the implementation defined type Interfaces.C.char:
|
-- ' ', 'a'..'z', 'A'..'Z', '0'..'9', '*' and '.'.
|
-- ' ', 'a'..'z', 'A'..'Z', '0'..'9', '*' and '.'.
|
--
|
--
|
-- APPLICABILITY CRITERIA:
|
-- APPLICABILITY CRITERIA:
|
-- This test is applicable to all implementations that provide
|
-- This test is applicable to all implementations that provide
|
-- package Interfaces.C.Strings. If an implementation provides
|
-- package Interfaces.C.Strings. If an implementation provides
|
-- package Interfaces.C.Strings, this test must compile, execute,
|
-- package Interfaces.C.Strings, this test must compile, execute,
|
-- and report "PASSED".
|
-- and report "PASSED".
|
--
|
--
|
--
|
--
|
-- CHANGE HISTORY:
|
-- CHANGE HISTORY:
|
-- 28 Sep 95 SAIC Initial prerelease version.
|
-- 28 Sep 95 SAIC Initial prerelease version.
|
-- 13 May 96 SAIC Incorporated reviewer comments for ACVC 2.1.
|
-- 13 May 96 SAIC Incorporated reviewer comments for ACVC 2.1.
|
-- 26 Oct 96 SAIC Incorporated reviewer comments.
|
-- 26 Oct 96 SAIC Incorporated reviewer comments.
|
--
|
--
|
--!
|
--!
|
|
|
with Report;
|
with Report;
|
with Ada.Characters.Latin_1;
|
with Ada.Characters.Latin_1;
|
with Interfaces.C.Strings; -- N/A => ERROR
|
with Interfaces.C.Strings; -- N/A => ERROR
|
|
|
procedure CXB3011 is
|
procedure CXB3011 is
|
begin
|
begin
|
|
|
Report.Test ("CXB3011", "Check that the two versions of Function Value " &
|
Report.Test ("CXB3011", "Check that the two versions of Function Value " &
|
"returning a String result, and the Function " &
|
"returning a String result, and the Function " &
|
"Strlen, produce correct results");
|
"Strlen, produce correct results");
|
|
|
Test_Block:
|
Test_Block:
|
declare
|
declare
|
|
|
package IC renames Interfaces.C;
|
package IC renames Interfaces.C;
|
package ICS renames Interfaces.C.Strings;
|
package ICS renames Interfaces.C.Strings;
|
package ACL1 renames Ada.Characters.Latin_1;
|
package ACL1 renames Ada.Characters.Latin_1;
|
|
|
use type IC.char_array;
|
use type IC.char_array;
|
use type IC.size_t;
|
use type IC.size_t;
|
use type ICS.chars_ptr;
|
use type ICS.chars_ptr;
|
|
|
Null_Char_Array_Access : constant ICS.char_array_access := null;
|
Null_Char_Array_Access : constant ICS.char_array_access := null;
|
|
|
TC_String : String(1..5) := (others => 'X');
|
TC_String : String(1..5) := (others => 'X');
|
TC_String_1 : constant String := "*.3*0";
|
TC_String_1 : constant String := "*.3*0";
|
TC_String_2 : constant String := "Two";
|
TC_String_2 : constant String := "Two";
|
TC_String_3 : constant String := "Five5";
|
TC_String_3 : constant String := "Five5";
|
TC_Blank_String : constant String(1..5) := (others => ' ');
|
TC_Blank_String : constant String(1..5) := (others => ' ');
|
|
|
TC_char_array : IC.char_array :=
|
TC_char_array : IC.char_array :=
|
IC.To_C(TC_Blank_String, True);
|
IC.To_C(TC_Blank_String, True);
|
TC_char_array_1 : constant IC.char_array :=
|
TC_char_array_1 : constant IC.char_array :=
|
IC.To_C(TC_String_1, True);
|
IC.To_C(TC_String_1, True);
|
TC_char_array_2 : constant IC.char_array :=
|
TC_char_array_2 : constant IC.char_array :=
|
IC.To_C(TC_String_2, True);
|
IC.To_C(TC_String_2, True);
|
TC_char_array_3 : constant IC.char_array :=
|
TC_char_array_3 : constant IC.char_array :=
|
IC.To_C(TC_String_3, True);
|
IC.To_C(TC_String_3, True);
|
TC_Blank_char_array : constant IC.char_array :=
|
TC_Blank_char_array : constant IC.char_array :=
|
IC.To_C(TC_Blank_String, True);
|
IC.To_C(TC_Blank_String, True);
|
|
|
TC_chars_ptr : ICS.chars_ptr :=
|
TC_chars_ptr : ICS.chars_ptr :=
|
ICS.New_Char_Array(TC_Blank_char_array);
|
ICS.New_Char_Array(TC_Blank_char_array);
|
|
|
TC_size_t : IC.size_t := IC.size_t'First;
|
TC_size_t : IC.size_t := IC.size_t'First;
|
|
|
|
|
begin
|
begin
|
|
|
-- Check that the version of Function Value with a chars_ptr parameter
|
-- Check that the version of Function Value with a chars_ptr parameter
|
-- that returns a String result returns an Ada string containing the
|
-- that returns a String result returns an Ada string containing the
|
-- characters pointed to by the chars_ptr parameter, up to (but not
|
-- characters pointed to by the chars_ptr parameter, up to (but not
|
-- including) the terminating nul.
|
-- including) the terminating nul.
|
|
|
TC_chars_ptr := ICS.New_Char_Array(TC_char_array_1);
|
TC_chars_ptr := ICS.New_Char_Array(TC_char_array_1);
|
TC_String := ICS.Value(Item => TC_chars_ptr);
|
TC_String := ICS.Value(Item => TC_chars_ptr);
|
|
|
if TC_String /= TC_String_1 or
|
if TC_String /= TC_String_1 or
|
TC_String(TC_String'Last) = ACL1.NUL
|
TC_String(TC_String'Last) = ACL1.NUL
|
then
|
then
|
Report.Failed("Incorrect result from Function Value - 1");
|
Report.Failed("Incorrect result from Function Value - 1");
|
end if;
|
end if;
|
|
|
TC_chars_ptr := ICS.New_Char_Array(TC_char_array_2);
|
TC_chars_ptr := ICS.New_Char_Array(TC_char_array_2);
|
|
|
if ICS.Value(Item => TC_chars_ptr) /=
|
if ICS.Value(Item => TC_chars_ptr) /=
|
IC.To_Ada(ICS.Value(TC_chars_ptr), Trim_Nul => True)
|
IC.To_Ada(ICS.Value(TC_chars_ptr), Trim_Nul => True)
|
then
|
then
|
Report.Failed("Incorrect result from Function Value - 2");
|
Report.Failed("Incorrect result from Function Value - 2");
|
end if;
|
end if;
|
|
|
TC_chars_ptr := ICS.New_Char_Array(TC_char_array_3);
|
TC_chars_ptr := ICS.New_Char_Array(TC_char_array_3);
|
TC_String := ICS.Value(TC_chars_ptr);
|
TC_String := ICS.Value(TC_chars_ptr);
|
|
|
if TC_String /= TC_String_3 or
|
if TC_String /= TC_String_3 or
|
TC_String(TC_String'Last) = ACL1.NUL
|
TC_String(TC_String'Last) = ACL1.NUL
|
then
|
then
|
Report.Failed("Incorrect result from Function Value - 3");
|
Report.Failed("Incorrect result from Function Value - 3");
|
end if;
|
end if;
|
|
|
|
|
-- Check that the version of Function Value with a chars_ptr parameter
|
-- Check that the version of Function Value with a chars_ptr parameter
|
-- and a size_t parameter that returns a String result returns the
|
-- and a size_t parameter that returns a String result returns the
|
-- shorter of:
|
-- shorter of:
|
-- 1) a String of the first size_t number of characters, or
|
-- 1) a String of the first size_t number of characters, or
|
-- 2) a String of characters up to (but not including) the
|
-- 2) a String of characters up to (but not including) the
|
-- terminating nul.
|
-- terminating nul.
|
--
|
--
|
|
|
-- Case 1 : Length parameter specifies a length shorter than total
|
-- Case 1 : Length parameter specifies a length shorter than total
|
-- length.
|
-- length.
|
|
|
TC_chars_ptr := ICS.New_Char_Array(TC_char_array_1);
|
TC_chars_ptr := ICS.New_Char_Array(TC_char_array_1);
|
TC_String := "XXXXX"; -- Reinitialize all characters in string.
|
TC_String := "XXXXX"; -- Reinitialize all characters in string.
|
TC_String(1..5) := ICS.Value(Item => TC_chars_ptr, Length => 6);
|
TC_String(1..5) := ICS.Value(Item => TC_chars_ptr, Length => 6);
|
|
|
if TC_String(1..4) /= TC_String_1(1..4) or
|
if TC_String(1..4) /= TC_String_1(1..4) or
|
TC_String(TC_String'Last) = ACL1.NUL
|
TC_String(TC_String'Last) = ACL1.NUL
|
then
|
then
|
Report.Failed("Incorrect result from Function Value - 4");
|
Report.Failed("Incorrect result from Function Value - 4");
|
end if;
|
end if;
|
|
|
-- Case 2 : Length parameter specifies total length.
|
-- Case 2 : Length parameter specifies total length.
|
|
|
TC_chars_ptr := ICS.New_Char_Array(TC_char_array_2);
|
TC_chars_ptr := ICS.New_Char_Array(TC_char_array_2);
|
|
|
if ICS.Value(TC_chars_ptr, Length => 5) /=
|
if ICS.Value(TC_chars_ptr, Length => 5) /=
|
IC.To_Ada(ICS.Value(TC_chars_ptr), Trim_Nul => True)
|
IC.To_Ada(ICS.Value(TC_chars_ptr), Trim_Nul => True)
|
then
|
then
|
Report.Failed("Incorrect result from Function Value - 5");
|
Report.Failed("Incorrect result from Function Value - 5");
|
end if;
|
end if;
|
|
|
-- Case 3 : Length parameter specifies a length longer than total
|
-- Case 3 : Length parameter specifies a length longer than total
|
-- length.
|
-- length.
|
|
|
TC_chars_ptr := ICS.New_Char_Array(TC_char_array_3);
|
TC_chars_ptr := ICS.New_Char_Array(TC_char_array_3);
|
TC_String := "XXXXX"; -- Reinitialize all characters in string.
|
TC_String := "XXXXX"; -- Reinitialize all characters in string.
|
TC_String := ICS.Value(TC_chars_ptr, 7);
|
TC_String := ICS.Value(TC_chars_ptr, 7);
|
|
|
if TC_String /= TC_String_3 or
|
if TC_String /= TC_String_3 or
|
TC_String(TC_String'Last) = ACL1.NUL
|
TC_String(TC_String'Last) = ACL1.NUL
|
then
|
then
|
Report.Failed("Incorrect result from Function Value - 6");
|
Report.Failed("Incorrect result from Function Value - 6");
|
end if;
|
end if;
|
|
|
|
|
-- Check that the Function Strlen returns a size_t result that
|
-- Check that the Function Strlen returns a size_t result that
|
-- corresponds to the number of chars in the array pointed to by
|
-- corresponds to the number of chars in the array pointed to by
|
-- parameter Item, up to but not including the terminating nul.
|
-- 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_chars_ptr := ICS.New_Char_Array(IC.To_C("A longer string value"));
|
TC_size_t := ICS.Strlen(TC_chars_ptr);
|
TC_size_t := ICS.Strlen(TC_chars_ptr);
|
|
|
if TC_size_t /= 21 then
|
if TC_size_t /= 21 then
|
Report.Failed("Incorrect result from Function Strlen - 1");
|
Report.Failed("Incorrect result from Function Strlen - 1");
|
end if;
|
end if;
|
|
|
TC_chars_ptr := ICS.New_Char_Array(TC_char_array_2);
|
TC_chars_ptr := ICS.New_Char_Array(TC_char_array_2);
|
TC_size_t := ICS.Strlen(TC_chars_ptr);
|
TC_size_t := ICS.Strlen(TC_chars_ptr);
|
|
|
if TC_size_t /= 3 then -- Nul not included in length.
|
if TC_size_t /= 3 then -- Nul not included in length.
|
Report.Failed("Incorrect result from Function Strlen - 2");
|
Report.Failed("Incorrect result from Function Strlen - 2");
|
end if;
|
end if;
|
|
|
TC_chars_ptr := ICS.New_Char_Array(IC.To_C(""));
|
TC_chars_ptr := ICS.New_Char_Array(IC.To_C(""));
|
TC_size_t := ICS.Strlen(TC_chars_ptr);
|
TC_size_t := ICS.Strlen(TC_chars_ptr);
|
|
|
if TC_size_t /= 0 then
|
if TC_size_t /= 0 then
|
Report.Failed("Incorrect result from Function Strlen - 3");
|
Report.Failed("Incorrect result from Function Strlen - 3");
|
end if;
|
end if;
|
|
|
|
|
-- Check that both of the above versions of Function Value and
|
-- Check that both of the above versions of Function Value and
|
-- function Strlen propagate Dereference_Error if the Item parameter
|
-- function Strlen propagate Dereference_Error if the Item parameter
|
-- is Null_Ptr.
|
-- is Null_Ptr.
|
|
|
begin
|
begin
|
TC_chars_ptr := ICS.Null_Ptr;
|
TC_chars_ptr := ICS.Null_Ptr;
|
TC_String := ICS.Value(Item => TC_chars_ptr);
|
TC_String := ICS.Value(Item => TC_chars_ptr);
|
Report.Failed("Function Value (without Length parameter) did not " &
|
Report.Failed("Function Value (without Length parameter) did not " &
|
"raise Dereference_Error when provided a null Item " &
|
"raise Dereference_Error when provided a null Item " &
|
"parameter input value");
|
"parameter input value");
|
if TC_String(1) = '1' then -- Defeat optimization.
|
if TC_String(1) = '1' then -- Defeat optimization.
|
Report.Comment("Should never be printed");
|
Report.Comment("Should never be printed");
|
end if;
|
end if;
|
exception
|
exception
|
when ICS.Dereference_Error => null; -- OK, expected exception.
|
when ICS.Dereference_Error => null; -- OK, expected exception.
|
when others =>
|
when others =>
|
Report.Failed("Incorrect exception raised by Function Value " &
|
Report.Failed("Incorrect exception raised by Function Value " &
|
"with Item parameter, when the Item parameter " &
|
"with Item parameter, when the Item parameter " &
|
"is Null_Ptr");
|
"is Null_Ptr");
|
end;
|
end;
|
|
|
begin
|
begin
|
TC_chars_ptr := ICS.Null_Ptr;
|
TC_chars_ptr := ICS.Null_Ptr;
|
TC_String := ICS.Value(Item => TC_chars_ptr, Length => 4);
|
TC_String := ICS.Value(Item => TC_chars_ptr, Length => 4);
|
Report.Failed("Function Value (with Length parameter) did not " &
|
Report.Failed("Function Value (with Length parameter) did not " &
|
"raise Dereference_Error when provided a null Item " &
|
"raise Dereference_Error when provided a null Item " &
|
"parameter input value");
|
"parameter input value");
|
if TC_String(1) = '1' then -- Defeat optimization.
|
if TC_String(1) = '1' then -- Defeat optimization.
|
Report.Comment("Should never be printed");
|
Report.Comment("Should never be printed");
|
end if;
|
end if;
|
exception
|
exception
|
when ICS.Dereference_Error => null; -- OK, expected exception.
|
when ICS.Dereference_Error => null; -- OK, expected exception.
|
when others =>
|
when others =>
|
Report.Failed("Incorrect exception raised by Function Value " &
|
Report.Failed("Incorrect exception raised by Function Value " &
|
"with both Item and Length parameters, when " &
|
"with both Item and Length parameters, when " &
|
"the Item parameter is Null_Ptr");
|
"the Item parameter is Null_Ptr");
|
end;
|
end;
|
|
|
begin
|
begin
|
TC_chars_ptr := ICS.Null_Ptr;
|
TC_chars_ptr := ICS.Null_Ptr;
|
TC_size_t := ICS.Strlen(Item => TC_chars_ptr);
|
TC_size_t := ICS.Strlen(Item => TC_chars_ptr);
|
Report.Failed("Function Strlen did not raise Dereference_Error" &
|
Report.Failed("Function Strlen did not raise Dereference_Error" &
|
"when provided a null Item parameter input value");
|
"when provided a null Item parameter input value");
|
if TC_size_t = 35 then -- Defeat optimization.
|
if TC_size_t = 35 then -- Defeat optimization.
|
Report.Comment("Should never be printed");
|
Report.Comment("Should never be printed");
|
end if;
|
end if;
|
exception
|
exception
|
when ICS.Dereference_Error => null; -- OK, expected exception.
|
when ICS.Dereference_Error => null; -- OK, expected exception.
|
when others =>
|
when others =>
|
Report.Failed("Incorrect exception raised by Function Strlen " &
|
Report.Failed("Incorrect exception raised by Function Strlen " &
|
"when the Item parameter is Null_Ptr");
|
"when the Item parameter is Null_Ptr");
|
end;
|
end;
|
|
|
|
|
exception
|
exception
|
when others => Report.Failed ("Exception raised in Test_Block");
|
when others => Report.Failed ("Exception raised in Test_Block");
|
end Test_Block;
|
end Test_Block;
|
|
|
Report.Result;
|
Report.Result;
|
|
|
end CXB3011;
|
end CXB3011;
|
|
|