XmStringComponentCreate

XmStringComponentCreate — Функция составных строк, создает произвольный компонент составной строки.

Использование

#include <Xm/Xm.h>

XmString XmStringComponentCreate(XmStringComponentType c_type, unsigned int length, XtPointer value);

Описание

XmStringComponentCreate создает новый компонент составной строки XmString, имеющий тип c_type и содержащий значение value. Если значение value некорректно для конкретного типа компонента, то функция аварийно завершается и возвращает NULL.

c_type

Определяет тип создаваемого компонента.

length

Определяет длинну в байтах значения value. Имейте в виду, что это значение должно в точности совпадать с длинной строки value, и не включать любые завершающие пустые символы.

value

Определяет значение, используемое при создании компонента.

Полный список возможных типов компонентов составной строки XmString можно найти на справочной странице XmStringComponentType(3).

Возвращаемое значение

Если значение value некорректно для указанного типа компонента c_type, то функция возвращает NULL. В противном случае функция возвращает новую составную строку. Когда выозвращенная составная строка более ненужна приложению, приложение должно вызвать XmStringFree.

Связанная информация

XmString(3), XmStringGetNextTriple(3), XmStringComponentType(3) и XmStringFree(3).