<string>

Makale
03/15/2013

Kapsayıcı şablon sınıfını tanımlayan basic_string ve destekleyici çeşitli şablonları.

Hakkında daha fazla bilgi için basic_string, bkz.basic_string Class

namespace std {
    template<class CharType>
        class char_traits;
    template<>
        class char_traits<char>;
    template<>
        class char_traits<wchar_t>;
    template<>
        class char_traits<char16_t>; 
    template<>
        class char_traits<char32_t>;

    template<
        class CharType,
        class Traits = char_traits<CharType>,
        class Allocator = allocator<CharType> 
    > class basic_string;

    typedef basic_string<char> string;
    typedef basic_string<wchar_t> wstring;
    typedef basic_string<char16_t> u16string;
    typedef basic_string<char32_t> u32string;

        // NARROW FUNCTIONS
    int stoi (
        const string& _Str, 
        size_t *_Idx = 0,
        int _Base = 10
    );
    long stol (
        const string& _Str, 
        size_t *_Idx = 0,
        int _Base = 10
    );
    unsigned long stoul (
        const string& _Str, 
        size_t *_Idx = 0,
        int _Base = 10
    );
    long long stoll (
        const string& _Str, 
        size_t *_Idx = 0,
        int _Base = 10
    );
    unsigned long long stoull (
        const string& _Str, 
        size_t *_Idx = 0,
        int _Base = 10
    );
    float stof (
        const string& _Str, 
        size_t *_Idx = 0
    );
    double stod (
        const string& _Str, 
        size_t *_Idx = 0
    );
    long double stold (
        const string& _Str, 
        size_t *_Idx = 0
    );

    string to_string (long long _Val); 
    string to_string (unsigned long long _Val); 
    string to_string (long double _Val);

        // WIDE FUNCTIONS
    int stoi (
        const wstring& _Str, 
        size_t *_Idx = 0,
        int _Base = 10
    );
    long stol (
        const wstring& _Str, 
        size_t *_Idx = 0,
        int _Base = 10
    );
    unsigned long stoul (
        const wstring& _Str, 
        size_t *_Idx = 0,
        int _Base = 10
    );
    long long stoll (
        const wstring& _Str, 
        size_t *_Idx = 0,
        int _Base = 10
    );
    unsigned long long stoull (
        const wstring& _Str, 
        size_t *_Idx = 0,
        int _Base = 10
    ); 
    float stof (
        const wstring& _Str, 
        size_t *_Idx = 0
    ); 
    double stod (
        const wstring& _Str, 
        size_t *_Idx = 0
    );
    long double stold (
        const wstring& _Str, 
        size_t *_Idx = 0
    );
    wstring to_wstring (long long _Val); 
    wstring to_wstring (unsigned long long _Val); 
    wstring to_wstring (long double _Val);

       // TEMPLATE FUNCTIONS
    template<class CharType, class Traits, class Allocator>
        basic_string<CharType, Traits, Allocator> operator+ (
            const basic_string<CharType, Traits, Allocator>& _Left,
            const basic_string<CharType, Traits, Allocator>& _Right
        );
    template<class CharType, class Traits, class Allocator>
        basic_string<CharType, Traits, Allocator> operator+ (
            const basic_string<CharType, Traits, Allocator>& _Left,
            const CharType *_Right
        );
    template<class CharType, class Traits, class Allocator>
        basic_string<CharType, Traits, Allocator> operator+ (
            const basic_string<CharType, Traits, Allocator>& _Left,
            CharType _Right
        );
    template<class CharType, class Traits, class Allocator>
        basic_string<CharType, Traits, Allocator> operator+ (
            const CharType *_Left,
            const basic_string<CharType, Traits, Allocator>& _Right
        );
    template<class CharType, class Traits, class Allocator>
        basic_string<CharType, Traits, Allocator> operator+ (
            CharType _Left,
            const basic_string<CharType, Traits, Allocator>& _Right
        );

