Ada Reference Manual (Ada 2022) — Legal Information
Contents   Index   References   Search   Previous   Next 

3.2.2 Subtype Declarations

1
A subtype_declaration declares a subtype of some previously declared type, as defined by a subtype_indication.

Syntax

2/3
subtype_declaration ::= 
   subtype defining_identifier is subtype_indication
        [aspect_specification];
3/2
subtype_indication ::=  [null_exclusion] subtype_mark [constraint]
4
subtype_mark ::= subtype_name
5
constraint ::= scalar_constraint | composite_constraint
6
scalar_constraint ::= 
     range_constraint | digits_constraint | delta_constraint
7
composite_constraint ::= 
     index_constraint | discriminant_constraint

Name Resolution Rules

8
A subtype_mark shall resolve to denote a subtype. The type determined by a subtype_mark is the type of the subtype denoted by the subtype_mark.

Dynamic Semantics

9
The elaboration of a subtype_declaration consists of the elaboration of the subtype_indication. The elaboration of a subtype_indication creates a new subtype. If the subtype_indication does not include a constraint, the new subtype has the same (possibly null) constraint as that denoted by the subtype_mark. The elaboration of a subtype_indication that includes a constraint proceeds as follows: 
10
The constraint is first elaborated.
11
A check is then made that the constraint is compatible with the subtype denoted by the subtype_mark.
12
The condition imposed by a constraint is the condition obtained after elaboration of the constraint. The rules defining compatibility are given for each form of constraint in the appropriate subclause. These rules are such that if a constraint is compatible with a subtype, then the condition imposed by the constraint cannot contradict any condition already imposed by the subtype on its values. The exception Constraint_Error is raised if any check of compatibility fails. 
13/5
NOTE   A scalar_constraint can be applied to a subtype of an appropriate scalar type (see 3.5, 3.5.9, and J.3), even if the subtype is already constrained. On the other hand, a composite_constraint can be applied to a composite subtype (or an access-to-composite subtype) only if the composite subtype is unconstrained (see 3.6.1 and 3.7.1). 

Examples

14
Examples of subtype declarations: 
15/2
subtype Rainbow   is Color range Red .. Blue;      -- see 3.2.1
subtype Red_Blue  is Rainbow;
subtype Int       is Integer;
subtype Small_Int is Integer range -10 .. 10;
subtype Up_To_K   is Column range 1 .. K;          -- see 3.2.1
subtype Square    is Matrix(1 .. 10, 1 .. 10);     -- see 3.6
subtype Male      is Person(Sex => M);             -- see 3.10.1
subtype Binop_Ref is not null Binop_Ptr;           -- see 3.10
Contents   Index   References   Search   Previous   Next 
Ada-Europe Ada 2005 and 2012 Editions sponsored in part by Ada-Europe