База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

wcsstr — търсене на подниз в широк низ

wcsstr намира първото срещане на широк подниз. Функцията връща указател към съвпадението или NULL, ако няма съвпадение.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

#include <wchar.h>
QWchar_t *wcsstr(QWchar_t *s1, const wchar_t *s2);

wcsstr от <wchar.h> търси последователността s2 в s1, без да включва крайния L'\0' на шаблона. Ако s2 е празен, резултатът е s1; той сочи към съществуващия низ, а не към копие.

И двата аргумента трябва да сочат към валидни низове, завършващи с L'\0'. NULL и незавършени масиви водят до неопределено поведение. Преди да използвате резултата, проверете дали не е NULL.

В записа на C23 QWchar_t е заместител, използван от стандарта, а не тип за деклариране: резултатът запазва квалификатора const на елементите на s1. За const wchar_t * функцията връща const wchar_t *, а за wchar_t * връща wchar_t *.

Примери

#include <stddef.h>
#include <stdio.h>
#include <wchar.h>

int main(void)
{
    const wchar_t text[] = L"red blue blue";
    const wchar_t *match = wcsstr(text, L"blue");

    if (match != NULL) {
        printf("index=%td\n", match - text);
    }
    printf("missing=%d\n", wcsstr(text, L"green") == NULL);
    printf("empty=%d\n", wcsstr(text, L"") == text);
    return 0;
}

Резултат

index=4
missing=1
empty=1

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

Източници