GNAT Reference Manual

GNAT Reference Manual

GNAT Reference Manual

GNAT, The GNU Ada Compiler
GCC version 4.6.4

AdaCore

• About This Guide
• Implementation Defined Pragmas
• Implementation Defined Attributes
• Implementation Advice
• Implementation Defined Characteristics
• Intrinsic Subprograms
• Representation Clauses and Pragmas
• Standard Library Routines
• The Implementation of Standard I/O
• The GNAT Library
• Interfacing to Other Languages
• Specialized Needs Annexes
• Implementation of Specific Ada Features
• Implementation of Ada 2012 Features
• Obsolescent Features
• GNU Free Documentation License
• Index

--- The Detailed Node Listing ---

About This Guide

• What This Reference Manual Contains
• Related Information

Implementation Defined Pragmas

• Pragma Abort_Defer
• Pragma Ada_83
• Pragma Ada_95
• Pragma Ada_05
• Pragma Ada_2005
• Pragma Ada_12
• Pragma Ada_2012
• Pragma Annotate
• Pragma Assert
• Pragma Assume_No_Invalid_Values
• Pragma Ast_Entry
• Pragma C_Pass_By_Copy
• Pragma Check
• Pragma Check_Name
• Pragma Check_Policy
• Pragma Comment
• Pragma Common_Object
• Pragma Compile_Time_Error
• Pragma Compile_Time_Warning
• Pragma Compiler_Unit
• Pragma Complete_Representation
• Pragma Complex_Representation
• Pragma Component_Alignment
• Pragma Convention_Identifier
• Pragma CPP_Class
• Pragma CPP_Constructor
• Pragma CPP_Virtual
• Pragma CPP_Vtable
• Pragma Debug
• Pragma Debug_Policy
• Pragma Detect_Blocking
• Pragma Elaboration_Checks
• Pragma Eliminate
• Pragma Export_Exception
• Pragma Export_Function
• Pragma Export_Object
• Pragma Export_Procedure
• Pragma Export_Value
• Pragma Export_Valued_Procedure
• Pragma Extend_System
• Pragma Extensions_Allowed
• Pragma External
• Pragma External_Name_Casing
• Pragma Fast_Math
• Pragma Favor_Top_Level
• Pragma Finalize_Storage_Only
• Pragma Float_Representation
• Pragma Ident
• Pragma Implemented
• Pragma Implicit_Packing
• Pragma Import_Exception
• Pragma Import_Function
• Pragma Import_Object
• Pragma Import_Procedure
• Pragma Import_Valued_Procedure
• Pragma Initialize_Scalars
• Pragma Inline_Always
• Pragma Inline_Generic
• Pragma Interface
• Pragma Interface_Name
• Pragma Interrupt_Handler
• Pragma Interrupt_State
• Pragma Invariant
• Pragma Keep_Names
• Pragma License
• Pragma Link_With
• Pragma Linker_Alias
• Pragma Linker_Constructor
• Pragma Linker_Destructor
• Pragma Linker_Section
• Pragma Long_Float
• Pragma Machine_Attribute
• Pragma Main
• Pragma Main_Storage
• Pragma No_Body
• Pragma No_Return
• Pragma No_Strict_Aliasing
• Pragma Normalize_Scalars
• Pragma Obsolescent
• Pragma Optimize_Alignment
• Pragma Ordered
• Pragma Passive
• Pragma Persistent_BSS
• Pragma Polling
• Pragma Postcondition
• Pragma Precondition
• Pragma Profile (Ravenscar)
• Pragma Profile (Restricted)
• Pragma Psect_Object
• Pragma Pure_Function
• Pragma Restriction_Warnings
• Pragma Shared
• Pragma Short_Circuit_And_Or
• Pragma Short_Descriptors
• Pragma Source_File_Name
• Pragma Source_File_Name_Project
• Pragma Source_Reference
• Pragma Stream_Convert
• Pragma Style_Checks
• Pragma Subtitle
• Pragma Suppress
• Pragma Suppress_All
• Pragma Suppress_Exception_Locations
• Pragma Suppress_Initialization
• Pragma Task_Info
• Pragma Task_Name
• Pragma Task_Storage
• Pragma Thread_Local_Storage
• Pragma Time_Slice
• Pragma Title
• Pragma Unchecked_Union
• Pragma Unimplemented_Unit
• Pragma Universal_Aliasing
• Pragma Universal_Data
• Pragma Unmodified
• Pragma Unreferenced
• Pragma Unreferenced_Objects
• Pragma Unreserve_All_Interrupts
• Pragma Unsuppress
• Pragma Use_VADS_Size
• Pragma Validity_Checks
• Pragma Volatile
• Pragma Warnings
• Pragma Weak_External
• Pragma Wide_Character_Encoding

