Subversion Repositories openrisc_me

-- 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;