mirror of
https://github.com/autc04/Retro68.git
synced 2024-09-27 12:57:21 +00:00
136 lines
6.4 KiB
Ada
136 lines
6.4 KiB
Ada
------------------------------------------------------------------------------
|
|
-- --
|
|
-- GNAT COMPILER COMPONENTS --
|
|
-- --
|
|
-- K R U N C H --
|
|
-- --
|
|
-- S p e c --
|
|
-- --
|
|
-- Copyright (C) 1992-2022, Free Software Foundation, Inc. --
|
|
-- --
|
|
-- GNAT is free software; you can redistribute it and/or modify it under --
|
|
-- terms of the GNU General Public License as published by the Free Soft- --
|
|
-- ware Foundation; either version 3, or (at your option) any later ver- --
|
|
-- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
|
|
-- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
|
|
-- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
|
|
-- for more details. You should have received a copy of the GNU General --
|
|
-- Public License distributed with GNAT; see file COPYING3. If not, go to --
|
|
-- http://www.gnu.org/licenses for a complete copy of the license. --
|
|
-- --
|
|
-- GNAT was originally developed by the GNAT team at New York University. --
|
|
-- Extensive contributions were provided by Ada Core Technologies Inc. --
|
|
-- --
|
|
------------------------------------------------------------------------------
|
|
|
|
-- This procedure implements file name crunching
|
|
|
|
-- First, the name is divided into segments separated by minus signs and
|
|
-- underscores, then all minus signs and underscores are eliminated. If
|
|
-- this leaves the name short enough, we are done.
|
|
|
|
-- If not, then the longest segment is located (left-most if there are
|
|
-- two of equal length), and shortened by dropping its last character.
|
|
-- This is repeated until the name is short enough.
|
|
|
|
-- As an example, consider the krunch of our-strings-wide_fixed.adb
|
|
-- to fit the name into 8 characters as required by DOS:
|
|
|
|
-- our-strings-wide_fixed 22
|
|
-- our strings wide fixed 19
|
|
-- our string wide fixed 18
|
|
-- our strin wide fixed 17
|
|
-- our stri wide fixed 16
|
|
-- our stri wide fixe 15
|
|
-- our str wide fixe 14
|
|
-- our str wid fixe 13
|
|
-- our str wid fix 12
|
|
-- ou str wid fix 11
|
|
-- ou st wid fix 10
|
|
-- ou st wi fix 9
|
|
-- ou st wi fi 8
|
|
|
|
-- Final file name: OUSTWIFX.ADB
|
|
|
|
-- A special rule applies for children of System, Ada, Gnat, and Interfaces.
|
|
-- In these cases, the following special prefix replacements occur:
|
|
|
|
-- ada- replaced by a-
|
|
-- gnat- replaced by g-
|
|
-- interfaces- replaced by i-
|
|
-- system- replaced by s-
|
|
|
|
-- The rest of the name is krunched in the usual manner described above.
|
|
-- In addition, these names, as well as the names of the renamed packages
|
|
-- from the obsolescent features annex, are always krunched to 8 characters
|
|
-- regardless of the setting of Maxlen.
|
|
|
|
-- As an example of this special rule, consider ada-strings-wide_fixed.adb
|
|
-- which gets krunched as follows:
|
|
|
|
-- ada-strings-wide_fixed 22
|
|
-- a- strings wide fixed 18
|
|
-- a- string wide fixed 17
|
|
-- a- strin wide fixed 16
|
|
-- a- stri wide fixed 15
|
|
-- a- stri wide fixe 14
|
|
-- a- str wide fixe 13
|
|
-- a- str wid fixe 12
|
|
-- a- str wid fix 11
|
|
-- a- st wid fix 10
|
|
-- a- st wi fix 9
|
|
-- a- st wi fi 8
|
|
|
|
-- Final file name: A-STWIFX.ADB
|
|
|
|
-- Since children of units named A, G, I or S might conflict with the names
|
|
-- of predefined units, the naming rule in that case is that the first hyphen
|
|
-- is replaced by a tilde sign.
|
|
|
|
-- Note: as described below, this special treatment of predefined library
|
|
-- unit file names can be inhibited by setting the No_Predef flag.
|
|
|
|
-- Of course there is no guarantee that this algorithm results in uniquely
|
|
-- crunched names (nor, obviously, is there any algorithm which would do so)
|
|
-- In fact we run into such a case in the standard library routines with
|
|
-- children of Wide_Text_IO, so a special rule is applied to deal with this
|
|
-- clash, namely the prefix ada-wide_text_io- is replaced by a-wt- and then
|
|
-- the normal crunching rules are applied, so that for example, the unit:
|
|
|
|
-- Ada.Wide_Text_IO.Float_IO
|
|
|
|
-- has the file name
|
|
|
|
-- a-wtflio
|
|
|
|
-- More problems arise with Wide_Wide, so we replace this sequence by
|
|
-- a z (which is not used much) and also (as in the Wide_Text_IO case),
|
|
-- we replace the prefix ada.wide_wide_text_io- by a-zt- and then
|
|
-- the normal crunching rules are applied.
|
|
|
|
-- An additional trick is used for Ada.Long_Long_Long_Integer_*_IO, where
|
|
-- the Integer word is dropped.
|
|
|
|
-- The units implementing the support of 128-bit types are crunched to 9 and
|
|
-- System.Compare_Array_* is replaced with System.CA_* before crunching.
|
|
|
|
-- These are the only irregularity required (so far) to keep the file names
|
|
-- unique in the standard predefined libraries.
|
|
|
|
procedure Krunch
|
|
(Buffer : in out String;
|
|
Len : in out Natural;
|
|
Maxlen : Natural;
|
|
No_Predef : Boolean);
|
|
pragma Elaborate_Body (Krunch);
|
|
-- The full file name is stored in Buffer (1 .. Len) on entry. The file
|
|
-- name is crunched in place and on return Len is updated, so that the
|
|
-- resulting krunched name is in Buffer (1 .. Len) where Len <= Maxlen.
|
|
-- Note that Len may be less than or equal to Maxlen on entry, in which
|
|
-- case it may be possible that Krunch does not modify Buffer. The fourth
|
|
-- parameter, No_Predef, is a switch which, if set to True, disables the
|
|
-- normal special treatment of predefined library unit file names.
|
|
--
|
|
-- Note: the string Buffer must have a lower bound of 1, and may not
|
|
-- contain any blanks (in particular, it must not have leading blanks).
|