Ada Programming/Libraries/Ada.Strings.UTF_Encoding.Conversions

Computing » Computer Science » Computer Programming » Ada Programming

---

This language feature has been introduced in Ada 2012.

Ada.Strings.UTF_Encoding.Conversions is a unit of the Predefined Language Environment since Ada 2012.

Specification

--                     Standard Ada library specification
--   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.UTF_Encoding.Conversions is
   pragma Pure (Conversions);

   --  Conversions between various encoding schemes
   function Convert (Item          : UTF_String;
                     Input_Scheme  : Encoding_Scheme;
                     Output_Scheme : Encoding_Scheme;
                     Output_BOM    : Boolean := False) return UTF_String;

   function Convert (Item          : UTF_String;
                     Input_Scheme  : Encoding_Scheme;
                     Output_BOM    : Boolean := False)
      return UTF_16_Wide_String;

   function Convert (Item          : UTF_8_String;
                     Output_BOM    : Boolean := False)
      return UTF_16_Wide_String;

   function Convert (Item          : UTF_16_Wide_String;
                     Output_Scheme : Encoding_Scheme;
                     Output_BOM    : Boolean := False) return UTF_String;

   function Convert (Item          : UTF_16_Wide_String;
                     Output_BOM    : Boolean := False) return UTF_8_String;

end Ada.Strings.UTF_Encoding.Conversions;

See also

Wikibook

• Ada Programming/Libraries/Ada
• Ada Programming/Libraries/Ada.Strings
• Ada Programming/Libraries/Ada.Strings.UTF_Encoding

External examples

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

Ada Reference Manual

Ada 2012

• A.4.11: String Encoding ^[Annotated]

Open-Source Implementations

FSF GNAT

• Specification: a-suenco.ads
• Body: a-suenco.adb

drake

• Specification: strings/a-suenco.ads
• Body: strings/a-suenco.adb