    template<class CharType, class Traits, class Allocator>
        basic_string<CharType, Traits, Allocator>&& operator+ (
            const basic_string<CharType, Traits, Allocator>& _Left,
            const basic_string<CharType, Traits, Allocator>&& _Right
        );
    template<class CharType, class Traits, class Allocator>
        basic_string<CharType, Traits, Allocator>&& operator+ (
            const basic_string<CharType, Traits, Allocator>&& _Left,
            const basic_string<CharType, Traits, Allocator>& _Right
        );
    template<class CharType, class Traits, class Allocator>
        basic_string<CharType, Traits, Allocator>&& operator+ (
            const basic_string<CharType, Traits, Allocator>&& _Left,
            const basic_string<CharType, Traits, Allocator>&& _Right
        );
    template<class CharType, class Traits, class Allocator> 
        basic_string<CharType, Traits, Allocator>&& operator+ (
            const basic_string<CharType, Traits, Allocator>&& _Left,
            const CharType *_Right
        );
    template<class CharType, class Traits, class Allocator>
        basic_string<CharType, Traits, Allocator>&& operator+ (
            const basic_string<CharType, Traits, Allocator>&& _Left,
            CharType _Right
        );
    template<class CharType, class Traits, class Allocator>
        basic_string<CharType, Traits, Allocator>&& operator+ (
            const CharType *_Left,
            const basic_string<CharType, Traits, Allocator>&& _Right
        );
    template<class CharType, class Traits, class Allocator>
        basic_string<CharType, Traits, Allocator>&& operator+ (
            CharType _Left,
            const basic_string<CharType, Traits, Allocator>&& _Right
        );
    template<class CharType, class Traits, class Allocator>
        bool operator== (
            const basic_string<CharType, Traits, Allocator>& _Left,
            const basic_string<CharType, Traits, Allocator>& _Right
        );
    template<class CharType, class Traits, class Allocator>
        bool operator== (
            const basic_string<CharType, Traits, Allocator>& _Left,
            const CharType *_Right
        );
    template<class CharType, class Traits, class Allocator>
        bool operator== (
            const CharType *_Left, 
            const basic_string<CharType, Traits, Allocator>& _Right
        );
    template<class CharType, class Traits, class Allocator>
        bool operator!= (
            const basic_string<CharType, Traits, Allocator>& _Left,
            const basic_string<CharType, Traits, Allocator>& _Right
        );
    template<class CharType, class Traits, class Allocator>
        bool operator!= (
            const basic_string<CharType, Traits, Allocator>& left,
            const CharType *_Right
        );
    template<class CharType, class Traits, class Allocator>
        bool operator!= (
            const CharType *_Left,
            const basic_string<CharType, Traits, Allocator>& _Right
        );
    template<class CharType, class Traits, class Allocator>
        bool operator< (
            const basic_string<CharType, Traits, Allocator>& _Left,
            const basic_string<CharType, Traits, Allocator>& _Right
        );
    template<class CharType, class Traits, class Allocator>
        bool operator< (
            const basic_string<CharType, Traits, Allocator>& _Left,
            const CharType *_Right
        );
    template<class CharType, class Traits, class Allocator>
        bool operator< (
            const CharType *_Left,
            const basic_string<CharType, Traits, Allocator>& _Right
        );
    template<class CharType, class Traits, class Allocator>
        bool operator>= (
            const basic_string<CharType, Traits, Allocator>& _Left,
            const basic_string<CharType, Traits, Allocator>& _Right
        );
    template<class CharType, class Traits, class Allocator>
        bool operator>= (
            const basic_string<CharType, Traits, Allocator>& _Left,
            const CharType *_Right
        );
    template<class CharType, class Traits, class Allocator>
        bool operator>= (
            const CharType *_Left,
            const basic_string<CharType, Traits, Allocator>& _Right
        );
    template<class CharType, class Traits, class Allocator>
        bool operator> (
            const basic_string<CharType, Traits, Allocator>& _Left,
            const basic_string<CharType, Traits, Allocator>& _Right
        );
    template<class CharType, class Traits, class Allocator>
        bool operator> (
            const basic_string<CharType, Traits, Allocator>& _Left,
            const CharType *_Right
        );
    template<class CharType, class Traits, class Allocator>
        bool operator> (
            const CharType *_Left,
            const basic_string<CharType, Traits, Allocator>& _Right
        );
    template<class CharType, class Traits, class Allocator>
        bool operator<= (
            const basic_string<CharType, Traits, Allocator>& _Left,
            const basic_string<CharType, Traits, Allocator>& _Right
        );
    template<class CharType, class Traits, class Allocator>
        bool operator<= (
            const basic_string<CharType, Traits, Allocator>& _Left,
            const CharType *_Right
        );
    template<class CharType, class Traits, class Allocator>
        bool operator<= (
            const CharType *_Left,
            const basic_string<CharType, Traits, Allocator>& _Right
        );
    template<class CharType, class Traits, class Allocator>
        void swap (
            basic_string<CharType, Traits, Allocator>& _Left,
            basic_string<CharType, Traits, Allocator>& _Right
        );
    template<class CharType, class Traits, class Allocator>
        basic_ostream<CharType>& operator<< (
            basic_ostream<CharType>& _OStream,
            const basic_string<CharType, Traits, Allocator>& _Str
        );
    template<class CharType, class Traits, class Allocator>
        basic_istream<CharType>& operator>> (
            basic_istream<CharType>& _IStream,
            basic_string<CharType, Traits, Allocator>& _Str
        );
    template<class CharType, class Traits, class Allocator>
        basic_istream<CharType, Traits>& getline (
            basic_istream<CharType, Traits>& _IStream,
            basic_string<CharType, Traits, Allocator>& _Str
        );
     template<class CharType, class Traits, class Allocator>
        basic_istream<CharType, Traits>& getline (
            basic_istream<CharType, Traits>& _IStream,
            basic_string<CharType, Traits, Allocator>& _Str,
            CharType _Delimiter
        );
     template<class CharType, class Traits, class Allocator>
        basic_istream<CharType, Traits>& getline (
            basic_istream<CharType, Traits>&& _IStream,
            basic_string<CharType, Traits, Allocator>& _Str
        ); 
     template<class CharType, class Traits, class Allocator>
        basic_istream<CharType, Traits>& getline (
            basic_istream<CharType, Traits>&& _IStream,
            basic_string<CharType, Traits, Allocator>& _Str,
            CharType _Delimiter
        );
}  // namespace std

