std-list->string


Synopsis

(std-list->string <intlst>)

(std-list->wstring <intlst>) ; "wide string", unicode support

Description

STD-LIST->STRING converts a list of integer numbers (the character representation) into a string. It is the exact complement to STD-STRING->LIST.

Low-level string functions dealing with integer characters are STD-STRING-ELT, STD-STRING-POSITION, STD-STRING->LIST and STD-LIST->STRING. The advantage using single integers instead of single character strings is less memory housekeeking, but the disadvantage is less readability. The often occur in library but not in user functions.

It is the same as the VLISP extension VL-LIST->STRING.

STD-LIST->WSTRING ("wide string") is to be used on possible unicode characters (> 255) in the list. The resulting string depends if the system can support unicode. If unicode is not supported (chr 255) is usually used as placeholder, the result if (chr i). If an integer higher than 255 is used for STD-STRING->LIST, an error is thrown.

Example

(std-list->string '(49 50)) => "12"
(std-list->wstring '(49 50 9600)) => "12€"
(std-list->string '(49 50 9600)) => ERROR

Arguments

intlst: a list of integer numbers.

Return Value

A string.

Side Effects

None.

Module

(std-require 'STDSTR)

Defined in STDSTR