1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2016, Free Software Foundation, Inc. --
11 -- GNAT is free software; you can redistribute it and/or modify it under --
12 -- terms of the GNU General Public License as published by the Free Soft- --
13 -- ware Foundation; either version 3, or (at your option) any later ver- --
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE. --
18 -- As a special exception under Section 7 of GPL version 3, you are granted --
19 -- additional permissions described in the GCC Runtime Library Exception, --
20 -- version 3.1, as published by the Free Software Foundation. --
22 -- You should have received a copy of the GNU General Public License and --
23 -- a copy of the GCC Runtime Library Exception along with this program; --
24 -- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
25 -- <http://www.gnu.org/licenses/>. --
27 -- GNAT was originally developed by the GNAT team at New York University. --
28 -- Extensive contributions were provided by Ada Core Technologies Inc. --
30 ------------------------------------------------------------------------------
34 with System
; use System
;
35 with Types
; use Types
;
39 -- WARNING: There is a C version of this package. Any changes to this
40 -- source file must be properly reflected in the C header file namet.h
41 -- which is created manually from namet.ads and namet.adb.
43 -- This package contains routines for handling the names table. The table
44 -- is used to store character strings for identifiers and operator symbols,
45 -- as well as other string values such as unit names and file names.
47 -- The forms of the entries are as follows:
49 -- Identifiers Stored with upper case letters folded to lower case.
50 -- Upper half (16#80# bit set) and wide characters are
51 -- stored in an encoded form (Uhh for upper half char,
52 -- Whhhh for wide characters, WWhhhhhhhh as provided by
53 -- the routine Append_Encoded, where hh are hex
54 -- digits for the character code using lower case a-f).
55 -- Normally the use of U or W in other internal names is
56 -- avoided, but these letters may be used in internal
57 -- names (without this special meaning), if they appear
58 -- as the last character of the name, or they are
59 -- followed by an upper case letter (other than the WW
60 -- sequence), or an underscore.
62 -- Operator symbols Stored with an initial letter O, and the remainder
63 -- of the name is the lower case characters XXX where
64 -- the name is Name_Op_XXX, see Snames spec for a full
65 -- list of the operator names. Normally the use of O
66 -- in other internal names is avoided, but it may be
67 -- used in internal names (without this special meaning)
68 -- if it is the last character of the name, or if it is
69 -- followed by an upper case letter or an underscore.
71 -- Character literals Character literals have names that are used only for
72 -- debugging and error message purposes. The form is an
73 -- upper case Q followed by a single lower case letter,
74 -- or by a Uxx/Wxxxx/WWxxxxxxx encoding as described for
75 -- identifiers. The Set_Character_Literal_Name procedure
76 -- should be used to construct these encodings. Normally
77 -- the use of O in other internal names is avoided, but
78 -- it may be used in internal names (without this special
79 -- meaning) if it is the last character of the name, or
80 -- if it is followed by an upper case letter or an
83 -- Unit names Stored with upper case letters folded to lower case,
84 -- using Uhh/Whhhh/WWhhhhhhhh encoding as described for
85 -- identifiers, and a %s or %b suffix for specs/bodies.
86 -- See package Uname for further details.
88 -- File names Are stored in the form provided by Osint. Typically
89 -- they may include wide character escape sequences and
90 -- upper case characters (in non-encoded form). Casing
91 -- is also derived from the external environment. Note
92 -- that file names provided by Osint must generally be
93 -- consistent with the names from Fname.Get_File_Name.
95 -- Other strings The names table is also used as a convenient storage
96 -- location for other variable length strings such as
97 -- error messages etc. There are no restrictions on what
98 -- characters may appear for such entries.
100 -- Note: the encodings Uhh (upper half characters), Whhhh (wide characters),
101 -- WWhhhhhhhh (wide wide characters) and Qx (character literal names) are
102 -- described in the spec, since they are visible throughout the system (e.g.
103 -- in debugging output). However, no code should depend on these particular
104 -- encodings, so it should be possible to change the encodings by making
105 -- changes only to the Namet specification (to change these comments) and the
106 -- body (which actually implements the encodings).
108 -- The names are hashed so that a given name appears only once in the table,
109 -- except that names entered with Name_Enter as opposed to Name_Find are
110 -- omitted from the hash table.
112 -- The first 26 entries in the names table (with Name_Id values in the range
113 -- First_Name_Id .. First_Name_Id + 25) represent names which are the one
114 -- character lower case letters in the range a-z, and these names are created
115 -- and initialized by the Initialize procedure.
117 -- Five values, one of type Int, one of type Byte, and three of type Boolean,
118 -- are stored with each names table entry and subprograms are provided for
119 -- setting and retrieving these associated values. The usage of these values
120 -- is up to the client:
122 -- In the compiler we have the following uses:
124 -- The Int field is used to point to a chain of potentially visible
125 -- entities (see Sem.Ch8 for details).
127 -- The Byte field is used to hold the Token_Type value for reserved words
128 -- (see Sem for details).
130 -- The Boolean1 field is used to mark address clauses to optimize the
131 -- performance of the Exp_Util.Following_Address_Clause function.
133 -- The Boolean2 field is used to mark simple names that appear in
134 -- Restriction[_Warning]s pragmas for No_Use_Of_Entity. This avoids most
135 -- unnecessary searches of the No_Use_Of_Entity table.
137 -- The Boolean3 field is set for names of pragmas that are to be ignored
138 -- because of the occurrence of a corresponding pragma Ignore_Pragma.
140 -- In the binder, we have the following uses:
142 -- The Int field is used in various ways depending on the name involved,
143 -- see binder documentation for details.
145 -- The Byte and Boolean fields are unused.
147 -- Note that the value of the Int and Byte fields are initialized to zero,
148 -- and the Boolean field is initialized to False, when a new Name table entry
151 type Bounded_String
(Max_Length
: Natural := 2**12) is limited
152 -- It's unlikely to have names longer than this. But we don't want to make
153 -- it too big, because we declare these on the stack in recursive routines.
155 Length
: Natural := 0;
156 Chars
: String (1 .. Max_Length
);
159 -- To create a Name_Id, you can declare a Bounded_String as a local
160 -- variable, and Append things onto it, and finally call Name_Find.
161 -- You can also use a String, as in:
162 -- X := Name_Find (Some_String & "_some_suffix");
164 -- For historical reasons, we also have the Global_Name_Buffer below,
165 -- which is used by most of the code via the renamings. New code ought
166 -- to avoid the global.
168 Global_Name_Buffer
: Bounded_String
;
169 Name_Buffer
: String renames Global_Name_Buffer
.Chars
;
170 Name_Len
: Natural renames Global_Name_Buffer
.Length
;
172 -- Note that there is some circuitry (e.g. Osint.Write_Program_Name) that
173 -- does a save/restore on Name_Len and Name_Buffer (1 .. Name_Len). This
174 -- works in part because Name_Len is default-initialized to 0.
176 -----------------------------
177 -- Types for Namet Package --
178 -----------------------------
180 -- Name_Id values are used to identify entries in the names table. Except
181 -- for the special values No_Name and Error_Name, they are subscript values
182 -- for the Names table defined in this package.
184 -- Note that with only a few exceptions, which are clearly documented, the
185 -- type Name_Id should be regarded as a private type. In particular it is
186 -- never appropriate to perform arithmetic operations using this type.
188 type Name_Id
is range Names_Low_Bound
.. Names_High_Bound
;
189 for Name_Id
'Size use 32;
190 -- Type used to identify entries in the names table
192 No_Name
: constant Name_Id
:= Names_Low_Bound
;
193 -- The special Name_Id value No_Name is used in the parser to indicate
194 -- a situation where no name is present (e.g. on a loop or block).
196 Error_Name
: constant Name_Id
:= Names_Low_Bound
+ 1;
197 -- The special Name_Id value Error_Name is used in the parser to
198 -- indicate that some kind of error was encountered in scanning out
199 -- the relevant name, so it does not have a representable label.
201 subtype Error_Name_Or_No_Name
is Name_Id
range No_Name
.. Error_Name
;
202 -- Used to test for either error name or no name
204 First_Name_Id
: constant Name_Id
:= Names_Low_Bound
+ 2;
205 -- Subscript of first entry in names table
207 ------------------------------
208 -- Name_Id Membership Tests --
209 ------------------------------
211 -- The following functions allow a convenient notation for testing whether
212 -- a Name_Id value matches any one of a list of possible values. In each
213 -- case True is returned if the given T argument is equal to any of the V
214 -- arguments. These essentially duplicate the Ada 2012 membership tests,
215 -- but we cannot use the latter (yet) in the compiler front end, because
216 -- of bootstrap considerations
221 V2
: Name_Id
) return Boolean;
227 V3
: Name_Id
) return Boolean;
234 V4
: Name_Id
) return Boolean;
242 V5
: Name_Id
) return Boolean;
251 V6
: Name_Id
) return Boolean;
261 V7
: Name_Id
) return Boolean;
272 V8
: Name_Id
) return Boolean;
284 V9
: Name_Id
) return Boolean;
297 V10
: Name_Id
) return Boolean;
311 V11
: Name_Id
) return Boolean;
326 V12
: Name_Id
) return Boolean;
328 pragma Inline
(Nam_In
);
329 -- Inline all above functions
335 function To_String
(Buf
: Bounded_String
) return String;
336 pragma Inline
(To_String
);
337 function "+" (Buf
: Bounded_String
) return String renames To_String
;
340 (Buf
: Bounded_String
:= Global_Name_Buffer
) return Name_Id
;
341 function Name_Find
(S
: String) return Name_Id
;
342 -- Name_Find searches the names table to see if the string has already been
343 -- stored. If so, the Id of the existing entry is returned. Otherwise a new
344 -- entry is created with its Name_Table_Int fields set to zero/false. Note
345 -- that it is permissible for Buf.Length to be zero to lookup the empty
349 (Buf
: Bounded_String
:= Global_Name_Buffer
) return Name_Id
;
350 -- Name_Enter is similar to Name_Find. The difference is that it does not
351 -- search the table for an existing match, and also subsequent Name_Find
352 -- calls using the same name will not locate the entry created by this
353 -- call. Thus multiple calls to Name_Enter with the same name will create
354 -- multiple entries in the name table with different Name_Id values. This
355 -- is useful in the case of created names, which are never expected to be
356 -- looked up. Note: Name_Enter should never be used for one character
357 -- names, since these are efficiently located without hashing by Name_Find
360 function Name_Equals
(N1
: Name_Id
; N2
: Name_Id
) return Boolean;
361 -- Return whether N1 and N2 denote the same character sequence
363 function Get_Name_String
(Id
: Name_Id
) return String;
364 -- Returns the characters of Id as a String. The lower bound is 1.
366 -- The following Append procedures ignore any characters that don't fit in
369 procedure Append
(Buf
: in out Bounded_String
; C
: Character);
371 pragma Inline
(Append
);
373 procedure Append
(Buf
: in out Bounded_String
; V
: Nat
);
374 -- Append decimal representation of V onto Buf
376 procedure Append
(Buf
: in out Bounded_String
; S
: String);
379 procedure Append
(Buf
: in out Bounded_String
; Buf2
: Bounded_String
);
380 -- Append Buf2 onto Buf
382 procedure Append
(Buf
: in out Bounded_String
; Id
: Name_Id
);
383 -- Append the characters of Id onto Buf. It is an error to call this with
384 -- one of the special name Id values (No_Name or Error_Name).
386 procedure Append_Decoded
(Buf
: in out Bounded_String
; Id
: Name_Id
);
387 -- Same as Append, except that the result is decoded, so that upper half
388 -- characters and wide characters appear as originally found in the source
389 -- program text, operators have their source forms (special characters and
390 -- enclosed in quotes), and character literals appear surrounded by
393 procedure Append_Decoded_With_Brackets
394 (Buf
: in out Bounded_String
;
396 -- Same as Append_Decoded, except that the brackets notation (Uhh
397 -- replaced by ["hh"], Whhhh replaced by ["hhhh"], WWhhhhhhhh replaced by
398 -- ["hhhhhhhh"]) is used for all non-lower half characters, regardless of
399 -- how Opt.Wide_Character_Encoding_Method is set, and also in that
400 -- characters in the range 16#80# .. 16#FF# are converted to brackets
401 -- notation in all cases. This routine can be used when there is a
402 -- requirement for a canonical representation not affected by the
403 -- character set options (e.g. in the binder generation of symbols).
405 procedure Append_Unqualified
(Buf
: in out Bounded_String
; Id
: Name_Id
);
406 -- Same as Append, except that qualification (as defined in unit
407 -- Exp_Dbug) is removed (including both preceding __ delimited names, and
408 -- also the suffixes used to indicate package body entities and to
409 -- distinguish between overloaded entities). Note that names are not
410 -- qualified until just before the call to gigi, so this routine is only
411 -- needed by processing that occurs after gigi has been called. This
412 -- includes all ASIS processing, since ASIS works on the tree written
413 -- after gigi has been called.
415 procedure Append_Unqualified_Decoded
416 (Buf
: in out Bounded_String
;
418 -- Same as Append_Unqualified, but decoded as for Append_Decoded
420 procedure Append_Encoded
(Buf
: in out Bounded_String
; C
: Char_Code
);
421 -- Appends given character code at the end of Buf. Lower case letters and
422 -- digits are stored unchanged. Other 8-bit characters are stored using the
423 -- Uhh encoding (hh = hex code), other 16-bit wide character values are
424 -- stored using the Whhhh (hhhh = hex code) encoding, and other 32-bit wide
425 -- wide character values are stored using the WWhhhhhhhh (hhhhhhhh = hex
426 -- code). Note that this procedure does not fold upper case letters (they
427 -- are stored using the Uhh encoding).
429 procedure Set_Character_Literal_Name
430 (Buf
: in out Bounded_String
;
432 -- This procedure sets the proper encoded name for the character literal
433 -- for the given character code.
436 (Buf
: in out Bounded_String
;
439 -- Inserts S in Buf, starting at Index. Any existing characters at or past
440 -- this location get moved beyond the inserted string.
442 function Is_Internal_Name
(Buf
: Bounded_String
) return Boolean;
444 procedure Get_Last_Two_Chars
448 -- Obtains last two characters of a name. C1 is last but one character and
449 -- C2 is last character. If name is less than two characters long then both
450 -- C1 and C2 are set to ASCII.NUL on return.
452 function Get_Name_Table_Boolean1
(Id
: Name_Id
) return Boolean;
453 function Get_Name_Table_Boolean2
(Id
: Name_Id
) return Boolean;
454 function Get_Name_Table_Boolean3
(Id
: Name_Id
) return Boolean;
455 -- Fetches the Boolean values associated with the given name
457 function Get_Name_Table_Byte
(Id
: Name_Id
) return Byte
;
458 pragma Inline
(Get_Name_Table_Byte
);
459 -- Fetches the Byte value associated with the given name
461 function Get_Name_Table_Int
(Id
: Name_Id
) return Int
;
462 pragma Inline
(Get_Name_Table_Int
);
463 -- Fetches the Int value associated with the given name
465 procedure Set_Name_Table_Boolean1
(Id
: Name_Id
; Val
: Boolean);
466 procedure Set_Name_Table_Boolean2
(Id
: Name_Id
; Val
: Boolean);
467 procedure Set_Name_Table_Boolean3
(Id
: Name_Id
; Val
: Boolean);
468 -- Sets the Boolean value associated with the given name
470 procedure Set_Name_Table_Byte
(Id
: Name_Id
; Val
: Byte
);
471 pragma Inline
(Set_Name_Table_Byte
);
472 -- Sets the Byte value associated with the given name
474 procedure Set_Name_Table_Int
(Id
: Name_Id
; Val
: Int
);
475 pragma Inline
(Set_Name_Table_Int
);
476 -- Sets the Int value associated with the given name
478 function Is_Internal_Name
(Id
: Name_Id
) return Boolean;
479 -- Returns True if the name is an internal name (i.e. contains a character
480 -- for which Is_OK_Internal_Letter is true, or if the name starts or ends
481 -- with an underscore.
483 -- Note: if the name is qualified (has a double underscore), then only the
484 -- final entity name is considered, not the qualifying names. Consider for
485 -- example that the name:
489 -- is not an internal name, because the B comes from the internal name of
490 -- a qualifying block, but the xyz means that this was indeed a declared
491 -- identifier called "xyz" within this block and there is nothing internal
494 function Is_OK_Internal_Letter
(C
: Character) return Boolean;
495 pragma Inline
(Is_OK_Internal_Letter
);
496 -- Returns true if C is a suitable character for using as a prefix or a
497 -- suffix of an internally generated name, i.e. it is an upper case letter
498 -- other than one of the ones used for encoding source names (currently the
499 -- set of reserved letters is O, Q, U, W) and also returns False for the
500 -- letter X, which is reserved for debug output (see Exp_Dbug).
502 function Is_Operator_Name
(Id
: Name_Id
) return Boolean;
503 -- Returns True if name given is of the form of an operator (that is, it
504 -- starts with an upper case O).
506 function Is_Valid_Name
(Id
: Name_Id
) return Boolean;
507 -- True if Id is a valid name - points to a valid entry in the Name_Entries
510 function Length_Of_Name
(Id
: Name_Id
) return Nat
;
511 pragma Inline
(Length_Of_Name
);
512 -- Returns length of given name in characters. This is the length of the
513 -- encoded name, as stored in the names table.
515 procedure Initialize
;
516 -- This is a dummy procedure. It is retained for easy compatibility with
517 -- clients who used to call Initialize when this call was required. Now
518 -- initialization is performed automatically during package elaboration.
519 -- Note that this change fixes problems which existed prior to the change
520 -- of Initialize being called more than once. See also Reinitialize which
521 -- allows reinitialization of the tables.
523 procedure Reinitialize
;
524 -- Clears the name tables and removes all existing entries from the table.
526 procedure Reset_Name_Table
;
527 -- This procedure is used when there are multiple source files to reset the
528 -- name table info entries associated with current entries in the names
529 -- table. There is no harm in keeping the names entries themselves from one
530 -- compilation to another, but we can't keep the entity info, since this
531 -- refers to tree nodes, which are destroyed between each main source file.
534 -- Called at the end of a use of the Namet package (before a subsequent
535 -- call to Initialize). Currently this routine is only used to generate
539 -- Lock name tables before calling back end. We reserve some extra space
540 -- before locking to avoid unnecessary inefficiencies when we unlock.
543 -- Unlocks the name table to allow use of the extra space reserved by the
544 -- call to Lock. See gnat1drv for details of the need for this.
547 -- Initializes internal tables from current tree file using the relevant
548 -- Table.Tree_Read routines. Note that Initialize should not be called if
549 -- Tree_Read is used. Tree_Read includes all necessary initialization.
551 procedure Tree_Write
;
552 -- Writes out internal tables to current tree file using the relevant
553 -- Table.Tree_Write routines.
555 procedure Write_Name
(Id
: Name_Id
);
556 -- Write_Name writes the characters of the specified name using the
557 -- standard output procedures in package Output. The name is written
558 -- in encoded form (i.e. including Uhh, Whhh, Qx, _op as they appear in
559 -- the name table). If Id is Error_Name, or No_Name, no text is output.
561 procedure Write_Name_Decoded
(Id
: Name_Id
);
562 -- Like Write_Name, except that the name written is the decoded name, as
563 -- described for Append_Decoded.
565 function Name_Chars_Address
return System
.Address
;
566 -- Return starting address of name characters table (used in Back_End call
569 function Name_Entries_Address
return System
.Address
;
570 -- Return starting address of Names table (used in Back_End call to Gigi)
572 function Name_Entries_Count
return Nat
;
573 -- Return current number of entries in the names table
575 --------------------------
576 -- Obsolete Subprograms --
577 --------------------------
579 -- The following routines operate on Global_Name_Buffer. New code should
580 -- use the routines above, and declare Bounded_Strings as local
581 -- variables. Existing code can be improved incrementally by removing calls
582 -- to the following. ???If we eliminate all of these, we can remove
583 -- Global_Name_Buffer. But be sure to look at namet.h first.
585 -- To see what these do, look at the bodies. They are all trivially defined
586 -- in terms of routines above.
588 procedure Add_Char_To_Name_Buffer
(C
: Character);
589 pragma Inline
(Add_Char_To_Name_Buffer
);
591 procedure Add_Nat_To_Name_Buffer
(V
: Nat
);
593 procedure Add_Str_To_Name_Buffer
(S
: String);
595 procedure Get_Decoded_Name_String
(Id
: Name_Id
);
597 procedure Get_Decoded_Name_String_With_Brackets
(Id
: Name_Id
);
599 procedure Get_Name_String
(Id
: Name_Id
);
601 procedure Get_Name_String_And_Append
(Id
: Name_Id
);
603 procedure Get_Unqualified_Decoded_Name_String
(Id
: Name_Id
);
605 procedure Get_Unqualified_Name_String
(Id
: Name_Id
);
607 procedure Insert_Str_In_Name_Buffer
(S
: String; Index
: Positive);
609 function Is_Internal_Name
return Boolean;
611 procedure Set_Character_Literal_Name
(C
: Char_Code
);
613 procedure Store_Encoded_Character
(C
: Char_Code
);
615 ------------------------------
616 -- File and Unit Name Types --
617 ------------------------------
619 -- These are defined here in Namet rather than Fname and Uname to avoid
620 -- problems with dependencies, and to avoid dragging in Fname and Uname
621 -- into many more files, but it would be cleaner to move to Fname/Uname.
623 type File_Name_Type
is new Name_Id
;
624 -- File names are stored in the names table and this type is used to
625 -- indicate that a Name_Id value is being used to hold a simple file name
626 -- (which does not include any directory information).
628 No_File
: constant File_Name_Type
:= File_Name_Type
(No_Name
);
629 -- Constant used to indicate no file is present (this is used for example
630 -- when a search for a file indicates that no file of the name exists).
632 Error_File_Name
: constant File_Name_Type
:= File_Name_Type
(Error_Name
);
633 -- The special File_Name_Type value Error_File_Name is used to indicate
634 -- a unit name where some previous processing has found an error.
636 subtype Error_File_Name_Or_No_File
is
637 File_Name_Type
range No_File
.. Error_File_Name
;
638 -- Used to test for either error file name or no file
640 type Path_Name_Type
is new Name_Id
;
641 -- Path names are stored in the names table and this type is used to
642 -- indicate that a Name_Id value is being used to hold a path name (that
643 -- may contain directory information).
645 No_Path
: constant Path_Name_Type
:= Path_Name_Type
(No_Name
);
646 -- Constant used to indicate no path name is present
648 type Unit_Name_Type
is new Name_Id
;
649 -- Unit names are stored in the names table and this type is used to
650 -- indicate that a Name_Id value is being used to hold a unit name, which
651 -- terminates in %b for a body or %s for a spec.
653 No_Unit_Name
: constant Unit_Name_Type
:= Unit_Name_Type
(No_Name
);
654 -- Constant used to indicate no file name present
656 Error_Unit_Name
: constant Unit_Name_Type
:= Unit_Name_Type
(Error_Name
);
657 -- The special Unit_Name_Type value Error_Unit_Name is used to indicate
658 -- a unit name where some previous processing has found an error.
660 subtype Error_Unit_Name_Or_No_Unit_Name
is
661 Unit_Name_Type
range No_Unit_Name
.. Error_Unit_Name
;
663 ------------------------
664 -- Debugging Routines --
665 ------------------------
667 procedure wn
(Id
: Name_Id
);
668 pragma Export
(Ada
, wn
);
669 -- This routine is intended for debugging use only (i.e. it is intended to
670 -- be called from the debugger). It writes the characters of the specified
671 -- name using the standard output procedures in package Output, followed by
672 -- a new line. The name is written in encoded form (i.e. including Uhh,
673 -- Whhh, Qx, _op as they appear in the name table). If Id is Error_Name,
674 -- No_Name, or invalid an appropriate string is written (<Error_Name>,
675 -- <No_Name>, <invalid name>). Unlike Write_Name, this call does not affect
676 -- the contents of Name_Buffer or Name_Len.
680 ---------------------------
681 -- Table Data Structures --
682 ---------------------------
684 -- The following declarations define the data structures used to store
685 -- names. The definitions are in the private part of the package spec,
686 -- rather than the body, since they are referenced directly by gigi.
688 -- This table stores the actual string names. Although logically there is
689 -- no need for a terminating character (since the length is stored in the
690 -- name entry table), we still store a NUL character at the end of every
691 -- name (for convenience in interfacing to the C world).
693 package Name_Chars
is new Table
.Table
(
694 Table_Component_Type
=> Character,
695 Table_Index_Type
=> Int
,
696 Table_Low_Bound
=> 0,
697 Table_Initial
=> Alloc
.Name_Chars_Initial
,
698 Table_Increment
=> Alloc
.Name_Chars_Increment
,
699 Table_Name
=> "Name_Chars");
701 type Name_Entry
is record
702 Name_Chars_Index
: Int
;
703 -- Starting location of characters in the Name_Chars table minus one
704 -- (i.e. pointer to character just before first character). The reason
705 -- for the bias of one is that indexes in Name_Buffer are one's origin,
706 -- so this avoids unnecessary adds and subtracts of 1.
709 -- Length of this name in characters
712 -- Byte value associated with this name
714 Boolean1_Info
: Boolean;
715 Boolean2_Info
: Boolean;
716 Boolean3_Info
: Boolean;
717 -- Boolean values associated with the name
719 Name_Has_No_Encodings
: Boolean;
720 -- This flag is set True if the name entry is known not to contain any
721 -- special character encodings. This is used to speed up repeated calls
722 -- to Append_Decoded. A value of False means that it is not known
723 -- whether the name contains any such encodings.
726 -- Link to next entry in names table for same hash code
729 -- Int Value associated with this name
733 for Name_Entry
use record
734 Name_Chars_Index
at 0 range 0 .. 31;
735 Name_Len
at 4 range 0 .. 15;
736 Byte_Info
at 6 range 0 .. 7;
737 Boolean1_Info
at 7 range 0 .. 0;
738 Boolean2_Info
at 7 range 1 .. 1;
739 Boolean3_Info
at 7 range 2 .. 2;
740 Name_Has_No_Encodings
at 7 range 3 .. 7;
741 Hash_Link
at 8 range 0 .. 31;
742 Int_Info
at 12 range 0 .. 31;
745 for Name_Entry
'Size use 16 * 8;
746 -- This ensures that we did not leave out any fields
748 -- This is the table that is referenced by Name_Id entries.
749 -- It contains one entry for each unique name in the table.
751 package Name_Entries
is new Table
.Table
(
752 Table_Component_Type
=> Name_Entry
,
753 Table_Index_Type
=> Name_Id
'Base,
754 Table_Low_Bound
=> First_Name_Id
,
755 Table_Initial
=> Alloc
.Names_Initial
,
756 Table_Increment
=> Alloc
.Names_Increment
,
757 Table_Name
=> "Name_Entries");