blob: 30b940535985e79bb265902cccc6f6ad18e72530 [file] [log] [blame]
-- CXB3005.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 procedure To_C converts the character elements of
-- a string parameter into char elements of the char_array parameter
-- Target, with nul termination if parameter Append_Nul is true.
--
-- Check that the out parameter Count of procedure To_C is set to the
-- appropriate value for both the nul/no nul terminated cases.
--
-- Check that Constraint_Error is propagated by procedure To_C if the
-- length of the char_array parameter Target is not sufficient to
-- hold the converted string value.
--
-- Check that the Procedure To_Ada converts char elements of the
-- char_array parameter Item to the corresponding character elements
-- of string out parameter Target.
--
-- Check that Constraint_Error is propagated by Procedure To_Ada if the
-- length of string parameter Target is not long enough to hold the
-- converted char_array value.
--
-- Check that Terminator_Error is propagated by Procedure To_Ada if the
-- parameter Trim_Nul is set to True, but the actual Item parameter
-- contains no nul char.
--
-- TEST DESCRIPTION:
-- This test uses a variety of String, and char_array objects to test
-- versions of the To_C and To_Ada procedures.
--
-- 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. If an implementation provides
-- package Interfaces.C, this test must compile, execute, and
-- report "PASSED".
--
-- CHANGE HISTORY:
-- 01 Sep 95 SAIC Initial prerelease version.
-- 09 May 96 SAIC Incorporated reviewer comments for ACVC 2.1.
-- 26 Oct 96 SAIC Incorporated reviewer comments.
-- 14 Sep 99 RLB Removed incorrect and unnecessary
-- Unchecked_Conversion.
--
--!
with Report;
with Interfaces.C; -- N/A => ERROR
with Ada.Characters.Latin_1;
with Ada.Exceptions;
with Ada.Strings.Fixed;
procedure CXB3005 is
begin
Report.Test ("CXB3005", "Check that the procedures To_C and To_Ada " &
"produce correct results");
Test_Block:
declare
use Interfaces, Interfaces.C;
use Ada.Characters;
use Ada.Exceptions;
use Ada.Strings.Fixed;
TC_Short_String : String(1..4) := (others => 'x');
TC_String : String(1..8) := (others => 'y');
TC_char_array : char_array(0..7) := (others => char'Last);
TC_size_t_Count : size_t := size_t'First;
TC_Natural_Count : Natural := Natural'First;
-- We can use the character forms of To_Ada and To_C here to check
-- the results; they were tested in CXB3004. We give them different
-- names to avoid confusion below.
function Character_to_char (Source : in Character) return char
renames To_C;
function char_to_Character (Source : in char) return Character
renames To_Ada;
begin
-- Check that the procedure To_C converts the character elements of
-- a string parameter into char elements of char_array out parameter
-- Target.
--
-- Case of nul termination.
TC_String(1..6) := "abcdef";
To_C (Item => TC_String(1..6), -- Source slice of length 6.
Target => TC_char_array, -- Length 8 will accommodate nul.
Count => TC_size_t_Count,
Append_Nul => True);
-- Check that the out parameter Count is set to the appropriate value
-- for the nul terminated case.
if TC_size_t_Count /= 7 then
Report.Failed("Incorrect setting of out parameter Count by " &
"Procedure To_C when Append_Nul => True");
end if;
for i in 1..TC_size_t_Count-1 loop
if char_to_Character(TC_char_array(i-1)) /= TC_String(Integer(i))
then
Report.Failed("Incorrect result from Procedure To_C when " &
"checking individual char values, case of " &
"Append_Nul => True; " &
"char position = " & Integer'Image(Integer(i)));
end if;
end loop;
if not Is_Nul_Terminated(TC_char_array) then
Report.Failed("No nul char appended to the char_array result " &
"from Procedure To_C when Append_Nul => True");
end if;
if TC_char_array(0..6) /= To_C("abcdef", True) then
Report.Failed("Incorrect result from Procedure To_C when " &
"directly comparing char_array results, case " &
"of Append_Nul => True");
end if;
-- Check Procedure To_C with no nul termination.
TC_char_array := (others => Character_to_char('M')); -- Reinitialize.
TC_String(1..4) := "WXYZ";
To_C (Item => TC_String(1..4), -- Source slice of length 4.
Target => TC_char_array,
Count => TC_size_t_Count,
Append_Nul => False);
-- Check that the out parameter Count is set to the appropriate value
-- for the non-nul terminated case.
if TC_size_t_Count /= 4 then
Report.Failed("Incorrect setting of out parameter Count by " &
"Procedure To_C when Append_Nul => False");
end if;
for i in 1..TC_size_t_Count loop
if char_to_Character(TC_char_array(i-1)) /= TC_String(Integer(i))
then
Report.Failed("Incorrect result from Procedure To_C when " &
"checking individual char values, case of " &
"Append_Nul => False; " &
"char position = " & Integer'Image(Integer(i)));
end if;
end loop;
if Is_Nul_Terminated(TC_char_array) then
Report.Failed("The nul char was appended to the char_array " &
"result of Procedure To_C when Append_Nul => False");
end if;
if TC_char_array(0..3) /= To_C("WXYZ", False) then
Report.Failed("Incorrect result from Procedure To_C when " &
"directly comparing char_array results, case " &
"of Append_Nul => False");
end if;
-- Check that Constraint_Error is raised by procedure To_C if the
-- length of the target char_array parameter is not sufficient to
-- hold the converted string value (plus nul if Append_Nul is True).
begin
To_C("A string too long",
TC_char_array,
TC_size_t_Count,
Append_Nul => True);
Report.Failed("Constraint_Error not raised when the Target " &
"parameter of Procedure To_C is not long enough " &
"to hold the converted string");
Report.Comment(char_to_Character(TC_char_array(0)) &
" printed to defeat optimization");
exception
when Constraint_Error => null; -- OK, expected exception.
when others =>
Report.Failed("Incorrect exception raised by Procedure " &
"To_C when the Target parameter is not long " &
"enough to contain the char_array result");
end;
-- Check that the procedure To_Ada converts char elements of the
-- char_array parameter Item to the corresponding character elements
-- of string out parameter Target, with result string length based on
-- the Trim_Nul parameter.
--
-- Case of appended nul char on the char_array In parameter.
TC_char_array := To_C ("ACVC-95", Append_Nul => True); -- 8 total chars.
TC_String := (others => '*'); -- Reinitialize.
To_Ada (Item => TC_char_array,
Target => TC_String,
Count => TC_Natural_Count,
Trim_Nul => False);
if TC_Natural_Count /= 8 then
Report.Failed("Incorrect value returned in out parameter Count " &
"by Procedure To_Ada, case of Trim_Nul => False");
end if;
for i in 1..TC_Natural_Count loop
if Character_to_char(TC_String(i)) /= TC_char_array(size_t(i-1))
then
Report.Failed("Incorrect result from Procedure To_Ada when " &
"checking individual char values, case of " &
"Trim_Nul => False, when a nul is present in " &
"the char_array input parameter; " &
"position = " & Integer'Image(Integer(i)));
end if;
end loop;
if TC_String(TC_Natural_Count) /= Latin_1.Nul then
Report.Failed("Last character of String result of Procedure " &
"To_Ada is not Nul, even though a nul was present " &
"in the char_array argument, and the Trim_Nul " &
"parameter was set to False");
end if;
TC_char_array(0..3) := To_C ("XYz", Append_Nul => True); -- 4 chars.
TC_String := (others => '*'); -- Reinit.
To_Ada (Item => TC_char_array,
Target => TC_String,
Count => TC_Natural_Count,
Trim_Nul => True);
if TC_Natural_Count /= 3 then
Report.Failed("Incorrect value returned in out parameter Count " &
"by Procedure To_Ada, case of Trim_Nul => True");
end if;
for i in 1..TC_Natural_Count loop
if Character_to_char(TC_String(i)) /= TC_char_array(size_t(i-1))
then
Report.Failed("Incorrect result from Procedure To_Ada when " &
"checking individual char values, case of " &
"Trim_Nul => True, when a nul is present in " &
"the char_array input parameter; " &
"position = " & Integer'Image(Integer(i)));
end if;
end loop;
if TC_String(TC_Natural_Count) = Latin_1.Nul then
Report.Failed("Last character of String result of Procedure " &
"To_Ada is Nul, even though the Trim_Nul " &
"parameter was set to True");
end if;
-- Check that TC_String(TC_Natural_Count+1) is unchanged by procedure
-- To_Ada.
if TC_String(TC_Natural_Count+1) /= '*' then
Report.Failed("Incorrect modification to TC_String at position " &
Integer'Image(TC_Natural_Count+1) & " expected = " &
"*, found = " & TC_String(TC_Natural_Count+1));
end if;
-- Case of no nul char being present in the char_array argument.
TC_char_array := To_C ("ABCDWXYZ", Append_Nul => False);
TC_String := (others => '*'); -- Reinitialize.
To_Ada (Item => TC_char_array,
Target => TC_String,
Count => TC_Natural_Count,
Trim_Nul => False);
if TC_Natural_Count /= 8 then
Report.Failed("Incorrect value returned in out parameter Count " &
"by Procedure To_Ada, case of Trim_Nul => False, " &
"with no nul char present in the parameter Item");
end if;
for i in 1..TC_Natural_Count loop
if Character_to_char(TC_String(i)) /= TC_char_array(size_t(i-1))
then
Report.Failed("Incorrect result from Procedure To_Ada when " &
"checking individual char values, case of " &
"Trim_Nul => False, when a nul is not present " &
"in the char_array input parameter; " &
"position = " & Integer'Image(Integer(i)));
end if;
end loop;
if TC_String(TC_Natural_Count) = Latin_1.Nul then
Report.Failed("Last character of String result of Procedure " &
"To_Ada is Nul, even though the nul char was " &
"not present in the parameter Item, with the " &
"parameter Trim_Nul => False");
end if;
-- Check that the Procedure To_Ada raises Terminator_Error if the
-- parameter Trim_Nul is set to True, but the actual Item parameter
-- does not contain the nul char.
begin
TC_char_array := To_C ("ABCDWXYZ", Append_Nul => False);
TC_String := (others => '*');
To_Ada(TC_char_array,
TC_String,
Count => TC_Natural_Count,
Trim_Nul => True);
Report.Failed("Terminator_Error not raised when Item " &
"parameter of To_Ada does not contain the " &
"nul char, but parameter Trim_Nul => True");
Report.Comment(TC_String & " printed to defeat optimization");
exception
when Terminator_Error => null; -- OK, expected exception.
when others =>
Report.Failed("Incorrect exception raised by Procedure " &
"To_Ada when the Item parameter does not " &
"contain the nul char, but parameter " &
"Trim_Nul => True");
end;
-- Check that Constraint_Error is propagated by procedure To_Ada if the
-- length of string parameter Target is not long enough to hold the
-- converted char_array value (plus nul if Trim_Nul is False).
begin
TC_char_array(0..4) := To_C ("ABCD", Append_Nul => True);
To_Ada(TC_char_array(0..4), -- 4 chars plus nul char.
TC_Short_String, -- Length of 4.
Count => TC_Natural_Count,
Trim_Nul => False);
Report.Failed("Constraint_Error not raised when string " &
"parameter Target of Procedure To_Ada is not " &
"long enough to hold the converted chars");
Report.Comment(TC_Short_String & " printed to defeat optimization");
exception
when Constraint_Error => null; -- OK, expected exception.
when others =>
Report.Failed("Incorrect exception raised by Procedure " &
"To_Ada when string parameter Target is " &
"not long enough to hold the converted chars");
end;
exception
when The_Error : others =>
Report.Failed ("The following exception was raised in the " &
"Test_Block: " & Exception_Name(The_Error));
end Test_Block;
Report.Result;
end CXB3005;