MSP430 IAR C/C++ Compiler reference guide - Rice University

LocaleNote: If you link your library with I/O debugging support, C-SPY variants of thelow-level I/O functions will be linked for interaction with C-SPY. For moreinformation, see Debug support in the runtime library, page 47.Heap size and standard I/OWhen you are using the full DLIB configuration, be aware that the size of the input andoutput buffers is set to 512 bytes in the stdio library header file. If the heap is too small,I/O will not be buffered, which is considerably slower than buffered I/O. If you executethe application using the simulator driver of the IAR C-SPY Debugger, you are notlikely to notice the speed penalty, but it is quite noticeable when the application runs onan MSP430 microcontroller. If you use the standard I/O library, you should set the heapsize to a value which accommodates the needs of the standard I/O buffer, for example1Kbyte.If you have excluded FILE descriptors from the DLIB runtime environment, as in thenormal DLIB configuration, there are no input and output buffers at all.LocaleLocale is a part of the C language that allows language- and country-specific settings fora number of areas, such as currency symbols, date and time, and multibyte characterencoding.Depending on what runtime library you are using you get different level of localesupport. However, the more locale support, the larger your code will get. It is thereforenecessary to consider what level of support your application needs.The DLIB library can be used in two main modes:● With locale interface, which makes it possible to switch between different localesduring runtime● Without locale interface, where one selected locale is hardwired into theapplication.LOCALE SUPPORT IN PREBUILT LIBRARIESThe level of locale support in the prebuilt libraries depends on the library configuration.●●●All prebuilt libraries support the C locale onlyAll libraries with full library configuration have support for the locale interface. Forprebuilt libraries with locale interface, it is by default only supported to switchmultibyte character encoding during runtime.Libraries with normal library configuration do not have support for the localeinterface.64MSP430 IAR C/C++ CompilerReference Guide