Ada Programming/Libraries/Ada.Strings

Computing » Computer Science » Computer Programming » Ada Programming

---

This language feature is available from Ada 95 on.

Ada.Strings is a unit of the Predefined Language Environment since Ada 95.

This package is the base package for all string packages. It defines common exceptions and constants.

These child packages are:

• Ada.Strings.Bounded
• Ada.Strings.Bounded.Hash (Ada 2005 generic function)
• Ada.Strings.Fixed
• Ada.Strings.Fixed.Hash (Ada 2005 generic function)
• Ada.Strings.Hash (Ada 2005 generic function)
• Ada.Strings.Maps
• Ada.Strings.Maps.Constants
• Ada.Strings.Unbounded
• Ada.Strings.Unbounded.Hash (Ada 2005 generic function)
• Ada.Strings.Wide_Bounded
• Ada.Strings.Wide_Bounded.Wide_Hash (Ada 2005 generic function)
• Ada.Strings.Wide_Fixed
• Ada.Strings.Wide_Fixed.Wide_Hash (Ada 2005 generic function)
• Ada.Strings.Wide_Hash (Ada 2005 generic function)
• Ada.Strings.Wide_Maps
• Ada.Strings.Wide_Maps.Wide_Constants
• Ada.Strings.Wide_Unbounded
• Ada.Strings.Wide_Unbounded.Wide_Hash (Ada 2005 generic function)
• Ada.Strings.Wide_Wide_Bounded (Ada 2005)
• Ada.Strings.Wide_Wide_Bounded.Wide_Wide_Hash (Ada 2005 generic function)
• Ada.Strings.Wide_Wide_Fixed (Ada 2005)
• Ada.Strings.Wide_Wide_Fixed.Wide_Wide_Hash (Ada 2005 generic function)
• Ada.Strings.Wide_Wide_Hash (Ada 2005 generic function)
• Ada.Strings.Wide_Wide_Maps (Ada 2005)
• Ada.Strings.Wide_Wide_Maps.Wide_Wide_Constants (Ada 2005)
• Ada.Strings.Wide_Wide_Unbounded (Ada 2005)
• Ada.Strings.Wide_Wide_Unbounded.Wide_Wide_Hash (Ada 2005 generic function)

Specification

--                     Standard Ada library specification
--   Copyright (c) 2003-2018 Maxim Reznik <reznikmm@gmail.com>
--   Copyright (c) 2004-2016 AXE Consultants
--   Copyright (c) 2004, 2005, 2006 Ada-Europe
--   Copyright (c) 2000 The MITRE Corporation, Inc.
--   Copyright (c) 1992, 1993, 1994, 1995 Intermetrics, Inc.
--   SPDX-License-Identifier: BSD-3-Clause and LicenseRef-AdaReferenceManual
-- -------------------------------------------------------------------------

package Ada.Strings is
   pragma Pure (Strings);

   Space           : constant Character      := ' ';
   Wide_Space      : constant Wide_Character := ' ';
   Wide_Wide_Space : constant Wide_Wide_Character := ' ';

   Length_Error, Pattern_Error, Index_Error, Translation_Error
     : exception;

   type Alignment  is (Left, Right, Center);
   type Truncation is (Left, Right, Error);
   type Membership is (Inside, Outside);
   type Direction  is (Forward, Backward);
   type Trim_End   is (Left, Right, Both);

end Ada.Strings;

See also

Wikibook

• Ada Programming/Libraries/Ada
• Ada Programming/Strings

External examples

• Search for examples of Ada.Strings in: Rosetta Code, GitHub (gists), any Alire crate or this Wikibook.
• Search for posts related to Ada.Strings in: Stack Overflow, comp.lang.ada or any Ada related page.

Ada Reference Manual

Ada 95

• A.4.1: The Package Strings ^[Annotated]

Ada 2005

• A.4.1: The Package Strings ^[Annotated]

Ada 2012

• A.4.1: The Package Strings ^[Annotated]

Open-Source Implementations

FSF GNAT

• Specification: a-string.ads

drake

• Specification: strings/a-string.ads