Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.11. Разбор текста

А.5.11.7. rdsReadLineStyleText – разбор стиля линии

Функция rdsReadLineStyleText считывает слово из переданного в параметрах текста и возвращает соответствующую ему константу стиля линии. Строка должна иметь кодировку UTF8.

  int RDSCALL rdsReadLineStyleText(
    RDSCSTR Start,         // Начало текста (UTF8)
    RDSCSTR *pNextWord,    // Возврат – конец описания (UTF8)
  );

Тип указателя на эту функцию

RDS_ISpS

Параметры

Start (RDSCSTR)

Указатель на начало текста. Пробелы и табуляции в начале текста будут пропущены.

pNextWord (RDSCSTR*)

Указатель на переменную типа char*, в которую будет записан указатель на начало следующего слова строки Start. Если вызывающей программе не нужно знать начало следующего слова, в этом параметре можно передать NULL.

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

Константа стиля линии Windows API, соответствующая считанному ключевому слову.

Примечания

Эта функция извлекает слово из строки Start и преобразует его в стандартную константу стиля линии, используемую в Windows API. Она использует те же ключевые слова, что и функция rdsWriteLineStyleText. Если слово, считанное функцией, не совпадает ни с одним из ключевых слов стиля линий, функция возвращает PS_SOLID (сплошная линия). Если считано слово конца строки («\n», см. описание функции rdsGetTextWord) или в тексте нет ни одного слова, функция возвращает PS_NULL (нет линии).

Функция не поддерживает кодировку UTF16, поскольку текстовые данные блока всегда хранятся и передаются в модель в кодировке UTF8. Если необходимо считать данные из строки в UTF16, необходимо предварительно преобразовать ее функцией rdsUTF16toUTF8.

См. также

rdsWriteLineStyleText, rdsGetTextWord.