Parametreler

CharType
Karakter veri türünü açıklayan şablon parametresi.
Nitelikler
Tüm özelliklerini açıklayan şablon parametresi CharType karakter veri.
Ayırıcı
Saklı bellek ayırıcısı nesneyi tanımlayan şablon parametresi.
_Str
basic_string Destekleyen CharType karakter veri.
_Val
Dönüştürülecek değer.
_Idx
Dönüştürülmeyen ilk karakter dizin değeri.
_Base
Kullanılacak numarasını temel.
_IStream
Destekleyen giriş akışı CharType karakter veri.
_OStream
Destekleyen çıktı akımına CharType karakter veri.
_Delimiter
Çizgi sınırlayıcısı.
_Left
İlk (solda) karşılaştırmak parametresi, ya da bir basic_string ya da karakter verisi.
_Right
İkinci (sağ) karşılaştırmak parametresi, ya da bir basic_string ya da karakter verisi.

Notlar

Standart C++ Kitaplığı ve C++ dili dizeleri iki tür destekler:

Biten karakter dizileri genellikle c dizeleri olarak da adlandırılır.
Şablon türü sınıf nesneleri basic_string, tanıtıcı tüm char-şablon değişkenlerini ister.

TypeDef

string	Şablon sınıfının uzmanlığı açıklayan türü basic_string türdeki öğeleri ile char olarak bir string.
wstring	Şablon sınıfının uzmanlığı açıklayan türü basic_string türdeki öğeleri ile wchar_t olarak bir wstring.
u16string	Şablon sınıfının uzmanlığı açıklayan türü basic_string türdeki öğeleri alarak char16_t.
u32string	Şablon sınıfının uzmanlığı açıklayan türü basic_string türdeki öğeleri alarak char32_t.

İşleçler

operator +	İki dizeyi nesneleri birleştirir.
operator! =	Sınamaları string nesnesi işlecinin sol tarafındaki sağ tarafındaki string nesnesi eşit değildir.
operator ==	Sağ taraftaki string nesnesi işlecinin sol tarafındaki string nesnesi eşitse sınamaları.
Operatör <	String nesnesi işlecinin sol tarafındaki çok az ise sınar sağ tarafındaki string nesnesi.
Operatör < =	Dize işleci sol tarafta nesnesinin sınamaları küçük veya eşit string nesnesi için sağ tarafında olur.
Operatör <<	Çıktı akımına bir dize ekler şablon işlevi.
işleç >	String nesnesi işlecinin sol tarafındaki sağ tarafındaki string nesnesine büyükse sınar.
işleç > =	String nesnesi işlecinin sol tarafındaki büyük veya eşit dize nesneye sağ tarafta ise sınar.
Operatör >>	Bir dize girdiden ayıklar şablon işlevi.

Özel şablon işlevleri

takas	İki dizeyi karakter dizileri değiş tokuş eder.
stod	Bir karakter sırası dönüştüren birdouble.
stof	Bir karakter sırası dönüştüren bir float.
stoi	Karakter sırasının bir tamsayıya dönüştürür.
stold	Bir karakter sırası dönüştüren bir long double.
stoll	Bir karakter sırası dönüştüren bir long long.
stoul	Bir karakter sırası dönüştüren bir unsigned long.
stoull	Bir karakter sırası dönüştüren bir unsigned long long.
to_string	Bir değere dönüştüren bir string.
to_wstring	Bir geniş bir değere dönüştüren string.

İşlevler

getline

Dizeleri gelen giriş akışı satır satır ayıklayın.

Sınıflar

basic_string Class	Açıklayan bir şablon sınıfıyla, rasgele karakter benzeri nesneleri dizisini depolamak nesneleri.
char_traits Struct	CharType türünde bir karakteri ile ilişkili öznitelikleri açıklayan bir şablon sınıfı

Specializations

char_traits<char> Struct	Şablon yapı uzmanlığı olan bir yapı char_traits<CharType> bir öğe türü için char.
char_traits<wchar_t> Struct	Şablon yapı uzmanlığı olan bir yapı char_traits<CharType> bir öğe türü için wchar_t.
char_traits<char16_t> Struct	Şablon yapı uzmanlığı olan bir yapı char_traits<CharType> bir öğe türü için char16_t.
char_traits<char32_t> Struct	Şablon yapı uzmanlığı olan bir yapı char_traits<CharType> bir öğe türü için char32_t.

Gereksinimler

Başlık: <string>
Namespace: std

Ayrıca bkz.

Başvuru

Standart C++ Kitaplığı'nda iş parçacığı güvenliği

Diğer Kaynaklar

Üstbilgi dosyaları

Aracılığıyla paylaş