Order Number: AA-PUNEE-TK
November 1995
This manual describes the functions and macros in the DEC C Run-Time Library for OpenVMS systems.
| Revision /Update Information: | This revised manual supersedes the DEC C Run-Time Library Reference Manual for OpenVMS Systems (Order No. AA-PUNED- TK). |
| Software Version: | DEC C Version 5.2 for OpenVMS Systems |
Digital Equipment Corporation
Maynard, Massachusetts
__________________________________________________________________
Portions of the DEC C Run-Time Library have been implemented using source copyrighted by the University of California, Berkley and its contributors.
1.2 RTL Linking Options on Alpha Systems (Alpha only)
1.2.2 Linking with the Object Libraries
1.2.3 Examples
1.3.1.2 Linking with or Providing Your Own Shareable Images
1.3.1.3 Linking with the DEC C RTL Object Libraries
1.3.1.4 Linking with the DEC C RTL Object Libraries /NOSYSSHR
1.3.2.2 Using VAXC$EMPTY.EXE
1.3.2.3 Using DECC$EMPTY.EXE
1.3.4 Linking Examples for VAX C and DEC C Code Combined
1.3.5 Linking with the VAX C RTL /NOSYSSHR
1.4.2 Syntax Conventions for Function Prototypes
1.4.3 UNIX Style File Specifications
1.5.2 Selecting a Standard
1.5.3 Interactions with the /STANDARD Qualifier
1.5.4 Multiple-Version-Support Macro
1.5.5 Compatibility Modes
1.5.6 Curses and Socket Compatibility Macros
1.6.2 Access to RMS Files
1.6.2.2 Accessing RMS Record Files in Record Mode
1.6.2.2.2 Accessing Fixed-Length Record Files in Record Mode
1.7.2 Multithread Restrictions
1.8.2 Obtaining 64-bit Pointers to Memory
1.8.3 DEC C Header Files
1.8.4 Functions Affected
1.8.4.2 Functions Accepting Both Pointer Sizes
1.8.4.3 Functions with Two Implementations
1.8.4.4 Restricted to 32-Bit Pointers
2 Understanding Input and Output
2.3 Wide-Character Versus Byte I/O Functions
2.4.2 Converting Output Information
2.6 Program Examples
3 Character, String, and Argument-List Functions
3.2 Character-Conversion Functions
3.3 String and Argument-List Functions
3.4 Program Examples
4.2 Signal Handling
4.2.2 UNIX Signals and the DEC C RTL
4.2.3 Signal-Handling Concepts
4.2.4 Signal Actions
4.2.5 Signal Handling and OpenVMS Exception Handling
5.2.2 Exec Error Conditions
5.4 Interprocess Communication
5.5 Program Examples
6 Curses Screen Management Functions and Macros
6.2 Curses Overview
6.3.2 User-Defined Windows
6.5 Predefined Variables and Constants
6.6 Cursor Movement
6.7 Program Example
7.2 Error Detection
7.4 Example
10 Developing International Software
10.2 Developing International Software Using DEC C
10.3 Locales
10.4 Using the setlocale Function to Set Up an International Environment
10.6 Handling Different Character Sets
10.6.2 Converter Functions
10.6.3 Using Codeset Converter Files
10.7.2 Date and Time Formatting Functions
10.7.3 Monetary Formatting Function
10.7.4 Numeric Formatting
10.8.2 Case Conversion Functions
10.8.3 Functions for Input and Output of Wide Characters
10.8.4 Functions for Converting Multibyte and Wide Characters
10.8.5 Functions for Manipulating Wide-Character Strings and Arrays
11.2 Overview of Date/Time Functions
11.3 DEC C RTL Date/Time Computations-UTC and Local Time
11.4 Time-Zone Conversion Rule Files
11.5 Sample Date/Time Scenario
fp_class, fp_classf, fp_classl (Alpha only)
strtouq, strtoull (Alpha only)
A DEC C Socket Routine Reference
A.1.2 Calling from KERNEL or EXEC Modes
A.1.3 Event Flags
A.1.4 Suppressing DEC C Compilation Warnings
A.1.5 Header Files
A.3.2 User Datagram Protocol
A.5 h_errno Values
A.6 Relationship Between errno and h_errno
A.7 TCP/IP Interface Enhancements
A.8 Summary of Socket Routines
A.8.2 Auxiliary Communication Routines
A.8.3 h_errno Support Routines
A.8.4 Communication Support Routines
C Prototypes Duplicated to Non-Standard Headers
Examples
2-1 Output of the Conversion Specifications
2-2 Using the Standard I/O Functions
2-3 Using Wide Character I/O Functions
2-4 I/O Using File Descriptors and Pointers
3-1 Character-Classification Functions
3-2 Converting Double Values to an ASCII String
3-3 Changing Characters to and from Uppercase Letters
3-5 Four Arguments to the strcspn Function
3-6 Using the <stdarg.h> Functions and Definitions
4-1 Suspending and Resuming Programs
5-1 Creating the Child Process
5-2 Passing Arguments to the Child Process
5-3 Checking the Status of Child Processes
5-4 Communicating Through a Pipe
6-1 A Curses Program
6-3 Refreshing the Terminal Screen
6-4 Curses Predefined Variables
6-5 The Cursor Movement Functions
6-6 stdscr and Occluding Windows
7-1 Calculating and Verifying a Tangent Value
8-1 Allocating and Deallocating Memory for Structures
9-2 Accessing Terminal Information
9-3 Manipulating the Default Directory
9-4 Printing the Date and Time
A-1 TCP/IP Server
A-2 TCP/IP Client
A-3 UDP/IP Server
A-4 UDP/IP Client
Figures
1-2 I/O Interface from C Programs
1-3 Mapping Standard I/O and UNIX I/O to RMS
5-1 Communications Links Between Parent and Child Processes
6-1 An Example of the stdscr Window
6-2 Displaying Windows and Subwindows
6-3 Updating the Terminal Screen
6-4 An Example of the getch Macro
1 Reading and Writing to a Pipe
Tables
1-2 UNIX and OpenVMS File Specification Delimiters
1-3 Valid and Invalid UNIX and OpenVMS File Specifications
1-4 Feature Test Macros - Standards
1-5 Functions with Dual Implementations
1-6 Functions restricted to 32-bit pointers
1-7 Callbacks that Pass Only 32-Bit Pointers
2-2 Optional Characters Between % (or %n$) and the Input Conversion Specifier
2-3 Conversion Specifiers for Formatted Input
2-4 Optional Characters Between % (or %n$) and the Output Conversion Specifier
2-5 Conversion Specifiers for Formatted Output
3-1 Character, String, and Argument-List Functions
3-2 Character-Classification Functions
3-3 ASCII Characters and the Character-Classification Functions
4-1 Error- and Signal-Handling Functions
4-2 The Error Code Symbolic Values
4-4 DEC C RTL Signals and Corresponding OpenVMS VAX Exceptions DEC C RTL Signals and Corresponding OpenVMS Alpha Exceptions Subprocess Functions
6-1 Curses Functions and Macros
6-2 Curses Predefined Variables and #define Constants
7-1 Math Functions
8-1 Memory Allocation Functions
9-1 System Functions
10-1 Locale Categories
11-1 Date/Time Functions
11-2 Time-zone Filename Acronyms
3 Interpretation of the mode Argument
4 File Protection Values and Their Meanings
5 RMS Valid Keywords and Values
7 Optional Characters in strfmon Conversion Specifications
8 strfmon Conversion Specifiers
9 Optional Elements of strftime Conversion Specifications
10 strftime Conversion Specifiers
11 strptime Conversion Specifications
12 SYSCONF Argument and Return Values
13 Time-Zone Initialization Rules
14 The vfork and fork Functions
15 Optional Elements of wcsftime Conversion Specifications
16 wcsftime Conversion Specifiers
A-1 Structures Used by Socket Routines
A-2 errno Values
A-4 Basic Communication Routines
A-5 Auxiliary Communication Routines
A-6 Supported h_errno Routines
A-7 Supported Communication Routines
B-1 Functions Available on All OpenVMS Systems
B-2 Functions Added in OpenVMS Version 6.2
B-3 Functions Added in OpenVMS Version 7.0
B-4 Functions Added in OpenVMS Alpha Version 7.0