이 페이지에서

QStringRef Class

QStringRef 클래스는 ` QString `의 부분 문자열을 감싸는 간단한 래퍼를 제공합니다. 더 보기...

헤더: #include <QStringRef>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core5Compat)
target_link_libraries(mytarget PRIVATE Qt6::Core5Compat)
qmake: QT += core5compat

참고: 이 클래스의 모든 함수는 재진입 가능합니다.

공개 유형

공개 함수

QStringRef()
QStringRef(const QString *string)
QStringRef(const QString *string, qsizetype position, qsizetype length)
QStringRef(const QStringRef &other)
~QStringRef()
QStringRef appendTo(QString *string) const
const QChar at(int position) const
QChar back() const
QStringRef::const_iterator begin() const
QStringRef::const_iterator cbegin() const
QStringRef::const_iterator cend() const
void chop(int n)
QStringRef chopped(int len) const
void clear()
int compare(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int compare(QLatin1String other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int compare(const QByteArray &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int compare(const QString &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int compare(const QStringRef &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
QStringRef::const_iterator constBegin() const
const QChar *constData() const
QStringRef::const_iterator constEnd() const
bool contains(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool contains(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool contains(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool contains(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool contains(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int count() const
int count(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int count(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int count(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
QStringRef::const_reverse_iterator crbegin() const
QStringRef::const_reverse_iterator crend() const
const QChar *data() const
QStringRef::const_iterator end() const
bool endsWith(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool endsWith(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool endsWith(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool endsWith(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool endsWith(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
QChar front() const
int indexOf(QLatin1String str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int indexOf(const QString &str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int indexOf(QChar ch, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int indexOf(QStringView str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int indexOf(const QStringRef &str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool isEmpty() const
bool isNull() const
bool isRightToLeft() const
int lastIndexOf(const QString &str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int lastIndexOf(QChar ch, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int lastIndexOf(QLatin1String str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int lastIndexOf(QStringView str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int lastIndexOf(const QStringRef &str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
QStringRef left(int n) const
int length() const
int localeAwareCompare(const QString &other) const
int localeAwareCompare(const QStringRef &other) const
QStringRef mid(int position, int n = -1) const
int position() const
QStringRef::const_reverse_iterator rbegin() const
QStringRef::const_reverse_iterator rend() const
QStringRef right(int n) const
int size() const
QList<QStringRef> split(const QString &sep, Qt::SplitBehavior behavior = Qt::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
QList<QStringRef> split(QChar sep, Qt::SplitBehavior behavior = Qt::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool startsWith(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool startsWith(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool startsWith(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool startsWith(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool startsWith(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
const QString *string() const
double toDouble(bool *ok = nullptr) const
float toFloat(bool *ok = nullptr) const
int toInt(bool *ok = nullptr, int base = 10) const
QByteArray toLatin1() const
QByteArray toLocal8Bit() const
long toLong(bool *ok = nullptr, int base = 10) const
qlonglong toLongLong(bool *ok = nullptr, int base = 10) const
short toShort(bool *ok = nullptr, int base = 10) const
QString toString() const
uint toUInt(bool *ok = nullptr, int base = 10) const
ulong toULong(bool *ok = nullptr, int base = 10) const
qulonglong toULongLong(bool *ok = nullptr, int base = 10) const
ushort toUShort(bool *ok = nullptr, int base = 10) const
QList<uint> toUcs4() const
QByteArray toUtf8() const
QStringRef trimmed() const
void truncate(int position)
const QChar *unicode() const
bool operator!=(const char *s) const
bool operator<(const char *s) const
bool operator<=(const char *s) const
QStringRef &operator=(const QString *string)
QStringRef &operator=(const QStringRef &other)
bool operator==(const char *s) const
bool operator>(const char *s) const
bool operator>=(const char *s) const
QChar operator[](int position) const

정적 공용 멤버

int compare(const QStringRef &s1, const QString &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)
int compare(const QStringRef &s1, QLatin1String s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)
int compare(const QStringRef &s1, const QStringRef &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)
int localeAwareCompare(const QStringRef &s1, const QString &s2)
int localeAwareCompare(const QStringRef &s1, const QStringRef &s2)
bool operator<(const QStringRef &s1, const QStringRef &s2)
bool operator<=(const QStringRef &s1, const QStringRef &s2)
bool operator==(QLatin1String s1, const QStringRef &s2)
bool operator==(const QString &s1, const QStringRef &s2)
bool operator==(const QStringRef &s1, const QStringRef &s2)
bool operator>(const QStringRef &s1, const QStringRef &s2)
bool operator>=(const QStringRef &s1, const QStringRef &s2)

상세 설명

QStringRef는 QString API의 읽기 전용 하위 집합을 제공합니다.

문자열 참조는 주어진 ` size()`를 사용하여 ` string()`의 특정 부분(특정 ` position()`부터 시작)을 명시적으로 참조합니다. ` toString()`를 호출하면 데이터의 복사본이 실제 ` QString ` 인스턴스로 반환됩니다.

이 클래스는 기존 QString 인스턴스에서 얻은 부분 문자열을 조작할 때 부분 문자열 처리 성능을 향상시키기 위해 설계되었습니다. QStringRef는 원본 문자열의 일부를 단순히 참조함으로써 표준 QString 의 메모리 할당 및 참조 카운팅 오버헤드를 피합니다. 이는 파서와 같이 저수준 코드에서 유용할 수 있지만, 코드가 잠재적으로 더 복잡해질 수 있다는 단점이 있습니다.

대부분의 사용자에게는 QStringRef가 메모리 관리 문제에 주의를 기울여야 하고, 이로 인해 코드를 작성하고 유지 관리하는 것이 더 복잡해질 수 있으므로, QString 대신 QStringRef를 사용하는 데 의미론적인 이점은 없습니다.

경고: QStringRef는 참조되는 문자열이 존재하는 동안에만 유효합니다. 원본 문자열이 삭제되면, 해당 문자열 참조는 유효하지 않은 메모리 위치를 가리키게 됩니다.

프로파일링을 통해 표준 문자열 연산을 이 클래스가 제공하는 최적화된 부분 문자열 처리 기능으로 대체함으로써 성능 향상이 가능하다는 것이 명확하게 확인된 안정적인 코드에서만 이 클래스를 사용할 것을 권장합니다.

보안 고려 사항

이 클래스는 int 를 사용하여 size() 및 position()를 저장합니다. 그 결과, INT_MAX 보다 길거나 더 큰 오프셋에서 시작하는 문자열의 일부를 표현할 수 없습니다. 이러한 부분을 참조하려고 시도하는 것은 정의되지 않은 동작입니다. 명시적인 크기가 전달되지 않더라도, QString 의 크기가 INT_MAX 를 초과하는 경우 QString 를 통한 QStringRef 생성에도 영향을 미친다는 점에 유의하십시오.

대신 QStringView 를 사용하십시오. 단, 이 클래스의 소유권 모델은 QStringRef보다 덜 엄격하다는 점을 유의하십시오. 자세한 내용은 포팅 가이드를 참조하십시오.

'암시적으로 공유되는 클래스'항목도 참조하십시오 .

멤버 유형 문서

QStringRef::const_iterator

QStringRef::const_reverse_iterator도 참조하십시오 .

QStringRef::const_reverse_iterator

QStringRef::const_iterator도 참조하십시오 .

멤버 함수 설명서

[constexpr noexcept] QStringRef::QStringRef()

빈 문자열 참조를 생성합니다.

QStringRef::QStringRef(const QString *string)

지정된 ` string`에 대한 문자열 참조를 생성합니다.

경고: QStringRef는 int (32비트)를 사용하여 size()를 표현합니다. Qt 6에서는 QString 의 크기가 qsizetype 로 표현되며, 64비트 빌드에서는 64비트입니다. 입력 값의 크기가 32비트 내에 들어가는지 확인하십시오. 그렇지 않으면 the behavior is undefined 오류가 발생합니다.

QStringRef::QStringRef(const QString *string, qsizetype position, qsizetype length)

주어진 string 내의 문자 범위 중, 시작 position 와 length 로 지정된 문자들에 대한 문자열 참조를 생성합니다.

경고: 이 함수는 성능을 최대한 향상시키기 위해 존재하며, 경계 검사를 수행하지 않습니다. 프로그램의 정확성을 위해 position 과 length 는 string 의 유효한 부분 문자열을 나타내야 하며, int 에서 표현 가능해야 합니다.

즉, 시작 인덱스 position 는 양수이거나 0이어야 하며 string 의 길이보다 작아야 하고, length 는 양수이거나 0이어야 하지만 문자열의 길이에서 시작 인덱스 position 를 뺀 값보다 작아야 합니다. 다시 말해, 0 <= position < string->length() 및 0 <= length <= string->length() - position이라는 두 조건이 모두 충족되어야 합니다.

경고: Qt 6.12부터 이 생성자는 int 대신 qsizetype, position 및 length 을 받습니다. 이는 호출 측에서 은밀한 형 변환이 발생하는 것을 방지합니다. 그러나 int 로 표현할 수 없는 값을 전달하면 여전히 undefined behavior 가 발생합니다.

[implicit] QStringRef::QStringRef(const QStringRef &other)

other 문자열 참조의 복사본을 생성합니다.

[noexcept implicit] QStringRef::~QStringRef()

문자열 참조를 소멸시킵니다.

이 클래스는 문자열 데이터를 참조하는 용도로만 사용되며, 해당 데이터에 대한 소유권을 가지지 않으므로 인스턴스가 소멸될 때 메모리가 해제되지 않습니다.

QStringRef QStringRef::appendTo(QString *string) const

string 에 문자열 참조를 추가하고, 결합된 문자열 데이터에 대한 새로운 참조를 반환합니다.

const QChar QStringRef::at(int position) const

문자열 참조에서 지정된 인덱스 position 에 있는 문자를 반환합니다.

position 는 문자열 내에서 유효한 인덱스 위치여야 합니다(즉, 0 <= position < size()).

QChar QStringRef::back() const

문자열의 마지막 문자를 반환합니다. ` at(size() - 1)`와 동일합니다.

이 함수는 STL 호환성을 위해 제공됩니다.

경고: 빈 문자열에 대해 이 함수를호출하면 정의되지 않은 동작이 발생합니다.

front(), at(), operator[]()도 참조하십시오 .

QStringRef::const_iterator QStringRef::begin() const

문자열의 첫 번째 문자를 가리키는 STL 스타일의 const 이터레이터를 반환합니다.

cbegin(), constBegin(), end(), constEnd(), rbegin(), rend()도 참조하십시오 .

QStringRef::const_iterator QStringRef::cbegin() const

begin()과 동일합니다.

begin(), constBegin(), cend(), constEnd(), rbegin(), rend()도 참조하십시오 .

QStringRef::const_iterator QStringRef::cend() const

end()와 동일합니다.

end(), constEnd(), cbegin(), constBegin(), rbegin(), rend()도 참조하십시오 .

[noexcept] void QStringRef::chop(int n)

문자열의 끝에서 ` n ` 문자를 제거합니다.

n 가 size()보다 크거나 같으면 결과는 빈 문자열이 되며, n 가 음수인 경우 0을 전달한 것과 동일합니다.

QString::chop() 및 truncate()도 참조하십시오 .

QStringRef QStringRef::chopped(int len) const

이 문자열의 가장 왼쪽에 위치한 size() - len 개의 문자에 대한 부분 문자열 참조를 반환합니다.

참고: ` len `가 음수이거나 ` size`보다 큰 경우,동작이 정의되지 않습니다.

참조: endsWith(), left(), right(), mid(), chop(), truncate().

void QStringRef::clear()

문자열 참조의 내용을 null로 설정하고 내용을 비워 해당 참조의 내용을 지웁니다.

isEmpty() 및 isNull()도 참조하십시오 .

[static noexcept] int QStringRef::compare(const QStringRef &s1, const QString &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

s1 와 s2 를 비교하여, s1 가 s2 보다 작으면 음의 정수를, 가 s2 보다 크면 양의 정수를, 둘이 같으면 0을 반환합니다.

cs 가 Qt::CaseSensitive 인 경우, 비교는 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

[noexcept] int QStringRef::compare(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

*this 와 ch 를 비교하여, *this 가 ch 보다 작으면 음의 정수를, 가 ch 보다 크면 양의 정수를, 두 값이 같으면 0을 반환합니다. 여기서 ch 는 길이가 1인 문자열로 해석됩니다.

cs 가 Qt::CaseSensitive 일 경우, 비교는 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

이 함수는 오버로드된 함수입니다.

[noexcept] int QStringRef::compare(QLatin1String other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

*this 와 other 를 비교하여, *this 가 other 보다 작으면 음의 정수를, other 보다 크면 양의 정수를, 둘이 같으면 0을 반환합니다.

cs 가 Qt::CaseSensitive 인 경우, 비교는 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

compare(*this, other, cs) 와 동일합니다.

이 함수는 오버로드된 함수입니다.

[noexcept] int QStringRef::compare(const QByteArray &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

*this 와 other 를 비교하여, *this 가 other 보다 작으면 음의 정수를, 가 other 보다 크면 양의 정수를, 둘이 같으면 0을 반환합니다. other 의 내용은 UTF-8로 해석됩니다.

cs 가 Qt::CaseSensitive 인 경우 대소문자를 구분하여 비교하며, 그렇지 않은 경우 대소문자를 구분하지 않고 비교합니다.

compare(*this, other, cs) 와 동일합니다.

이 함수는 오버로드된 함수입니다.

[noexcept] int QStringRef::compare(const QString &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

*this 와 other 를 비교하여, *this 가 other 보다 작으면 음의 정수를, 가 other 보다 크면 양의 정수를, 두 값이 같으면 0을 반환합니다.

cs 가 Qt::CaseSensitive 인 경우, 비교는 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

compare(*this, other, cs) 와 동등합니다.

이 함수는 오버로드된 함수입니다.

[noexcept] int QStringRef::compare(const QStringRef &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

*this 와 other 를 비교하여, *this 가 other 보다 작으면 음의 정수를, 가 other 보다 크면 양의 정수를, 둘이 같으면 0을 반환합니다.

cs 가 Qt::CaseSensitive 인 경우 대소문자를 구분하여 비교하며, 그렇지 않은 경우 대소문자를 구분하지 않고 비교합니다.

compare(*this, other, cs) 와 동등합니다.

이 함수는 오버로드된 함수입니다.

[static noexcept] int QStringRef::compare(const QStringRef &s1, QLatin1String s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

s1 와 s2 를 비교하여, s1 가 s2 보다 작으면 음의 정수를, 가 s2 보다 크면 양의 정수를, 둘이 같으면 0을 반환합니다.

cs 가 Qt::CaseSensitive 인 경우, 비교는 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

이 함수는 오버로드된 함수입니다.

[static noexcept] int QStringRef::compare(const QStringRef &s1, const QStringRef &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

s1 와 s2 를 비교하여, s1 가 s2 보다 작으면 음의 정수를, 가 s2 보다 크면 양의 정수를, 둘이 같으면 0을 반환합니다.

cs 가 Qt::CaseSensitive 인 경우 대소문자를 구분하여 비교하며, 그렇지 않은 경우 대소문자를 구분하지 않고 비교합니다.

이 함수는 오버로드된 함수입니다.

QStringRef::const_iterator QStringRef::constBegin() const

begin()와 동일합니다.

begin(), cend(), constEnd(), rbegin(), rend()도 참조하십시오 .

const QChar *QStringRef::constData() const

unicode()와 동일합니다.

QStringRef::const_iterator QStringRef::constEnd() const

end()와 동일합니다.

end(), cend(), cbegin(), constBegin(), rbegin(), rend()도 참조하십시오 .

bool QStringRef::contains(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열 참조에 “ str ” 문자열이 포함되어 있으면 “ true ”을 반환하고, 그렇지 않으면 “ false ”을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

indexOf() 및 count()도 참조하십시오 .

bool QStringRef::contains(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열에 ch 문자가 포함되어 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우, 검색은 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

이 함수는 QStringRef::contains()를 오버로드합니다.

bool QStringRef::contains(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열 참조에 “ str ”이라는 문자열이 포함되어 있으면 “ true ”을 반환하고, 그렇지 않으면 “ false ”을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우, 검색은 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

이 함수는 QStringRef::contains()를 오버로드합니다.

indexOf() 및 count()도 참조하십시오 .

[noexcept] bool QStringRef::contains(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열 참조에 “ str ” 문자열이 포함되어 있으면 “ true ”을 반환하고, 그렇지 않으면 “ false ”을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

이 함수는 QStringRef::contains()을 오버로드합니다.

indexOf() 및 count()도 참조하십시오 .

bool QStringRef::contains(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열 참조에 str 문자열 참조가 포함되어 있으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우, 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

이 함수는 QStringRef::contains()을 오버로드합니다.

indexOf() 및 count()도 참조하십시오 .

int QStringRef::count() const

문자열 참조가 가리키는 문자 수를 반환합니다. size() 및 length()과 동일합니다.

position() 및 string()도 참조하십시오 .

int QStringRef::count(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열 참조에서 “ str ” 문자열이 (중복될 수 있는) 몇 번 나타나는지 그 횟수를 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

QString::count(), contains(), indexOf()도 참조하십시오 .

int QStringRef::count(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

문자열 참조 내에서 ‘ ch ’ 문자가 나타나는 횟수를 반환합니다.

cs 가 ` Qt::CaseSensitive `(기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

이 함수는 QStringRef::count()을 오버로드합니다.

QString::count(), contains() 및 indexOf()도 참조하십시오 .

int QStringRef::count(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열 참조 내에서 문자열 참조 str 가 (중복될 수 있는) 몇 번 나타나는지 반환합니다.

cs 가 ` Qt::CaseSensitive `(기본값)인 경우, 검색은 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

이 함수는 QStringRef::count()을 오버로드합니다.

QString::count(), contains() 및 indexOf()도 참조하십시오 .

QStringRef::const_reverse_iterator QStringRef::crbegin() const

rbegin()와 동일합니다.

begin(), rbegin() 및 rend()도 참조하십시오 .

QStringRef::const_reverse_iterator QStringRef::crend() const

rend()와 동일합니다.

end(), rend() 및 rbegin()도 참조하십시오 .

const QChar *QStringRef::data() const

unicode()와 동일합니다.

QStringRef::const_iterator QStringRef::end() const

목록의 마지막 문자 다음에 오는 가상의 문자를 가리키는 const STL 스타일 이터레이터를 반환합니다.

cbegin(), constBegin(), end(), constEnd(), rbegin() 및 rend()도 참조하십시오 .

bool QStringRef::endsWith(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

문자열 참조가 str 로 끝나는 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

QString::endsWith() 및 startsWith()도 참조하십시오 .

bool QStringRef::endsWith(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

문자열 참조가 ch 로 끝나는 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우, 검색은 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

이 함수는 QStringRef::endsWith()을 오버로드합니다.

QString::endsWith() 및 endsWith()도 참조하십시오 .

bool QStringRef::endsWith(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 함수는 ` QStringRef::endsWith()`를 오버로드합니다.

QString::endsWith() 및 endsWith()도 참조하십시오 .

[noexcept] bool QStringRef::endsWith(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 함수는 ` QStringRef::endsWith()`를 오버로드합니다.

QString::endsWith() 및 startsWith()도 참조하십시오 .

bool QStringRef::endsWith(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 함수는 ` QStringRef::endsWith()`를 오버로드합니다.

QString::endsWith() 및 endsWith()도 참조하십시오 .

QChar QStringRef::front() const

문자열의 첫 번째 문자를 반환합니다. at(0) 과 동일합니다.

이 함수는 STL 호환성을 위해 제공됩니다.

경고: 빈 문자열에 대해 이 함수를호출하면 정의되지 않은 동작이 발생합니다.

참조: back(), at(), operator[]().

int QStringRef::indexOf(QLatin1String str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열 참조에서 “ str ” 문자열이 처음 나타나는 인덱스 위치를 반환하며, 검색은 “ from ” 인덱스 위치부터 앞으로 진행됩니다. “ str ”이 발견되지 않으면 -1을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

from 가 -1이면 검색은 마지막 문자로부터 시작하고, -2이면 마지막에서 두 번째 문자로부터 시작하는 식으로 진행됩니다.

QString::indexOf(), lastIndexOf(), contains(), count()도 참조하십시오 .

int QStringRef::indexOf(const QString &str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열 참조에서 str 문자열이 처음 나타나는 인덱스 위치를 반환하며, 검색은 from 인덱스 위치부터 앞으로 진행됩니다. str 가 발견되지 않으면 -1을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

from 가 -1이면 검색은 마지막 문자로부터 시작하고, -2이면 마지막에서 두 번째 문자로부터 시작하는 식으로 진행됩니다.

QString::indexOf(), lastIndexOf(), contains(), count()도 참조하십시오 .

int QStringRef::indexOf(QChar ch, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

문자열 참조 내에서 문자 ch 가 처음 나타나는 인덱스 위치를 반환하며, 인덱스 위치 from 부터 앞으로 검색합니다. ch 을 찾을 수 없는 경우 -1을 반환합니다.

이 함수는 QStringRef::indexOf()을 오버로드합니다.

QString::indexOf(), lastIndexOf(), contains() 및 count()도 참조하십시오 .

[noexcept] int QStringRef::indexOf(QStringView str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열 참조에서 “ str ” 문자열이 처음 나타나는 인덱스 위치를 반환하며, 검색은 인덱스 위치 “ from ”부터 앞으로 진행됩니다. “ str ”이 발견되지 않으면 -1을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

from 가 -1이면 검색은 마지막 문자로부터 시작하고, -2이면 두 번째 마지막 문자로부터 시작하는 식입니다.

이 함수는 QStringRef::indexOf()을 오버로드합니다.

QString::indexOf(), QStringView::indexOf(), lastIndexOf(), contains() 및 count()도 참조하십시오 .

int QStringRef::indexOf(const QStringRef &str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열 참조에서 str 가 처음 나타나는 위치의 인덱스를 반환하며, 검색은 from 인덱스 위치부터 앞으로 진행됩니다. str 가 발견되지 않으면 -1을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하고, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

이 함수는 QStringRef::indexOf()을 오버로드합니다.

QString::indexOf(), lastIndexOf(), contains() 및 count()도 참조하십시오 .

bool QStringRef::isEmpty() const

문자열 참조에 문자가 없으면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.

문자열 참조의 크기가 0이면 해당 참조는 비어 있는 것으로 간주됩니다.

size()도 참조하십시오 .

bool QStringRef::isNull() const

이 문자열 참조가 문자열을 가리키지 않거나, 가리키는 문자열이 null인 경우(즉, ` QString::isNull()`의 결과가 true인 경우), ` true `를 반환합니다.

size()도 참조하십시오 .

bool QStringRef::isRightToLeft() const

문자열이 오른쪽에서 왼쪽으로 읽히는 경우 true 를 반환합니다.

QString::isRightToLeft()도 참조하십시오 .

int QStringRef::lastIndexOf(const QString &str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열 참조에서 “ str ” 문자열이 마지막으로 나타나는 인덱스 위치를 반환하며, 검색은 “ from ” 인덱스 위치에서 역방향으로 진행됩니다. “ from ”이 -1(기본값)인 경우 검색은 마지막 문자에서 시작되며, “ from ”이 -2인 경우 마지막에서 두 번째 문자에서 시작하는 식입니다. “ str ”이 발견되지 않으면 -1을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

QString::lastIndexOf(), indexOf(), contains(), count()도 참조하십시오 .

int QStringRef::lastIndexOf(QChar ch, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

from 위치에서 역방향으로 검색하여 문자 ch 가 마지막으로 나타나는 위치의 인덱스를 반환합니다.

이 함수는 QStringRef::lastIndexOf()을 오버로드합니다.

QString::lastIndexOf(), indexOf(), contains() 및 count()도 참조하십시오 .

int QStringRef::lastIndexOf(QLatin1String str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열 참조에서 “ str ” 문자열이 마지막으로 나타나는 인덱스 위치를 반환하며, 검색은 “ from ” 인덱스 위치에서 역방향으로 진행됩니다. “ from ”가 -1(기본값)인 경우 검색은 마지막 문자로부터 시작되며, “ from ”가 -2인 경우 두 번째 마지막 문자로부터 시작하는 식으로 진행됩니다. “ str ”이 발견되지 않으면 -1을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우, 검색은 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

이 함수는 QStringRef::lastIndexOf()을 오버로드합니다.

QString::lastIndexOf(), indexOf(), contains(), count()도 참조하십시오 .

[noexcept] int QStringRef::lastIndexOf(QStringView str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열에서 “ str ”라는 문자열이 마지막으로 나타나는 인덱스 위치를 반환하며, 검색은 인덱스 위치 “ from ”부터 뒤로 진행됩니다. “ from ”가 -1(기본값)인 경우, 검색은 마지막 문자에서 시작되며, “ from ”가 -2인 경우, 마지막에서 두 번째 문자에서 시작하는 식으로 진행됩니다. “ str ”가 발견되지 않으면 -1을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우, 검색은 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

이 함수는 QStringRef::lastIndexOf()을 오버로드합니다.

indexOf(), contains() 및 count()도 참조하십시오 .

int QStringRef::lastIndexOf(const QStringRef &str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열 참조 내에서 “ str ”라는 문자열 참조가 마지막으로 나타나는 인덱스 위치를, 인덱스 위치 from 에서 역방향으로 검색하여 반환합니다. from 가 -1(기본값)인 경우 검색은 마지막 문자로부터 시작되며, from 가 -2인 경우에서 두 번째 마지막 문자로부터 시작하는 식으로 진행됩니다. str 가 발견되지 않으면 -1을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

이 함수는 QStringRef::lastIndexOf()을 오버로드합니다.

QString::lastIndexOf(), indexOf(), contains() 및 count()도 참조하십시오 .

QStringRef QStringRef::left(int n) const

문자열의 가장 왼쪽에 위치한 n 개의 문자에 대한 부분 문자열 참조를 반환합니다.

n 가 size()보다 크거나 같거나, 0보다 작은 경우, 문자열 전체에 대한 참조가 반환됩니다.

right(), mid(), startsWith(), chopped(), chop() 및 truncate()도 참조하십시오 .

int QStringRef::length() const

문자열 참조가 가리키는 문자 수를 반환합니다. size() 및 count()과 동일합니다.

position() 및 string()도 참조하십시오 .

[static] int QStringRef::localeAwareCompare(const QStringRef &s1, const QString &s2)

s1 s2 와 를 비교하여, 가 보다 작으면 음의 정수를, 가 보다 크면 양의 정수를, 둘이 같으면 0을 반환합니다. s2 s1 s2

비교는 로케일 및 플랫폼에 따라 수행됩니다. 이 함수를 사용하여 사용자에게 정렬된 문자열 목록을 표시할 수 있습니다.

compare(), QLocale 및 Comparing Strings도 참조하십시오 .

int QStringRef::localeAwareCompare(const QString &other) const

*this 와 other 를 비교하여, *this 가 other 보다 작으면 음의 정수를, other 보다 크면 양의 정수를, 둘이 같으면 0을 반환합니다.

비교는 로케일 및 플랫폼에 따라 수행됩니다. 이 함수를 사용하여 사용자에게 정렬된 문자열 목록을 표시할 수 있습니다.

이 함수는 오버로드된 함수입니다.

Comparing Strings도 참조하십시오 .

int QStringRef::localeAwareCompare(const QStringRef &other) const

*this other 와 을 비교하여, 가 보다 작으면 음의 정수를, 가 보다 크면 양의 정수를, 둘이 같으면 0을 반환합니다. other *this other

비교는 로케일 및 플랫폼에 따라 수행됩니다. 이 함수를 사용하여 사용자에게 정렬된 문자열 목록을 표시할 수 있습니다.

이 함수는 오버로드된 함수입니다.

Comparing Strings도 참조하십시오 .

[static] int QStringRef::localeAwareCompare(const QStringRef &s1, const QStringRef &s2)

s1 와 s2 을 비교하여, s1 이 s2 보다 작으면 음의 정수를, s2 보다 크면 양의 정수를, 둘이 같으면 0을 반환합니다.

비교는 로케일 및 플랫폼에 따라 수행됩니다. 이 함수를 사용하여 사용자에게 정렬된 문자열 목록을 표시할 수 있습니다.

이 함수는 오버로드된 함수입니다.

Comparing Strings도 참조하십시오 .

QStringRef QStringRef::mid(int position, int n = -1) const

지정된 시작 위치( position)부터 시작하여 이 문자열의 ` n ` 개 문자에 대한 부분 문자열 참조를 반환합니다.

position 가 문자열의 길이를 초과하는 경우, null 참조가 반환됩니다.

결과 position()을 int 로 표현할 수 없는 경우, null QStringRef 이 반환됩니다.

주어진 position 에서 시작하여 문자열에 사용 가능한 n 문자가 개 미만인 경우, 또는 n 가 -1(기본값)인 경우, 이 함수는 지정된 position 이후의 모든 문자를 반환합니다.

left(), right(), chopped(), chop(), truncate()도 참조하십시오 .

int QStringRef::position() const

문자열 참조가 가리키는 참조된 문자열 내의 시작 위치를 반환합니다.

size() 및 string()도 참조하십시오 .

QStringRef::const_reverse_iterator QStringRef::rbegin() const

문자열의 첫 번째 문자를 역순으로 가리키는 STL 스타일의 상수 역방향 이터레이터를 반환합니다.

begin(), crbegin(), rend()도 참조하십시오 .

QStringRef::const_reverse_iterator QStringRef::rend() const

문자열의 마지막 문자를 하나 건너뛴 위치(역순)를 가리키는 STL 스타일의 역방향 이터레이터를 반환합니다.

end(), crend(), rbegin()도 참조하십시오 .

문자열의 가장 오른쪽 n 개 문자에 대한 부분 문자열 참조를 반환합니다.

n 가 size()보다 크거나 같거나, 0보다 작은 경우, 전체 문자열에 대한 참조가 반환됩니다.

새로운 position()을 int 로 표현할 수 없는 경우, 전체 문자열에 대한 참조가 반환됩니다.

left(), mid(), endsWith(), chopped(), chop() 및 truncate()도 참조하십시오 .

int QStringRef::size() const

문자열 참조가 가리키는 문자 수를 반환합니다. length() 및 count()과 동일합니다.

position() 및 string()도 참조하십시오 .

QList<QStringRef> QStringRef::split(const QString &sep, Qt::SplitBehavior behavior = Qt::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

sep 가 나타나는 모든 위치에서 문자열을 부분 문자열로 분할하고, 해당 문자열들의 목록을 반환합니다.

sep, behavior 및 cs 가 어떻게 상호 작용하여 결과를 형성하는지에 대해서는 QString::split()을 참조하십시오.

참고: 이 문자열이 존재하는 한모든 참조는 유효합니다. 이 문자열을 소멸시키면 모든 참조가 매달린 포인터가 됩니다.

QList<QStringRef> QStringRef::split(QChar sep, Qt::SplitBehavior behavior = Qt::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이것은 오버로드된 함수입니다.

bool QStringRef::startsWith(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

문자열 참조가 str 로 시작하는 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우, 검색은 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

QString::startsWith() 및 endsWith()도 참조하십시오 .

bool QStringRef::startsWith(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

문자열 참조가 ch 로 시작하는 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우, 검색은 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

이 함수는 QStringRef::startsWith()을 오버로드합니다.

QString::startsWith() 및 endsWith()도 참조하십시오 .

bool QStringRef::startsWith(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 함수는 ` QStringRef::startsWith()`를 오버로드합니다.

QString::startsWith() 및 endsWith()도 참조하십시오 .

[noexcept] bool QStringRef::startsWith(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 함수는 ` QStringRef::startsWith()`를 오버로드합니다.

QString::startsWith() 및 endsWith()도 참조하십시오 .

bool QStringRef::startsWith(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 함수는 ` QStringRef::startsWith()`를 오버로드합니다.

QString::startsWith() 및 endsWith()도 참조하십시오 .

const QString *QStringRef::string() const

문자열 참조가 가리키는 문자열에 대한 포인터를 반환하며, 문자열을 참조하지 않는 경우에는 0을 반환합니다.

unicode()도 참조하십시오 .

double QStringRef::toDouble(bool *ok = nullptr) const

double 값으로 변환된 문자열을 반환합니다.

변환 시 오버플로우가 발생하면 무한대를, 다른 이유(예: 언더플로우)로 변환에 실패하면 0.0을 반환합니다.

ok 가 nullptr 가 아닌 경우, *ok 를 false 로 설정하여 실패를 알리고, *ok 를 true 로 설정하여 성공을 알립니다.

문자열 변환은 항상 'C' 로케일에서 수행됩니다. 로케일에 따라 달라지는 변환을 원할 경우 QLocale::toDouble()를 사용하십시오.

역사적인 이유로, 이 함수는 천 단위 구분자를 처리하지 않습니다. 이러한 숫자를 변환해야 하는 경우 QLocale::toDouble()를 사용하십시오.

QString::toDouble()도 참조하십시오 .

float QStringRef::toFloat(bool *ok = nullptr) const

float 값으로 변환된 문자열을 반환합니다.

변환 시 오버플로가 발생하면 무한대를, 다른 이유(예: 언더플로우)로 변환에 실패하면 0.0을 반환합니다.

ok 가 nullptr 가 아닌 경우, *ok 를 false 로 설정하여 실패를 보고하고, *ok 를 true 로 설정하여 성공을 보고합니다.

문자열 변환은 항상 'C' 로케일에서 수행됩니다. 로케일에 따라 달라지는 변환을 사용하려면 QLocale::toFloat()을 사용하십시오.

QString::toFloat()도 참조하십시오 .

int QStringRef::toInt(bool *ok = nullptr, int base = 10) const

기본값이 10이며 2에서 36 사이의 값 또는 0이어야 하는 기수 base 를 사용하여 문자열을 int 로 변환한 결과를 반환합니다. 변환에 실패하면 0을 반환합니다.

ok 가 nullptr 와 다를 경우, *ok 를 false 로 설정하여 실패를 알리고, *ok 를 true 로 설정하여 성공을 알립니다.

base 가 0인 경우, C 언어 규칙이 적용됩니다. 즉, 문자열이 "0x"로 시작하면 16진수가, "0"으로 시작하면 8진수가, 그 외의 경우에는 10진수가 사용됩니다.

문자열 변환은 항상 'C' 로케일에서 수행됩니다. 로케일에 따라 달라지는 변환을 원할 경우 QLocale::toInt()를 사용하십시오.

QString::toInt()도 참조하십시오 .

QByteArray QStringRef::toLatin1() const

문자열을 Latin-1 형식으로 변환하여 ` QByteArray`로 반환합니다.

문자열에 Latin-1이 아닌 문자가 포함되어 있는 경우, 반환되는 바이트 배열은 정의되지 않습니다. 이러한 문자는 생략되거나 물음표로 대체될 수 있습니다.

toUtf8(), toLocal8Bit(), QStringEncoder도 참조하십시오 .

QByteArray QStringRef::toLocal8Bit() const

문자열을 로컬 8비트 인코딩( QByteArray)으로 변환한 값을 반환합니다. 문자열에 로컬 8비트 인코딩에서 지원하지 않는 문자가 포함된 경우, 반환되는 바이트 배열의 값은 정의되지 않습니다.

유닉스 시스템에서는 이 함수가 ` toUtf8()`와 동일하게 동작하며, 윈도우에서는 시스템의 현재 코드 페이지가 사용됩니다.

이 문자열에 로케일에서 인코딩할 수 없는 문자가 포함되어 있는 경우, 반환되는 바이트 배열은 정의되지 않습니다. 해당 문자는 생략되거나 다른 문자로 대체될 수 있습니다.

toLatin1(), toUtf8() 및 QStringEncoder도 참조하십시오 .

long QStringRef::toLong(bool *ok = nullptr, int base = 10) const

기본값이 10이며 2에서 36 사이의 값 또는 0이어야 하는 기수( base)를 사용하여 10진수( long )로 변환된 문자열을 반환합니다. 변환에 실패하면 0을 반환합니다.

ok 가 nullptr 와 다를 경우, *ok 를 false 로 설정하여 실패를 알리고, *ok 를 true 로 설정하여 성공을 알립니다.

base 가 0인 경우, C 언어 규칙이 적용됩니다. 즉, 문자열이 "0x"로 시작하면 16진수를, "0"으로 시작하면 8진수를, 그 외의 경우에는 10진수를 사용합니다.

문자열 변환은 항상 'C' 로케일에서 수행됩니다. 로케일에 따라 달라지는 변환을 원할 경우 QLocale::toLong()를 사용하십시오.

QString::toLong()도 참조하십시오 .

qlonglong QStringRef::toLongLong(bool *ok = nullptr, int base = 10) const

기본값이 10이며 2에서 36 사이의 값 또는 0이어야 하는 기수 base 를 사용하여 문자열을 long long 로 변환한 결과를 반환합니다. 변환에 실패하면 0을 반환합니다.

ok 가 nullptr 와 다를 경우, *ok 를 false 로 설정하여 실패를 알리고, *ok 를 true 로 설정하여 성공을 알립니다.

base 가 0인 경우, C 언어의 규칙이 적용됩니다. 즉, 문자열이 "0x"로 시작하면 16진수가 사용되고, "0"으로 시작하면 8진수가 사용되며, 그 외의 경우에는 10진수가 사용됩니다.

문자열 변환은 항상 'C' 로케일에서 수행됩니다. 로케일에 따라 달라지는 변환을 원할 경우 QLocale::toLongLong()를 사용하십시오.

QString::toLongLong()도 참조하십시오 .

short QStringRef::toShort(bool *ok = nullptr, int base = 10) const

기본값이 10이며 2에서 36 사이의 값 또는 0이어야 하는 기수 base 를 사용하여 문자열을 short 로 변환한 결과를 반환합니다. 변환에 실패하면 0을 반환합니다.

ok 가 nullptr 와 다를 경우, *ok 를 false 로 설정하여 실패를 알리고, *ok 를 true 로 설정하여 성공을 알립니다.

base 가 0인 경우, C 언어 규칙이 적용됩니다. 즉, 문자열이 "0x"로 시작하면 16진수가, "0"으로 시작하면 8진수가, 그 외의 경우에는 10진수가 사용됩니다.

문자열 변환은 항상 'C' 로케일에서 수행됩니다. 로케일에 따라 달라지는 변환을 원할 경우 QLocale::toShort()를 사용하십시오.

QString::toShort()도 참조하십시오 .

QString QStringRef::toString() const

문자열 참조의 복사본을 QString 객체로 반환합니다.

문자열 참조가 문자열에 대한 완전한 참조가 아닌 경우(즉, ` position()`의 결과가 0이고 ` size()`의 결과가 ` string()` → `size()`인 경우), 이 함수는 반환할 새로운 문자열을 할당합니다.

string()도 참조하십시오 .

uint QStringRef::toUInt(bool *ok = nullptr, int base = 10) const

기본값이 10이며 2에서 36 사이의 값 또는 0이어야 하는 기수 base 을 사용하여 문자열을 unsigned int 로 변환한 결과를 반환합니다. 변환에 실패하면 0을 반환합니다.

ok 가 nullptr 와 다를 경우, *ok 를 false 로 설정하여 실패를 알리고, *ok 를 true 로 설정하여 성공을 알립니다.

base 가 0인 경우, C 언어 규칙이 적용됩니다. 즉, 문자열이 "0x"로 시작하면 16진수가 사용되고, "0"으로 시작하면 8진수가 사용되며, 그 외의 경우에는 10진수가 사용됩니다.

문자열 변환은 항상 'C' 로케일에서 수행됩니다. 로케일에 따라 변환을 수행하려면 QLocale::toUInt()를 사용하십시오.

QString::toUInt()도 참조하십시오 .

ulong QStringRef::toULong(bool *ok = nullptr, int base = 10) const

기본값인 10( base)을 사용하여 문자열을 unsigned long 로 변환한 결과를 반환합니다. 이 값은 2에서 36 사이의 정수여야 하며, 0도 허용됩니다. 변환에 실패하면 0을 반환합니다.

ok 가 nullptr 와 다를 경우, *ok 을 false 로 설정하여 실패를 알리고, *ok 을 true 로 설정하여 성공을 알립니다.

base 가 0인 경우, C 언어 규칙이 적용됩니다. 즉, 문자열이 "0x"로 시작하면 16진수가, "0"으로 시작하면 8진수가, 그 외의 경우에는 10진수가 사용됩니다.

문자열 변환은 항상 'C' 로케일에서 수행됩니다. 로케일에 의존하는 변환을 수행하려면 QLocale::toULongLong()를 사용하십시오.

QString::toULong()도 참조하십시오 .

qulonglong QStringRef::toULongLong(bool *ok = nullptr, int base = 10) const

기본값이 10이며 2에서 36 사이의 값이어야 하는 기수( base)를 사용하여 문자열을 10진수( unsigned long long )로 변환한 값을 반환합니다. 변환에 실패하면 0을 반환합니다.

ok 가 nullptr 와 다를 경우, *ok 를 false 로 설정하여 실패를 알리고, *ok 를 true 로 설정하여 성공을 알립니다.

base 가 0인 경우, C 언어 규칙이 적용됩니다. 즉, 문자열이 "0x"로 시작하면 16진수가, "0"으로 시작하면 8진수가, 그 외의 경우에는 10진수가 사용됩니다.

문자열 변환은 항상 'C' 로케일에서 수행됩니다. 로케일에 따라 달라지는 변환을 원할 경우 QLocale::toULongLong()을 사용하십시오.

QString::toULongLong()도 참조하십시오 .

ushort QStringRef::toUShort(bool *ok = nullptr, int base = 10) const

기본값이 10이며 2에서 36 사이의 값 또는 0이어야 하는 기수 base 을 사용하여 unsigned short 로 변환된 문자열을 반환합니다. 변환에 실패하면 0을 반환합니다.

ok 가 nullptr 와 다를 경우, *ok 를 false 로 설정하여 실패를 알리고, *ok 를 true 로 설정하여 성공을 알립니다.

base 가 0인 경우, C 언어 규칙이 적용됩니다. 문자열이 "0x"로 시작하면 16진수가, "0"으로 시작하면 8진수가, 그 외의 경우에는 10진수가 사용됩니다.

문자열 변환은 항상 'C' 로케일에서 수행됩니다. 로케일에 따라 달라지는 변환을 원할 경우 QLocale::toUShort()를 사용하십시오.

QString::toUShort()도 참조하십시오 .

QList<uint> QStringRef::toUcs4() const

문자열을 UCS-4/UTF-32 형식으로 변환한 값을 QList<uint>로 반환합니다.

UCS-4는 유니코드 코덱이므로 무손실입니다. 이 문자열의 모든 문자는 UCS-4로 인코딩됩니다. 이 문자열 내의 유효하지 않은 코드 유닛 시퀀스는 유니코드의 대체 문자(QChar::ReplacementCharacter, U+FFFD 에 해당)로 대체됩니다.

반환된 리스트는 \0 로 끝나지 않습니다.

toUtf8(), toLatin1(), toLocal8Bit() 및 QStringEncoder도 참조하십시오 .

QByteArray QStringRef::toUtf8() const

문자열의 UTF-8 표현을 ` QByteArray` 형식으로 반환합니다.

UTF-8은 유니코드 인코딩 방식이며, QString 와 같은 유니코드 문자열의 모든 문자를 표현할 수 있습니다.

toLatin1(), toLocal8Bit() 및 QStringEncoder도 참조하십시오 .

QStringRef QStringRef::trimmed() const

문자열의 앞뒤에서 공백을 제거한 문자열을 반환합니다.

공백이란 ` QChar::isSpace()` 함수가 ` true`를 반환하는 모든 문자를 의미합니다. 여기에는 ASCII 문자 '\t', '\n', '\v', '\f', '\r' 및 ' '가 포함됩니다.

QString::simplified()과 달리, trimmed()은 내부 공백은 그대로 둡니다.

공백을 제거한 후 생성된 새로운 position()을 int 로 표현할 수 없는 경우, 동작은 정의되지 않습니다.

QString::trimmed()도 참조하십시오 .

[noexcept] void QStringRef::truncate(int position)

지정된 position 인덱스에서 문자열을 잘라냅니다.

지정된 position 인덱스가 문자열의 끝을 넘어가는 경우, 아무런 동작도 수행되지 않습니다.

position 가 음수인 경우, 0을 전달하는 것과 동일합니다.

QString::truncate()도 참조하십시오 .

const QChar *QStringRef::unicode() const

문자열 참조의 유니코드 표현을 반환합니다. 데이터는 참조된 문자열에서 직접 파생되므로, 문자열 참조에 해당 문자열의 널 종결자가 포함되어 있지 않은 한, \0'로 끝나지 않습니다.

string()도 참조하십시오 .

[noexcept] bool QStringRef::operator!=(const char *s) const

s 상수 char 포인터는 fromUtf8() 함수를 사용하여 QStringRef 로 변환됩니다.

응용 프로그램을 컴파일할 때 ` QT_NO_CAST_FROM_ASCII `을 정의하면 이 연산자를 비활성화할 수 있습니다. 예를 들어, 사용자에게 표시되는 모든 문자열이 ` QObject::tr()`를 반드시 거치도록 보장하고자 할 때 이 방법이 유용할 수 있습니다.

이 문자열이 매개변수 문자열 s 과 어휘적으로 동일하지 않은 경우 true 를 반환합니다. 그렇지 않은 경우 false 를 반환합니다.

이 함수는 QStringRef::operator!=()를 오버로드합니다.

QT_NO_CAST_FROM_ASCII도 참조하십시오 .

[noexcept] bool QStringRef::operator<(const char *s) const

s 상수 char 포인터는 fromUtf8() 함수를 사용하여 QStringRef 로 변환됩니다.

애플리케이션을 컴파일할 때 ` QT_NO_CAST_FROM_ASCII `을 정의하면 이 연산자를 비활성화할 수 있습니다. 예를 들어, 사용자에게 표시되는 모든 문자열이 ` QObject::tr()`를 통해 처리되도록 보장하려는 경우 이 방법이 유용할 수 있습니다.

이 문자열이 매개변수 문자열 s 보다 어휘적으로 작으면 true 를 반환합니다. 그렇지 않으면 false 를 반환합니다.

이 함수는 QStringRef::operator<()을 오버로드합니다.

QT_NO_CAST_FROM_ASCII도 참조하십시오 .

[noexcept] bool QStringRef::operator<=(const char *s) const

s 상수 char 포인터는 fromUtf8() 함수를 사용하여 QStringRef 로 변환됩니다.

애플리케이션을 컴파일할 때 QT_NO_CAST_FROM_ASCII 를 정의하여 이 연산자를 비활성화할 수 있습니다. 예를 들어, 사용자에게 표시되는 모든 문자열이 QObject::tr()를 반드시 거치도록 보장하고자 할 때 유용할 수 있습니다.

이 문자열이 매개변수 문자열 s 보다 어휘적으로 작거나 같으면 true 을 반환합니다. 그렇지 않으면 false 을 반환합니다.

이 함수는 QStringRef::operator<=()을 오버로드합니다.

QT_NO_CAST_FROM_ASCII도 참조하십시오 .

QStringRef &QStringRef::operator=(const QString *string)

지정된 string 에 대한 문자열 참조를 생성하여 이 문자열 참조에 할당하고, 그 결과를 반환합니다.

경고: ` QStringRef `는 ` size`()을 표현하기 위해 ` int `(32비트)를 사용합니다. Qt 6에서는 ` QString `의 크기가 ` qsizetype`로 표현되며, 64비트 빌드의 경우 64비트입니다. 입력 크기가 32비트 내에 들어가는지 확인하십시오. 그렇지 않으면 ` the behavior is undefined`가 발생합니다.

[implicit] QStringRef &QStringRef::operator=(const QStringRef &other)

other 의 문자열 참조를 이 문자열 참조에 할당하고, 그 결과를 반환합니다.

[noexcept] bool QStringRef::operator==(const char *s) const

s 바이트 배열은 fromUtf8() 함수를 사용하여 QStringRef 로 변환됩니다. 이 함수는 첫 번째 NUL 문자가 발견되거나 바이트 배열의 끝 부분에 도달하면 변환을 중단합니다.

애플리케이션을 컴파일할 때 ` QT_NO_CAST_FROM_ASCII `를 정의하여 이 연산자를 비활성화할 수 있습니다. 예를 들어, 사용자에게 표시되는 모든 문자열이 ` QObject::tr()`를 반드시 거치도록 보장하고자 할 때 이 기능이 유용할 수 있습니다.

이 문자열이 매개변수 문자열 s 과 어휘적으로 동일한 경우 true 를 반환합니다. 그렇지 않은 경우 false 를 반환합니다.

이 함수는 QStringRef::operator==()을 오버로드합니다.

QT_NO_CAST_FROM_ASCII도 참조하십시오 .

[noexcept] bool QStringRef::operator>(const char *s) const

s 상수 char 포인터는 fromUtf8() 함수를 사용하여 QStringRef 로 변환됩니다.

애플리케이션을 컴파일할 때 ` QT_NO_CAST_FROM_ASCII `을 정의하면 이 연산자를 비활성화할 수 있습니다. 예를 들어, 사용자에게 표시되는 모든 문자열이 ` QObject::tr()`을 반드시 거치도록 보장하고자 할 때 이 방법이 유용할 수 있습니다.

이 문자열이 매개변수 문자열 ` s`보다 어휘적으로 크면 ` true `를 반환합니다. 그렇지 않으면 ` false`를 반환합니다.

이 함수는 ` QStringRef::operator>()`을 오버로드합니다.

QT_NO_CAST_FROM_ASCII도 참조하십시오 .

[noexcept] bool QStringRef::operator>=(const char *s) const

s 상수 char 포인터는 fromUtf8() 함수를 사용하여 QStringRef 로 변환됩니다.

애플리케이션을 컴파일할 때 QT_NO_CAST_FROM_ASCII 를 정의하면 이 연산자를 비활성화할 수 있습니다. 예를 들어, 사용자에게 표시되는 모든 문자열이 QObject::tr()를 반드시 거치도록 보장하고자 할 때 이 방법이 유용할 수 있습니다.

이 문자열이 매개변수 문자열 s 보다 어휘적으로 크거나 같으면 true 를 반환합니다. 그렇지 않으면 false 를 반환합니다.

이 함수는 QStringRef::operator>=()을 오버로드합니다.

QT_NO_CAST_FROM_ASCII도 참조하십시오 .

QChar QStringRef::operator[](int position) const

문자열 참조에서 지정된 인덱스 position 에 있는 문자를 반환합니다.

position 는 문자열 참조 내에서 유효한 인덱스 위치여야 합니다(즉, 0 <= position < size()).

at()도 참조하십시오 .

관련 비멤버

[noexcept] bool operator<(const QStringRef &s1, const QStringRef &s2)

문자열 참조 s1 이 문자열 참조 s2 보다 어휘적으로 작을 경우 true 을 반환하고, 그렇지 않은 경우 false 을 반환합니다.

Comparing Strings도 참조하십시오 .

[noexcept] bool operator<=(const QStringRef &s1, const QStringRef &s2)

문자열 참조 s1 가 문자열 참조 s2 보다 어휘적으로 작거나 같을 경우 true 을 반환하고, 그렇지 않은 경우 false 을 반환합니다.

Comparing Strings도 참조하십시오 .

[noexcept] bool operator==(QLatin1String s1, const QStringRef &s2)

문자열 ` s1 `이 문자열 참조 ` s2`과 어휘적으로 동일하면 ` true `을 반환하고, 그렇지 않으면 ` false`을 반환합니다.

[noexcept] bool operator==(const QString &s1, const QStringRef &s2)

문자열 s1 이 문자열 참조 s2 과 어휘적으로 동일한 경우 true 을 반환하고, 그렇지 않은 경우 false 을 반환합니다.

[noexcept] bool operator==(const QStringRef &s1, const QStringRef &s2)

문자열 참조 s1 가 문자열 참조 s2 와 어휘적으로 동일하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

[noexcept] bool operator>(const QStringRef &s1, const QStringRef &s2)

문자열 참조 s1 가 문자열 참조 s2 보다 어휘적으로 크면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

Comparing Strings도 참조하십시오 .

[noexcept] bool operator>=(const QStringRef &s1, const QStringRef &s2)

문자열 참조 s1 가 문자열 참조 s2 보다 어휘적으로 크거나 같으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

Comparing Strings도 참조하십시오 .

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.