CAN CSA-ISO IEC 13719-2-2000 Information Technology - Portable Common Tool Environment (PCTE) - Part 2 C Programming Language Binding.pdf

1、(rGJ CSA INTERNATIONAL National Standard of Canada CAN/CSA-ISO/lEC 13719-2-00 (ISO/IEC 13719-2:1998) - -International Standard ISO/IEC 13719-2:1998 (second edition 1998-10-01) has been adopted without modification as CSA Standard CAN/CSA-ISO/IEC 13719-2-00, which has been approved as a National Stan

2、dard of Canada by the Standards Council of Canada. ISBN 1-55324-126-6 March 2000 Information technology - Portable Common Tool Environment (PCTE) _ Part 2: C programming language binding Technologies de Iinformation - Environnement doutil courant portable (PCTE) -Partie 2: Interface de programmation

3、 en langage de programmation C Reference number ISO/IEG 13719-2:1998(E) The Canadian Standards Association, which operates under the name CSA International (CSA), under whose auspices this National Standard has been produced, was chartered in 1919 and accredited by the Standards Council of Canada to

4、 the National Standards system in 1973. It is a not-for-profit, nonstatutory, voluntary membership association engaged in standards development and certification activities. CSA standards reflect a national consensus of producers and users - including manufacturers, consumers, retailers, unions and

5、professional organizations, and governmental agencies. The standards are used widely by industry and commerce and often adopted by municipal, provincial, and federal governments in their regulations, particularly in the fields of health, safety, building and construction, and the environment. Indivi

6、duals, companies, and associations across Canada indicate their support for CSAs standards development by volunteering their time and skills to CSA Committee work and supporting the Associations objectives through sustaining memberships. The more than 7000 committee volunteers and the 2000 sustainin

7、g memberships together form CSAs total membership from which its Directors are chosen. Sustaining memberships represent a major source of income for CSAs standards development activities. The Association offers certification and testing services in support of and as an extension to its standards dev

8、elopment activities. To ensure the integrity of its certification process, the Association regularly and continually audits and inspects products that bear the CSA Mark. In addition to its head office and laboratory complex in Toronto, CSA has regional branch offices in major centres across Canada a

9、nd inspection and testing agencies in eight countries. Since 1919, the Association has developed the necessary expertise to meet its corporate mission: CSA is an independent service organization whose mission is to provide an open and effective forum for activities facilitating the exchange of goods

10、 and services through the use of standards, certification and related services to meet national and international needs. For futher information on CSA services, write to CSA International 178 Rexdale Boulevard Toronto, Ontario, M9W 1 R3 Canada CSA INTERNATIONAL -The Standards Council of Canada is th

11、e coordinating body of the National Standards system, a federation of independent, autonomous organizations working towards the further development and improvement of voluntary standardization in the national interest. The principal objects of the Council are to foster and promote voluntary standard

12、ization as a means of advancing the national economy, benefiting the health, safety, and welfare of the public, assisting and protecting the consumer, facilitating domestic and international trade, and furthering international cooperation in the field of standards. A National Standard of Canada is a

13、 standard which has been approved by the Standards Council of Canada and one which reflects a reasonable agreement among the views of a number of capable individuals whose collective interests provide to the greatest practicable extent a balance of representation of producers, users, consumers, and

14、others with relevant interests, as may be appropriate to the subject in hand. It normally is a standard which is capable of making a significant and timely contribution to the national interest. Approval of a standard as a National Standard of Canada indicates that a standard conforms to the criteri

15、a and procedures established by the Standards Council of Canada. Approval does not refer to the technical content of the standard; this remains the continuing responsibility of the accredited standards-development organization. Those who have a need to apply standards are encouraged to use National

16、Standards of Canada whenever practicable. These standards are subject to periodic review; therefore, users are cautioned to obtain the latest edition from the organization preparing the standard. The responsibility for approving National Standards of Canada rests with the Standards Council of Canada

17、 45 OConnor Street, Suite 1200 Ottawa, Ontario, K1 P 6N7 Canada Although the intended primary application of this Standard is stated in its Scope, it is important to note that it remains the responsibility of the users to judge its suitability for their particular purpose. CAN/CSA-ISO/IEC 13719-2-00

18、 Information technology- Portable Common Tool Environment (PCTE) - Part 2: C programming language binding CAN/CSA-ISO/IEC 13719-2-00 Infonnation technology -Portable Co-.n-.non Tool Environ-.nent (PCTE) - Part 2: C progra-.n-.ning language binding CSAPreface Standards development within the Informat

19、ion Technology sector is harmonized with international standards development. Through the CSA Technical Committee on Information Technology (TClT), Canadians serve as the Canadian Advisory Committee (CAC) on ISO/IEC Joint Technical Committee 1 on Information Technology (ISO/IEC jTC1) for the Standar

20、ds Council of Canada (SCC), the ISO member body for Canada and sponsor of the Canadian National Committee of the lEe. Also, as a member of the International Telecommunication Union (lTU), Canada participates in the International Telegraph and Telephone Consultative Committee (lTU-T). This Internatio

21、nal Standard was reviewed by the CSA TCiT under the jurisdiction of the Strategic Steering Committee on Information Technology and deemed acceptable for use in Canada. (A committee membership list is available on request from the CSA Project Manager.) From time to time, ISO/IEC may publish addenda,

22、corrigenda, etc. The CSA TCiT will review these documents for approval and publication. For a listing, refer to the CSA Information Products catalogue or CSA Info Update or contact a CSA Sales representative. This Standard has been formally approved, without modification, by these Committees and has

23、 been approved as a National Standard of Canada by the Standards Council of Canada. March 2000 CSA International- 2000 All rights reserved. No part of this publication may be reproduced in any form whatsoever without the prior permission of the publisher. ISO/IEC material is reprinted with permissio

24、n. Inquiries regarding this National Standard of Canada should be addressed to CSA International, 178 Rexdale Boulevard, Toronto, Ontario, M9W 1 R3. March 2000 CSA/1 INTERNATIONAL STANDARD ISOllEe 13719-2 Second edition 1998-10-01 Information technology - Portable Common Tool Environment (PCTE) -Par

25、t 2: C programming language binding Technologies de Iinformation - Environnement doutil courant portable (PCTE) -Partie 2: Interface de programmation en langage de programmation C Reference number ISOIIEe 13719-2: 1998(E) ISOIIEC 13719-2:1998(E) Contents 1 Scope 2 Conformance 3 Normative references

26、4 Definitions 5 Formal notations 6 Outline of the Standard 7 Binding strategy 7.1 C programming language standard 7.2 General principles 7.3 Sets and sequences 7.4 Character strings 7.5 Memory allocation 7.6 References and names 7.7 Operation return values 7.8 Error conditions 7.9 Identifiers 7.10 I

27、mplementation limits 8 Datatype mapping 8.1 Mapping of PCTE datatypes to LI datatypes 8.1.1 Mapping of predefined PCTE datatypes 8.1.2 Mapping of private PCTE datatypes 8.1.3 Mapping of complex PCTE datatypes 8.1.4 New LI datatype generators 8.2 Mapping of LI datatypes to C datatypes 8.2.1 LI dataty

28、pe boolean 8.2.2 LI datatype pcte-integer 8.2.3 LI datatype pcte-natural 8.2.4 LI datatype pcte-float 8.2.5 LI datatype pcte-time 8.2.6 LI datatype pcte-text ISOIIEC 1998 AI! rights reserved. Unless otherwise specified, no part of this publication may be reproduced or utilized in any form or by any

29、means, electronic or mechanical, including photocopying and microfilm, without permission in writing from the publisher. ISOIIEC Copyright Office. Case postale 56 CH-1211 Geneve 20 Switzerland ii 1 1 1 2 2 2 2 2 3 3 4 4 4 5 5 5 5 6 6 6 7 8 8 9 9 9 10 11 12 13 ISOIIEC 8.2.7 LI datatype octet 8.2.8 LI

30、 enumerated datatype pete-xxx 8.2.9 LI private datatypes 8.2.10 LI datatype generator pete-sequence 8.2.11 LI datatype pete-string 8.2.12 LI datatype generator bounded-set 8.2.13 LI datatype generator choice 8.2.14 LI datatype record 8.3 Private datatypes 8.4 References and names 8.5 C private type

31、Pete_sequence 8.5.1 Operations on sequences 8.5.2 Error conditions for sequence operators 8.6 Deriving C function semantics from the abstract specification 8.7 Headers 8.7.1 The global PCTE header 8.7.2 The PCTE basic type header 8.7.3 The PCTE sequence header 9 Object management 9.1 Object manageme

32、nt datatypes 9.2 Link operations 9.3 Object operations 9.4 Version operations 10 Schema management 10.1 Schema management datatypes 10.2 Update operations 10.3 Usage operations 10.4 Working schema operations 11 Volumes, devices, and archives 11.1 Volume, device, and archive datatypes 11.2 Volume, de

33、vice, and archive operations 11.3 Clusters 12 Files, pipes, and devices 12.1 File, pipe, and device datatypes 12.2 File, pipe, and device operations 13 Process execution 13.1 Process execution datatypes 13.2 Process execution operations 13.3 Security operations 13.4 Profiling operations ISOIIEC 1371

34、9-2:1998(E) 14 14 15 15 17 18 19 20 21 22 23 27 30 30 31 32 32 33 36 37 39 43 49 51 51 53 59 62 66 66 67 69 70 70 71 73 74 74 78 79 III ISOIIEC 13719-2:1998(E) 13.5 Monitoring operations 14 Message queues 14.1 Message queue datatypes 14.2 Message queue operations 15 Notification 15.1 Notification da

35、tatypes 15.2 Notification operations 16 Concurrency and integrity control 16.1 Concurrency and integrity control datatypes 16.2 Concurrency and integrity control operations 17 Replication 17.1 Replication datatypes 17.2 Replication operations 18 Network connection 18.1 Network connection datatypes 1

36、8.2 Network connection operations 18.3 Foreign system operations 18.4 Time operations 19 Discretionary security 19.1 Discretionary security datatypes 19.2 Discretionary access control operations 19.3 Discretionary security administration operations 20 Mandatory security 20.1 Mandatory security datat

37、ypes 20.2 Mandatory security operations 20.3 Mandatory security administration operations 20.4 Mandatory security operations for processes 21 Auditing 21.1 Auditing datatypes 21.2 Auditing operations 22 Accounting 22.1 Accounting datatypes 22.2 Accounting administration operations 22.3 Consumer iden

38、tity operations 23 References 23.1 Reference datatypes iv ISOIIEC 79 80 80 81 84 84 84 85 85 85 86 86 87 88 88 89 91 91 91 92 94 94 96 96 96 98 99 100 100 103 105 105 107 109 109 109 ISOIIEC ISOIIEC 13719-2:1998(E) 23.2 Object reference operations 110 23.3 Link reference operations 112 23.4 Type ref

39、erence operations 114 24 Limits 115 24.1 Implementation limit datatypes 115 24.2 Implementation limit operations 117 25 Error conditions 117 25.1 Error condition datatypes 117 25.2 Error condition operations 124 Annex A - The object orientation module 125 Index of abstract operations 130 Index of C

40、subprograms 136 Index of C datatypes 143 v ISOIIEe 13719-2:1998(E) ISOIlEC Foreword ISO (the International Organization for Standardization) and IEC (the International Electrotechnical Commission) form the specialized system for worldwide standardization. National bodies that are members of ISO or l

41、EC participate in the development of International Standards through technical committees established by the respective organization to deal with particular fields of technical activity. ISO and IEC technical committees collaborate in fields of mutual interest. Other international organizations, gov

42、ernmental and non-governmental, in liaison with ISO and IEC, also take part in the work. In the field of information technology, ISO and lEC have established a joint technical committee, ISOIlEC ITC I. Draft International Standards adopted by the joint technical committee are circulated to national

43、bodies for voting. Publication as an International Standard requires approval by at least 75 % of the national bodies casting a vote. International Standard ISOIIEC 13719-2 was prepared by ECMA (as Standard ECMA-I58) and was adopted, under a special “fast-track procedure“, by Joint Technical Committ

44、ee ISOIlEC ITC I, Information technology, in parallel with its approval by national bodies of ISO and lEe. This second edition cancels and replaces the first edition (ISOIIEC 13719-2: 1995), which has been technically revised. ISOIlEC 13719 consists of the following parts, under the general title In

45、formation technology - Ponable Common Tool Environment (PCTE): Pan 1: Abstract specification Pan 2: C programming language binding Pan 3: Ada programming language binding Pan 4: IDL binding (Interface Definition Language) Annex A forms an integral part of this part of ISOIIEC 13719. VI INTERNATIONAL

46、 STANDARD ISOIIEC ISOIIEC 13719-2:1998(E) Information technology - Portable Common Tool Environment (PCTE) -Part 2: C programming language binding 1 Scope This part of ISOIIEC 13719 defines the binding of the Portable Common Tool Environment (PCTE), as specified in ISOIIEC 13719-1, to the C programm

47、ing language. A number of features are not completely defined in ISOIIEC 13719-1, some freedom being allowed to the implementor. Some of these features are specified as implementation limits. Some constraints are placed on these implementation limits by this part of ISOIIEC 13719. These constraints

48、are specified in clause 24, Implementation Limits. PCTE is an interface to a set of facilities that forms the basis for constructing environments supporting systems engineering projects. These facilities are designed particularly to provide an infrastructure for programs which may be part of such en

49、vironments. Such programs, which are used as aids to system development, are often referred to as tools. 2 Conformance An implementation of PCTE conforms to this part of ISOIIEC 13719 if it conforms to 2.2 of ISOIIEC 13719-1, where the binding referred to there is taken to be the C language binding defined in clauses 1 to 5 and 8 to 25 of this part ofISOIIEC 13719. All other parts of this part of ISOIIEC 13719 are provided as assistance to the reader and are not normative. The C language binding defined in this part of ISOIIEC 13719 conforms to 2.1 of ISOIIEC 13719-