Skip to main content

IAR Embedded Workbench for RL78 5.20

Runtime library configurations

In this section:

The runtime library is provided with different library configurations, where each configuration is suitable for different application requirements.

The runtime library configuration is defined in the library configuration file. It contains information about what functionality is part of the runtime environment. The less functionality you need in the runtime environment, the smaller the environment becomes.

These predefined library configurations are available:

Library configuration

Description

Normal DLIB (default)

C locale, but no locale interface, no file descriptor support, no multibyte characters in printf and scanf, and no hexadecimal floating-point numbers in strtod.

Full DLIB

Full locale interface, C locale, file descriptor support, and optionally multibyte characters in printf and scanf, and hexadecimal floating-point numbers in strtod.

Table 61. Library configurations 


Note

In addition to these predefined library configurations, you can provide your own configuration, see Customizing and building your own runtime library

If you do not specify a library configuration explicitly you will get the default configuration. If you use a prebuilt runtime library, a configuration file that matches the runtime library file will automatically be used. See Setting up the runtime environment.

Note

If you use the Libc++ library, you will automatically get the Full configuration. This is the only configuration that exists for Libc++.

To override the default library configuration, use one of these methods:

  1. Use a prebuilt configuration of your choice—to specify a runtime configuration explicitly:

    Caution

    Choose Project>Options>General Options>Library Configuration>Library and change the default setting.

    Danger

    Use the ‑‑dlib_config compiler option, see ‑‑dlib_config.

    The prebuilt libraries are based on the default configurations, see Runtime library configurations.

  2. If you have built your own customized library, choose Project>Options>General Options>Library Configuration>Library and choose Custom to use your own configuration. For more information, see Customizing and building your own runtime library.