Implementation Defined Attributes

• Abort_Signal
• Address_Size
• Asm_Input
• Asm_Output
• AST_Entry
• Bit
• Bit_Position
• Compiler_Version
• Code_Address
• Default_Bit_Order
• Elaborated
• Elab_Body
• Elab_Spec
• Emax
• Enabled
• Enum_Rep
• Enum_Val
• Epsilon
• Fixed_Value
• Has_Access_Values
• Has_Discriminants
• Img
• Integer_Value
• Invalid_Value
• Large
• Machine_Size
• Mantissa
• Max_Interrupt_Priority
• Max_Priority
• Maximum_Alignment
• Mechanism_Code
• Null_Parameter
• Object_Size
• Old
• Passed_By_Reference
• Pool_Address
• Range_Length
• Result
• Safe_Emax
• Safe_Large
• Small
• Storage_Unit
• Stub_Type
• Target_Name
• Tick
• To_Address
• Type_Class
• UET_Address
• Unconstrained_Array
• Universal_Literal_String
• Unrestricted_Access
• VADS_Size
• Value_Size
• Wchar_T_Size
• Word_Size

The Implementation of Standard I/O

• Standard I/O Packages
• FORM Strings
• Direct_IO
• Sequential_IO
• Text_IO
• Wide_Text_IO
• Wide_Wide_Text_IO
• Stream_IO
• Text Translation
• Shared Files
• Filenames encoding
• Open Modes
• Operations on C Streams
• Interfacing to C Streams

The GNAT Library

