Panel użytkownika
Nazwa użytkownika:
Hasło:
Nie masz jeszcze konta?
Hasło nie zostało zweryfikowane
Niniejsze hasło zostało opracowane, jednak nie zostało ono zweryfikowane przez administrację serwisu. Jeżeli znalazłeś błędy merytoryczne w niniejszym dokumencie, prosimy o ich zgłoszenie na forum w dziale Znalezione błędy.
Opracował: Mrovqa
Język C++

basic_string::find_first_of

[metoda] Wyszukuje pierwsze wystąpienie znaku z danej bazy znaków.

Składnia

C/C++
#include <string>

namespace std
{
    template <
    class TypZnaku,
    class CechowanieZnakow = char_traits < TypZnaku >,
    class Alokator = allocator < TypZnaku >
    >
    class basic_string
    {
    private:
        typedef basic_string < TypZnaku, CechowanieZnakow, Alokator > UtworzonaKlasaT;
    public:
        size_type find_first_of( const UtworzonaKlasaT & _str, size_type _pos = 0 ) const noexcept; //(1)
       
        size_type find_first_of( const TypZnaku * _s, size_type _pos = 0 ) const; //(2)
       
        size_type find_first_of( const TypZnaku * _s, size_type _pos, size_type _n ) const; //(3)
       
        size_type find_first_of( TypZnaku _c, size_type _pos = 0 ) const noexcept; //(4)
       
    }; //class basic_string
} //namespace std

Argumenty

ArgumentOpis
_strInny obiekt tego samego typu co aktualny (z uwzględnieniem parametrów szablonu!), który będzie bazą znaków.
_posPozycja znaku w aktualnym obiekcie, od którego ma rozpocząć się wyszukiwanie.
_sWskaźnik na tablicę znaków (która jest bazą). Jeżeli argument _n jest określony, to oznacza on wielkość bazy znaków. W przeciwnym wypadku owa wielkość jest zdeterminowana przez bajt zerowy.
_nWielkość bazy.
_cBaza składająca się tylko z tego znaku.

Zwracana wartość

Pozycja pierwszego znalezionego znaku z bazy. Jeżeli owy znak nie został znaleziony, funkcja zwróci » standard C++ » basic_stringnpos.

Opis szczegółowy

Metoda (1) wyszukuje pierwsze wystąpienie znaku z bazy określonej innym stringiem od pozycji _pos w aktualnym obiekcie. Wersja (2) czyni dokładnie to samo, z tą różnicą, iż baza znaków jest określona poprzez wskaźnik do tablicy. Metoda (3) jest rozszerzoną metodą (2) o możliwość podania wielkości bazy. Ostatnia wersja (4) wyszukuje pojedynczy znak w aktualnym obiekcie.

Rzucane wyjątki

Jeżeli _s nie wskazuje na wystarczająco dużą tablicę (_n jest za duże), to zachowanie jest niezdefiniowane.

Przykład

C/C++
#include <iostream>
#include <string>

typedef std::basic_string < char, std::char_traits < char >, std::allocator < char >> MojString;
int main()
{
    MojString str( "wyszukiwanie &znakow* specjalnych!" );
   
    MojString::size_type found = str.find_first_of( "!@#$%^&*()_+=-" );
   
    if( found != MojString::npos )
    {
        std::cout << "Pierwszy znak specjalny to " << str[ found ];
        std::cout << " na pozycji " << found << '\n';
    }
   
    return 0;
}
Standardowe wyjście programu:
Pierwszy znak specjalny to & na pozycji 13

Zagadnienia powiązane

findWyszukuje pierwszego wystąpienia danego łańcucha znaków. (metoda)
find_last_ofWyszukuje ostatnie wystąpienie znaku z danej bazy znaków. (metoda)
find_first_not_ofWyszukuje pierwsze wystąpienia znaku spoza danej bazy znaków. (metoda)
replaceZamienia część znaków na inne. (metoda)
substrZwraca podciąg łańcucha znaków. (metoda)

Linki zewnętrzne