• Ada.Characters.Latin_9 (a-chlat9.ads)
• Ada.Characters.Wide_Latin_1 (a-cwila1.ads)
• Ada.Characters.Wide_Latin_9 (a-cwila9.ads)
• Ada.Characters.Wide_Wide_Latin_1 (a-chzla1.ads)
• Ada.Characters.Wide_Wide_Latin_9 (a-chzla9.ads)
• Ada.Command_Line.Environment (a-colien.ads)
• Ada.Command_Line.Remove (a-colire.ads)
• Ada.Command_Line.Response_File (a-clrefi.ads)
• Ada.Direct_IO.C_Streams (a-diocst.ads)
• Ada.Exceptions.Is_Null_Occurrence (a-einuoc.ads)
• Ada.Exceptions.Last_Chance_Handler (a-elchha.ads)
• Ada.Exceptions.Traceback (a-exctra.ads)
• Ada.Sequential_IO.C_Streams (a-siocst.ads)
• Ada.Streams.Stream_IO.C_Streams (a-ssicst.ads)
• Ada.Strings.Unbounded.Text_IO (a-suteio.ads)
• Ada.Strings.Wide_Unbounded.Wide_Text_IO (a-swuwti.ads)
• Ada.Strings.Wide_Wide_Unbounded.Wide_Wide_Text_IO (a-szuzti.ads)
• Ada.Text_IO.C_Streams (a-tiocst.ads)
• Ada.Text_IO.Reset_Standard_Files (a-tirsfi.ads)
• Ada.Wide_Characters.Unicode (a-wichun.ads)
• Ada.Wide_Text_IO.C_Streams (a-wtcstr.ads)
• Ada.Wide_Text_IO.Reset_Standard_Files (a-wrstfi.ads)
• Ada.Wide_Wide_Characters.Unicode (a-zchuni.ads)
• Ada.Wide_Wide_Text_IO.C_Streams (a-ztcstr.ads)
• Ada.Wide_Wide_Text_IO.Reset_Standard_Files (a-zrstfi.ads)
• GNAT.Altivec (g-altive.ads)
• GNAT.Altivec.Conversions (g-altcon.ads)
• GNAT.Altivec.Vector_Operations (g-alveop.ads)
• GNAT.Altivec.Vector_Types (g-alvety.ads)
• GNAT.Altivec.Vector_Views (g-alvevi.ads)
• GNAT.Array_Split (g-arrspl.ads)
• GNAT.AWK (g-awk.ads)
• GNAT.Bounded_Buffers (g-boubuf.ads)
• GNAT.Bounded_Mailboxes (g-boumai.ads)
• GNAT.Bubble_Sort (g-bubsor.ads)
• GNAT.Bubble_Sort_A (g-busora.ads)
• GNAT.Bubble_Sort_G (g-busorg.ads)
• GNAT.Byte_Order_Mark (g-byorma.ads)
• GNAT.Byte_Swapping (g-bytswa.ads)
• GNAT.Calendar (g-calend.ads)
• GNAT.Calendar.Time_IO (g-catiio.ads)
• GNAT.Case_Util (g-casuti.ads)
• GNAT.CGI (g-cgi.ads)
• GNAT.CGI.Cookie (g-cgicoo.ads)
• GNAT.CGI.Debug (g-cgideb.ads)
• GNAT.Command_Line (g-comlin.ads)
• GNAT.Compiler_Version (g-comver.ads)
• GNAT.Ctrl_C (g-ctrl_c.ads)
• GNAT.CRC32 (g-crc32.ads)
• GNAT.Current_Exception (g-curexc.ads)
• GNAT.Debug_Pools (g-debpoo.ads)
• GNAT.Debug_Utilities (g-debuti.ads)
• GNAT.Decode_String (g-decstr.ads)
• GNAT.Decode_UTF8_String (g-deutst.ads)
• GNAT.Directory_Operations (g-dirope.ads)
• GNAT.Directory_Operations.Iteration (g-diopit.ads)
• GNAT.Dynamic_HTables (g-dynhta.ads)
• GNAT.Dynamic_Tables (g-dyntab.ads)
• GNAT.Encode_String (g-encstr.ads)
• GNAT.Encode_UTF8_String (g-enutst.ads)
• GNAT.Exception_Actions (g-excact.ads)
• GNAT.Exception_Traces (g-exctra.ads)
• GNAT.Exceptions (g-except.ads)
• GNAT.Expect (g-expect.ads)
• GNAT.Float_Control (g-flocon.ads)
• GNAT.Heap_Sort (g-heasor.ads)
• GNAT.Heap_Sort_A (g-hesora.ads)
• GNAT.Heap_Sort_G (g-hesorg.ads)
• GNAT.HTable (g-htable.ads)
• GNAT.IO (g-io.ads)
• GNAT.IO_Aux (g-io_aux.ads)
• GNAT.Lock_Files (g-locfil.ads)
• GNAT.MBBS_Discrete_Random (g-mbdira.ads)
• GNAT.MBBS_Float_Random (g-mbflra.ads)
• GNAT.MD5 (g-md5.ads)
• GNAT.Memory_Dump (g-memdum.ads)
• GNAT.Most_Recent_Exception (g-moreex.ads)
• GNAT.OS_Lib (g-os_lib.ads)
• GNAT.Perfect_Hash_Generators (g-pehage.ads)
• GNAT.Random_Numbers (g-rannum.ads)
• GNAT.Regexp (g-regexp.ads)
• GNAT.Registry (g-regist.ads)
• GNAT.Regpat (g-regpat.ads)
• GNAT.Secondary_Stack_Info (g-sestin.ads)
• GNAT.Semaphores (g-semaph.ads)
• GNAT.Serial_Communications (g-sercom.ads)
• GNAT.SHA1 (g-sha1.ads)
• GNAT.SHA224 (g-sha224.ads)
• GNAT.SHA256 (g-sha256.ads)
• GNAT.SHA384 (g-sha384.ads)
• GNAT.SHA512 (g-sha512.ads)
• GNAT.Signals (g-signal.ads)
• GNAT.Sockets (g-socket.ads)
• GNAT.Source_Info (g-souinf.ads)
• GNAT.Spelling_Checker (g-speche.ads)
• GNAT.Spelling_Checker_Generic (g-spchge.ads)
• GNAT.Spitbol.Patterns (g-spipat.ads)
• GNAT.Spitbol (g-spitbo.ads)
• GNAT.Spitbol.Table_Boolean (g-sptabo.ads)
• GNAT.Spitbol.Table_Integer (g-sptain.ads)
• GNAT.Spitbol.Table_VString (g-sptavs.ads)
• GNAT.SSE (g-sse.ads)
• GNAT.SSE.Vector_Types (g-ssvety.ads)
• GNAT.Strings (g-string.ads)
• GNAT.String_Split (g-strspl.ads)
• GNAT.Table (g-table.ads)
• GNAT.Task_Lock (g-tasloc.ads)
• GNAT.Threads (g-thread.ads)
• GNAT.Time_Stamp (g-timsta.ads)
• GNAT.Traceback (g-traceb.ads)
• GNAT.Traceback.Symbolic (g-trasym.ads)
• GNAT.UTF_32 (g-utf_32.ads)
• GNAT.UTF_32_Spelling_Checker (g-u3spch.ads)
• GNAT.Wide_Spelling_Checker (g-wispch.ads)
• GNAT.Wide_String_Split (g-wistsp.ads)
• GNAT.Wide_Wide_Spelling_Checker (g-zspche.ads)
• GNAT.Wide_Wide_String_Split (g-zistsp.ads)
• Interfaces.C.Extensions (i-cexten.ads)
• Interfaces.C.Streams (i-cstrea.ads)
• Interfaces.CPP (i-cpp.ads)
• Interfaces.Packed_Decimal (i-pacdec.ads)
• Interfaces.VxWorks (i-vxwork.ads)
• Interfaces.VxWorks.IO (i-vxwoio.ads)
• System.Address_Image (s-addima.ads)
• System.Assertions (s-assert.ads)
• System.Memory (s-memory.ads)
• System.Partition_Interface (s-parint.ads)
• System.Pool_Global (s-pooglo.ads)
• System.Pool_Local (s-pooloc.ads)
• System.Restrictions (s-restri.ads)
• System.Rident (s-rident.ads)
• System.Strings.Stream_Ops (s-ststop.ads)
• System.Task_Info (s-tasinf.ads)
• System.Wch_Cnv (s-wchcnv.ads)
• System.Wch_Con (s-wchcon.ads)

Text_IO

• Text_IO Stream Pointer Positioning
• Text_IO Reading and Writing Non-Regular Files
• Get_Immediate
• Treating Text_IO Files as Streams
• Text_IO Extensions
• Text_IO Facilities for Unbounded Strings

Wide_Text_IO

• Wide_Text_IO Stream Pointer Positioning
• Wide_Text_IO Reading and Writing Non-Regular Files

Wide_Wide_Text_IO

• Wide_Wide_Text_IO Stream Pointer Positioning
• Wide_Wide_Text_IO Reading and Writing Non-Regular Files

Interfacing to Other Languages

• Interfacing to C
• Interfacing to C++
• Interfacing to COBOL
• Interfacing to Fortran
• Interfacing to non-GNAT Ada code

Specialized Needs Annexes

Implementation of Specific Ada Features

• Machine Code Insertions
• GNAT Implementation of Tasking
• GNAT Implementation of Shared Passive Packages
• Code Generation for Array Aggregates
• The Size of Discriminated Records with Default Discriminants
• Strict Conformance to the Ada Reference Manual

Implementation of Ada 2012 Features

Obsolescent Features

GNU Free Documentation License

Index