QRegExp Class

상세 설명

이 클래스는 Qt 6에서 더 이상 사용되지 않습니다. 모든 새 코드에는 QRegularExpression 을 대신 사용하세요. QRegExp에서 QRegularExpression 로 이전 코드를 포팅하는 방법에 대한 지침은 { QRegularExpression 로 포팅하기 }를 참조하세요.

정규식 또는 "정규식"은 텍스트의 하위 문자열을 일치시키기 위한 패턴입니다. 이는 다음과 같은 여러 상황에서 유용합니다,

정규식에 대한 간략한 소개, Qt의 정규식 언어에 대한 설명, 몇 가지 예제 및 함수 설명서가 제공됩니다. QRegExp는 Perl의 정규식 언어를 모델로 합니다. 유니코드를 완벽하게 지원합니다. QRegExp는 명령 셸에서 볼 수 있는 기능과 유사한 더 간단한 와일드카드 모드로도 사용할 수 있습니다. QRegExp에서 사용하는 구문 규칙은 setPatternSyntax()로 변경할 수 있습니다. 특히 패턴 구문을 QRegExp::FixedString 으로 설정할 수 있는데, 이는 일치시킬 패턴이 일반 문자열로 해석되어 특수 문자(예: 백슬래시)가 이스케이프되지 않음을 의미합니다.

정규식에 대한 좋은 텍스트는 정규식 마스터하기 (제3판)(Jeffrey E. F. Friedl 저, ISBN 0-596-52812-4)를 참고하세요.

소개

정규식은 표현식, 수량화자 및 어설션으로 구성됩니다. 가장 간단한 표현식은 x 또는 5와 같은 문자입니다. 표현식은 대괄호로 묶인 문자의 집합일 수도 있습니다. [ ABCD] 는 A 또는 B, C 또는 D와 일치하는 표현식을 [A-D]로 쓸 수 있으며, 영어 알파벳의 모든 대문자를 일치시키는 표현식은 [A-Z]로 쓸 수 있습니다.

x{1,1}은 하나의 x만 일치시키고, x{1,5}는 최소 1개에서 최대 5개까지 포함된 일련의 x 문자를 일치시킨다는 의미입니다.

일반적으로 정규식은 균형 대괄호나 태그를 확인하는 데 사용할 수 없다는 점에 유의하세요. 예를 들어, <b> 태그가 중첩되지 않은 경우 여는 html <b> 과 닫는 </b> 을 일치시키는 정규식을 작성할 수 있지만, <b> 태그가 중첩된 경우 같은 정규식은 여는 <b> 태그와 잘못된 닫는 </b> 을 일치시킵니다. <b>bold <b>bolder</b></b> 조각의 경우 첫 번째 <b> 은 첫 번째 </b> 과 일치하게 되는데, 이는 올바르지 않습니다. 그러나 중첩된 괄호 또는 태그와 올바르게 일치하는 정규식을 작성할 수는 있지만 중첩 수준 수가 고정되어 있고 알려진 경우에만 가능합니다. 중첩 레벨의 수가 고정되어 있지 않고 알려져 있지 않으면 실패하지 않는 정규식을 작성할 수 없습니다.

0~99 범위의 정수를 일치시키는 정규식을 작성하고자 한다고 가정해 보겠습니다. 최소 한 자리가 필요하므로 한 자리가 정확히 한 번 일치하는 [0-9]{1,1} 표현식으로 시작합니다. 이 정규식은 0~9 범위의 정수를 일치시킵니다. 최대 99까지의 정수를 일치시키려면 최대 발생 횟수를 2로 늘려 정규식은 [0-9]{1,2}가 됩니다. 이 정규식은 0에서 99까지의 정수를 일치시켜야 한다는 원래의 요구 사항을 충족하지만 문자열 중간에 발생하는 정수도 일치시킵니다. 일치하는 정수를 전체 문자열로 만들려면 앵커 어설션인 ^ (캐럿)와 $ (달러)를 사용해야 합니다. 가 정규식의 첫 번째 문자인 경우, 정규식은 문자열의 시작 부분부터 일치해야 한다는 의미입니다. 가 정규식의 마지막 문자인 경우 정규식이 문자열의 끝과 일치해야 함을 의미합니다. 정규식은 ^ [0-9]{1,2}$가 됩니다. 어설션(예: ^ 및 $)은 문자가 아니라 문자열의 위치와 일치한다는 점에 유의하세요.

다른 곳에서 설명한 정규식을 본 적이 있다면 여기에 표시된 것과 다르게 보일 수 있습니다. 이는 일부 문자 집합과 일부 수량화자가 매우 일반적이어서 이를 나타내기 위해 특별한 기호가 부여되었기 때문입니다. [ 0-9] 는 기호 \d로 대체할 수 있습니다. 정확히 하나의 항목과 일치하는 수량자 {1,1}은 표현식 자체로 대체할 수 있습니다. 즉, x{1,1}은 x와 동일하므로 0~99 일치자는 ^\d{1 ,2}$로 쓸 수 있습니다. 또한 ^\d\d{0 ,1}$, 즉 문자열의 시작 부분부터 숫자 하나를 일치시키고 바로 뒤에 0 또는 1 숫자를 일치시키는 식으로 쓸 수도 있습니다. 실제로는 ^\d\d ?$로 작성합니다. 는 수량 기호 {0,1}, 즉 0 또는 1의 약어입니다. 는 표현식을 선택적으로 만듭니다. 정규식 ^\d\d ?$는 문자열의 시작 부분에서 한 자리와 일치하고 바로 뒤에 0 또는 한 자리 더, 바로 뒤에 문자열의 끝을 의미합니다.

'메일' , '편지' , '서신' 중 하나에 일치하지만 이러한 단어가 포함된 단어(예: '이메일', '메일맨', '메일러', '레터박스')와는 일치하지 않는 정규식을 작성하려면 '메일'과 일치하는 정규식으로 시작하세요. 정규식으로 표현하면 정규식은 m{1,1}a{1,1}i{1,1}l{1,1}이지만 문자 표현식은 {1,1}로 자동 수량화되므로 정규식을 메일로 단순화하면 'm' 뒤에 'a', 'i' 뒤에 'l'이 오는 식으로 표현할 수 있습니다. 이제 다른 두 단어를 포함하기 위해 또는를 의미하는 세로 막대 |를 사용할 수 있으므로 세 단어 중 하나를 일치시키는 정규식은 mail|letter|correspondence가 됩니다. '메일' 또는 '편지' 또는 '서신'을 일치시킵니다. 이 정규식은 일치시키려는 세 단어 중 하나를 일치시키지만, 일치시키지 않으려는 단어(예: '이메일')도 일치시킵니다. 정규식이 원치 않는 단어와 일치하지 않도록 하려면 단어 경계에서 일치를 시작하고 끝내도록 지시해야 합니다. 먼저 정규식을 괄호로 묶습니다 (메일|편지|통신). 괄호는 표현식을 함께 그룹화하여 capture. 표현식을 괄호로 묶으면 더 복잡한 정규식의 구성 요소로 사용할 수 있습니다. 또한 세 단어 중 어떤 단어가 실제로 일치했는지 검사할 수 있습니다. 단어 경계에서 일치를 시작하고 끝내도록 하려면 정규식을 \b 단어 경계 어설션으로 묶습니다: \ b(메일|편지|서신)\b. 이제 정규식은 다음을 의미합니다: 단어 경계를 일치시킨 다음 괄호 안에 정규식을 넣고 그 뒤에 단어 경계를 일치시킵니다. b 어설션은 문자가 아니라 정규식의 위치와 일치합니다. 단어 경계는 공백, 개행, 문자열의 시작 또는 끝과 같이 단어가 아닌 모든 문자를 말합니다.

앰퍼샌드 문자를 HTML 엔티티 & 로 바꾸려면 일치시킬 정규식은 간단히 &입니다. 그러나 이 정규식은 이미 HTML 엔티티로 변환된 앰퍼샌드도 일치시킵니다. 앰퍼샌드 뒤에 앰; 가 오지 않은 앰퍼샌드만 바꾸고 싶습니다. 이를 위해서는 네거티브 룩헤드 어설션 (?!__)이 필요합니다. 그러면 정규식은 &(?!amp;), 즉 앰퍼샌드가 뒤에 오지 않는 앰퍼샌드와 일치하는 정규식으로 작성할 수 있습니다.

문자열에서 'Eric'과 'Eirik'의 모든 발생 횟수를 계산하려는 경우 두 가지 유효한 솔루션은 \b(Eric|Eirik)\ b와 \bEi?ri[ck]\b입니다. 단어 경계 어설션 '\b'는 두 이름이 모두 포함된 단어(예: 'Ericsson')가 일치하지 않도록 하기 위해 필요합니다. 두 번째 정규식은 'Eric', 'Erik', 'Eiric', 'Eirik' 등 원하는 철자보다 더 많은 철자와 일치한다는 점에 유의하세요.

위에서 설명한 예제 중 일부는 code examples 섹션에 구현되어 있습니다.

문자 집합의 문자 및 약어

참고: C++ 컴파일러는 문자열에서 백슬래시를 변환합니다. 정규식에 \를 포함하려면 \\ 와 같이 두 번 입력합니다. 백슬래시 문자 자체를 일치시키려면 \\\\ 와 같이 네 번 입력합니다.

문자 집합

대괄호는 대괄호 안에 포함된 모든 문자를 일치시키는 것을 의미합니다. 위에서 설명한 문자 집합 약어는 대괄호 안에 있는 문자 집합에 나타날 수 있습니다. 문자 집합 약어와 다음 두 가지 예외를 제외하고 대괄호 안의 문자는 특별한 의미를 갖지 않습니다.

사전 정의된 문자 집합 약어를 사용하면 여러 플랫폼과 언어에서 문자 범위를 사용하는 것보다 이식성이 뛰어납니다. 예를 들어, [0-9 ]는 서양 알파벳의 숫자와 일치하지만 \d는 모든 알파벳의 숫자와 일치합니다.

참고: 다른 정규식 문서에서는 문자 집합을 종종 "문자 클래스"라고 부릅니다.

수량화자

기본적으로 표현식은 {1,1}로 자동 수량화됩니다. 즉, 정확히 한 번만 나타나야 합니다. 다음 목록에서 E는 표현식을 나타냅니다. 표현식은 문자 또는 문자 집합의 약어, 대괄호 안의 문자 집합 또는 괄호 안의 표현식입니다.

앞의 문자뿐만 아니라 여러 문자에 한정자를 적용하려면 괄호를 사용해 표현식에서 문자를 그룹화하세요. 예를 들어, 태그+는 't' 다음에 'a' 다음에 하나 이상의 'g'와 일치하는 반면, (태그)+는 '태그'가 하나 이상 포함된 경우와 일치합니다.

참고: 한정자는 일반적으로 "욕심"이 많습니다. 항상 가능한 한 많은 텍스트와 일치시킵니다. 예를 들어, 0+는 처음 찾은 0과 첫 번째 0 이후의 연속된 모든 0과 일치합니다. '20005'에 적용하면 '20005'와 일치합니다. 한정자는 비탐욕적으로 만들 수 있습니다( setMinimal() 참조).

텍스트 캡처

괄호를 사용하면 요소를 그룹화하여 정량화하고 캡처할 수 있습니다. 예를 들어 메일|편지|서신이라는 표현식이 문자열과 일치하는 경우 단어 중 하나가 일치한다는 것은 알지만 어떤 단어가 일치하는지는 알 수 없습니다. 괄호를 사용하면 그 범위 내에서 일치하는 모든 것을 '캡처'할 수 있으므로, (mail|letter|correspondence) 를 사용하여 이 정규식을 "내가 이메일을 보냈습니다"라는 문자열과 일치시킨 경우 cap() 또는 capturedTexts() 함수를 사용하여 일치하는 문자(이 경우 'mail')를 추출할 수 있습니다.

정규식 자체 내에서 캡처한 텍스트를 사용할 수 있습니다. 캡처된 텍스트를 참조하기 위해 cap()와 동일하게 1부터 인덱싱되는 역참조를 사용합니다. 예를 들어 \b(\w+)\W+\1\b를 사용하여 문자열에서 단어 경계와 하나 이상의 단어 문자, 단어가 아닌 문자 하나 이상, 첫 번째 괄호로 묶인 표현식과 단어 경계가 같은 텍스트를 일치시키는 방식으로 중복된 단어를 검색할 수 있습니다.

괄호를 캡처 용도가 아닌 그룹화 용도로만 사용하려면 비캡처 구문(예: (?:녹색|파란색)을 사용하면 됩니다. 캡처하지 않는 괄호는 '(?:'로 시작하고 ')'로 끝납니다. 이 예에서는 '녹색' 또는 '파란색' 중 하나를 일치시키지만 일치 항목을 캡처하지 않으므로 일치 여부만 알 수 있고 실제로 어떤 색상을 찾았는지는 알 수 없습니다. 캡처하지 않는 괄호를 사용하는 것이 캡처하는 괄호를 사용하는 것보다 정규식 엔진이 장부 정리를 덜 해야 하므로 더 효율적입니다.

캡처 괄호와 캡처하지 않는 괄호는 모두 중첩될 수 있습니다.

역사적인 이유로 괄호 안에 괄호를 캡처하는 데 적용되는 수량화자(예: *)는 다른 수량화자보다 '욕심'이 더 큽니다. 예를 들어 a*(a* )는 cap(1) == "aaa"와 "aaa"를 일치시킵니다. 이 동작은 다른 정규식 엔진(특히 Perl)이 하는 것과는 다릅니다. 보다 직관적인 캡처 동작을 얻으려면 QRegExp 생성자에 QRegExp::RegExp2 을 지정하거나 setPatternSyntax(QRegExp::RegExp2)을 호출하세요.

일치하는 항목의 수를 미리 결정할 수 없는 경우에는 cap()를 반복해서 사용하는 것이 일반적인 관용구입니다. 예를 들어

QRegExp rx("(\\d+)");
QString str = "Offsets: 12 14 99 231 7";
QStringList list;
int pos = 0;

while ((pos = rx.indexIn(str, pos)) != -1) {
    list << rx.cap(1);
    pos += rx.matchedLength();
}
// list: ["12", "14", "99", "231", "7"]

Assertions

어설션은 정규 표현식에서 해당 문자가 나오는 지점에서 텍스트에 대해 어떤 진술을 하지만 어떤 문자와도 일치하지 않습니다. 다음 목록에서 E는 모든 표현식을 나타냅니다.

와일드카드 일치

bash 또는 cmd.exe와 같은 대부분의 명령 셸은 와일드카드를 사용하여 파일 그룹을 식별하는 기능인 "파일 글로빙"을 지원합니다. setPatternSyntax () 함수는 정규식과 와일드카드 모드 사이를 전환하는 데 사용됩니다. 와일드카드 매칭은 전체 정규식보다 훨씬 간단하며 네 가지 기능만 있습니다:

와일드카드 모드에서는 와일드카드 문자를 이스케이프 처리할 수 없습니다. WildcardUnix 모드에서는 문자 '\'가 와일드카드를 이스케이프 처리합니다.

예를 들어 와일드카드 모드에 파일명이 포함된 문자열이 있는 경우 *.html로 HTML 파일을 식별할 수 있습니다. 이렇게 하면 0개 이상의 문자와 점 다음에 'h', 't', 'm' 및 'l'이 뒤따르는 문자가 일치합니다.

와일드카드 표현식에 대해 문자열을 테스트하려면 exactMatch()를 사용합니다. 예를 들어

QRegExp rx("*.txt");
rx.setPatternSyntax(QRegExp::Wildcard);
rx.exactMatch("README.txt");        // returns true
rx.exactMatch("welcome.txt.bak");   // returns false

Perl 사용자를 위한 참고 사항

Perl에서 지원하는 대부분의 문자 클래스 약어는 QRegExp에서 지원됩니다( characters and abbreviations for sets of characters 참조).

문자 클래스 내를 제외하고 QRegExp에서 ^ 는 항상 문자열의 시작을 의미하므로 해당 용도로 사용하지 않는 한 캐럿은 항상 이스케이프 처리해야 합니다. Perl에서는 캐럿의 의미가 발생 위치에 따라 자동으로 달라지므로 이스케이프 처리할 필요가 거의 없습니다. QRegExp에서 항상 문자열의 끝을 나타내는 $ 에도 동일하게 적용됩니다.

QRegExp의 한정자는 Perl의 욕심 많은 한정자와 동일합니다(하지만 note above 참조). 비욕심 일치는 개별 한정자에는 적용할 수 없지만 패턴의 모든 한정자에는 적용할 수 있습니다. 예를 들어 Perl 정규식을 일치시키려면 ro+?m이 필요합니다:

QRegExp rx("ro+m");
rx.setMinimal(true);

Perl의 /i 옵션에 해당하는 것은 setCaseSensitivity(Qt::CaseInsensitive)입니다.

Perl의 /g 옵션은 loop 을 사용하여 에뮬레이션할 수 있습니다.

에서 모든 문자와 일치하므로 모든 QRegExp 정규식은 Perl의 /s 옵션에 상응하는 값을 갖습니다. QRegExp에는 Perl의 /m 옵션과 동등한 옵션이 없지만 입력을 줄로 나누거나 줄 바꿈을 검색하는 정규식으로 반복하는 등 다양한 방법으로 에뮬레이트할 수 있습니다.

QRegExp는 문자열 지향적이므로 \A, \Z 또는 \z 어설션이 없습니다. G 어설션은 지원되지 않지만 루프에서 에뮬레이션할 수 있습니다.

Perl의 $&는 cap(0) 또는 capturedTexts()[0]입니다. ', $' 또는 $+에 해당하는 QRegExp는 없습니다. Perl의 캡처 변수 $1, $2, ...는 cap(1) 또는 capturedTexts()[1], cap(2) 또는 capturedTexts()[2] 등에 해당합니다.

패턴을 대체하려면 QString::replace()를 사용합니다.

Perl의 확장된 /x 구문은 지원되지 않으며 지시문(예: (?i))이나 정규식 주석(예: (?#comment)도 지원되지 않습니다. 반면에 C++의 리터럴 문자열에 대한 규칙을 사용하여 동일한 결과를 얻을 수 있습니다:

QRegExp mark("\\b"      // word boundary
              "[Mm]ark" // the word we want to match
            );

0폭 양수 및 0폭 음수 룩백 어설션(?!=패턴) 및 (?!패턴)은 Perl과 동일한 구문으로 모두 지원됩니다. Perl의 룩비하인드 어설션, "독립적인" 하위 표현식 및 조건식은 지원되지 않습니다.

캡처되지 않는 괄호도 동일한 (?:패턴) 구문으로 지원됩니다.

Perl의 분할 및 조인 함수에 해당하는 함수는 QString::split() 및 QStringList::join()을 참조하세요.

참고: C++는 \'를 변환하므로 코드에서 \ '를 두 번 작성해야 합니다(예: \b는 \\b로 작성해야 합니다).

코드 예제

QRegExp rx("^\\d\\d?$");    // match integers 0 to 99
rx.indexIn("123");          // returns -1 (no match)
rx.indexIn("-6");           // returns -1 (no match)
rx.indexIn("6");            // returns 0 (matched at position 0)

세 번째 문자열은'6'과 일치합니다. 이것은 0~99 범위의 정수에 대한 간단한 유효성 검사 정규식입니다.

QRegExp rx("^\\S+$");       // match strings without whitespace
rx.indexIn("Hello world");  // returns -1 (no match)
rx.indexIn("This_is-OK");   // returns 0 (matched at position 0)

두 번째 문자열은'This_is-OK'와 일치합니다. 공백이 없는 문자열을 일치시키기 위해 문자 집합 약어 '\S'(공백 없음)와 앵커를 사용했습니다.

다음 예에서는 '메일', '편지' 또는 '서신'이 포함된 문자열을 일치시키지만 '이메일'이 아닌 전체 단어만 일치시킵니다.

QRegExp rx("\\b(mail|letter|correspondence)\\b");
rx.indexIn("I sent you an email");     // returns -1 (no match)
rx.indexIn("Please write the letter"); // returns 17

두 번째 문자열은 " 편지를 써주세요"와 일치합니다. '편지'라는 단어도 괄호로 인해 캡처됩니다. 이렇게 캡처한 텍스트를 확인할 수 있습니다:

QString captured = rx.cap(1); // captured == "letter"

이렇게 하면 첫 번째 괄호 캡처 세트의 텍스트가 캡처됩니다(왼쪽 괄호 캡처는 왼쪽에서 오른쪽으로 카운트). 괄호는 cap(0)이 일치하는 전체 정규식(대부분의 정규식 엔진에서 '&'에 해당)이므로 1부터 카운트됩니다.

QRegExp rx("&(?!amp;)");      // match ampersands but not &
QString line1 = "This & that";
line1.replace(rx, "&");
// line1 == "This & that"
QString line2 = "His & hers & theirs";
line2.replace(rx, "&");
// line2 == "His & hers & theirs"

여기서는 일치하는 텍스트를 새 텍스트로 바꾸기 위해 QRegExp를 QString 의 replace() 함수에 전달했습니다.

QString str = "One Eric another Eirik, and an Ericsson. "
              "How many Eiriks, Eric?";
QRegExp rx("\\b(Eric|Eirik)\\b"); // match Eric or Eirik
int pos = 0;    // where we are in the string
int count = 0;  // how many Eric and Eirik's we've counted
while (pos >= 0) {
    pos = rx.indexIn(str, pos);
    if (pos >= 0) {
        ++pos;      // move along in str
        ++count;    // count our Eric or Eirik
    }
}

indexIn() 함수를 사용하여 문자열의 정규식을 반복적으로 일치시켰습니다. 한 번에 한 글자씩 앞으로 이동하는 대신 pos++ 대신 pos += rx.matchedLength() 을 작성하여 이미 일치하는 문자열을 건너뛸 수도 있습니다. 카운트는 3이 되어 '한 에릭 또 다른 에릭, 그리고 에릭슨'과 일치합니다. '는 ' 에릭슨' 또는 '에릭슨'과 일치하지 않는데, 이는 단어가 아닌 경계에 묶이지 않기 때문입니다.

정규식의 일반적인 용도 중 하나는 구분된 데이터의 줄을 구성 요소 필드로 분할하는 것입니다.

str = "The Qt Company Ltd\tqt.io\tFinland";
QString company, web, country;
rx.setPattern("^([^\t]+)\t([^\t]+)\t([^\t]+)$");
if (rx.indexIn(str) != -1) {
    company = rx.cap(1);
    web = rx.cap(2);
    country = rx.cap(3);
}

이 예제에서는 입력 줄에 회사 이름, 웹 주소 및 국가 형식이 있습니다. 안타깝게도 이 정규식은 다소 길고 다용도로 사용할 수 없으며 필드를 더 추가하면 코드가 깨집니다. 더 간단하고 좋은 해결책은 이 경우 구분 기호인 '\t'를 찾아서 주변 텍스트를 가져오는 것입니다. QString::split () 함수는 구분 문자열 또는 정규식을 인수로 받아 문자열을 적절히 분할할 수 있습니다.

QStringList field = str.split("\t");

여기서 field[0]은 회사, field[1]은 웹 주소 등입니다.

셸의 매칭을 모방하기 위해 와일드카드 모드를 사용할 수 있습니다.

QRegExp rx("*.html");
rx.setPatternSyntax(QRegExp::Wildcard);
rx.exactMatch("index.html");                // returns true
rx.exactMatch("default.htm");               // returns false
rx.exactMatch("readme.txt");                // returns false

와일드카드 일치는 단순하기 때문에 편리할 수 있지만, 모든 와일드카드 정규식은 전체 정규식(예: .*\.html$)을 사용하여 정의할 수 있습니다. 와일드카드로 .html 및 .htm 파일을 모두 일치시키려면 'test.html.bak'와도 일치하는 *.htm*을 사용하지 않는 한 일치시킬 수 없다는 점에 유의하세요. 전체 정규식은 필요한 정밀도인 .*\.html?$를 제공합니다.

QRegExp는 setCaseSensitivity()를 사용하여 대소문자를 구분하지 않고 일치시킬 수 있으며, 비욕심 일치를 사용할 수도 있습니다( setMinimal() 참조). 기본적으로 QRegExp는 전체 정규식을 사용하지만 setPatternSyntax()를 사용하여 변경할 수 있습니다. 검색은 indexIn()로 정방향 또는 lastIndexIn()로 역방향으로 수행할 수 있습니다. 캡처된 텍스트는 모든 캡처된 문자열의 문자열 목록을 반환하는 capturedTexts() 또는 주어진 인덱스에 대한 캡처된 문자열을 반환하는 cap()을 사용하여 액세스할 수 있습니다. pos () 함수는 일치 인덱스를 받아 문자열에서 일치한 위치(일치하는 항목이 없는 경우 -1)를 반환합니다.

QRegularExpression으로 포팅하기

Qt 5에 도입된 QRegularExpression 클래스는 Perl 호환 정규 표현식을 구현하며 제공되는 API, 지원되는 패턴 구문 및 실행 속도 측면에서 QRegExp보다 크게 개선되었습니다. 가장 큰 차이점은 QRegularExpression 은 단순히 정규식을 보유하며, 일치 항목이 요청될 때 수정되지 않는다는 것입니다. 대신 QRegularExpressionMatch 객체가 반환되어 일치 결과를 확인하고 캡처된 하위 문자열을 추출합니다. 글로벌 매칭과 QRegularExpressionMatchIterator 도 동일하게 적용됩니다.

다른 차이점은 아래에 설명되어 있습니다.

다른 패턴 구문

정규 표현식을 QRegExp에서 QRegularExpression 로 포팅하려면 패턴 자체를 변경해야 할 수 있습니다.

특정 시나리오에서는 QRegExp가 너무 관대하여 QRegularExpression 을 사용할 때 유효하지 않은 패턴을 허용했습니다. 이러한 패턴으로 작성된 QRegularExpression 객체는 유효하지 않기 때문에 쉽게 감지할 수 있습니다( QRegularExpression::isValid() 참조).

다른 경우에는 QRegExp에서 QRegularExpression 로 포팅된 패턴이 조용히 의미를 변경할 수 있습니다. 따라서 사용된 패턴을 검토할 필요가 있습니다. 가장 주목할 만한 조용한 비호환성 사례는 다음과 같습니다:

• \xHHHH 와 같이 2자리 이상의 16진수 이스케이프를 사용하려면 중괄호가 필요합니다. \x2022 와 같은 패턴은 \x{2022} 로 포팅해야 하며, 공백(0x20)과 문자열 "22" 과 일치해야 합니다. 일반적으로 지정된 자릿수에 관계없이 항상 중괄호와 함께 \x 이스케이프를 사용하는 것이 좋습니다.
• {,n} 같은 0에서 n까지의 정량화는 의미를 유지하기 위해 {0,n} 으로 포팅해야 합니다. 그렇지 않으면 \d{,3} 와 같은 패턴은 숫자 뒤에 정확한 문자열 "{,3}" 과 일치합니다.
• QRegExp는 기본적으로 유니코드 인식 일치를 수행하지만 QRegularExpression 는 별도의 옵션이 필요합니다. 자세한 내용은 아래를 참조하세요.
• c{.}는 기본적으로 개행 문자를 포함한 모든 문자를 일치시키며 QRegularExpression 는 기본적으로 개행 문자를 제외합니다. 개행 문자를 포함하려면 QRegularExpression::DotMatchesEverythingOption 패턴 옵션을 설정합니다.

QRegularExpression 에서 지원하는 정규식 구문에 대한 개요는 PCRE(Perl 호환 정규식의 참조 구현)에서 지원하는 패턴 구문을 설명하는 pcrepattern(3) 매뉴얼 페이지를 참조하세요.

QRegExp::exactMatch()에서 포팅하기

QRegExp::exactMatch()는 주제 문자열에 대해 정규식을 정확히 일치시키고 부분 일치를 구현하는 두 가지 용도로 사용되었습니다.

QRegExp의 정확히 일치에서 포팅하기

정확히 일치하는 것은 정규식이 전체 제목 문자열과 일치하는지 여부를 나타냅니다. 예를 들어, 클래스는 제목 문자열 "abc123" 에 대해 산출합니다:

정확히 일치하는 것은 QRegularExpression 에 반영되지 않습니다. 제목 문자열이 정규식과 정확히 일치하는지 확인하려면 QRegularExpression::anchoredPattern() 함수를 사용하여 패턴을 래핑할 수 있습니다:

QString p("a .*|pattern");

// re matches exactly the pattern string p
QRegularExpression re(QRegularExpression::anchoredPattern(p));

QRegExp의 부분 일치에서 포팅하기

QRegExp::exactMatch()를 사용할 때 정확히 일치하는 문자열을 찾지 못한 경우 QRegExp::matchedLength()을 호출하여 정규식과 일치하는 제목 문자열의 길이를 확인할 수 있습니다. 반환된 길이가 제목 문자열의 길이와 같으면 부분 일치가 발견되었다고 결론을 내릴 수 있습니다.

QRegularExpression 는 적절한 QRegularExpression::MatchType 를 통해 명시적으로 부분 일치를 지원합니다.

글로벌 매칭

QRegExp API의 한계로 인해 Perl처럼 전역 일치를 올바르게 구현하는 것이 불가능했습니다. 특히 0자와 일치할 수 있는 패턴(예: "a*")은 문제가 됩니다.

QRegularExpression::globalMatch()는 Perl 글로벌 일치를 올바르게 구현하며 반환된 이터레이터를 사용하여 각 결과를 검사할 수 있습니다.

예를 들어 다음과 같은 코드가 있는 경우

QString subject("the quick fox");

int offset = 0;
QRegExp re("(\\w+)");
while ((offset = re.indexIn(subject, offset)) != -1) {
    offset += re.matchedLength();
    // ...
}

다음과 같은 코드가 있다면 다음과 같이 다시 작성할 수 있습니다:

QString subject("the quick fox");

QRegularExpression re("(\\w+)");
QRegularExpressionMatchIterator i = re.globalMatch(subject);
while (i.hasNext()) {
    QRegularExpressionMatch match = i.next();
    // ...
}

유니코드 속성 지원

예를 들어, \w, \d 등과 같은 문자 클래스는 문자를 해당 유니코드 속성과 일치시킵니다(예: \d 는 유니코드 Nd (10자리 숫자) 속성을 가진 모든 문자와 일치합니다).

이러한 문자 클래스는 QRegularExpression 사용 시 기본적으로 ASCII 문자만 일치시킵니다(예: \d 은 0-9 ASCII 범위의 문자와 정확히 일치). QRegularExpression::UseUnicodePropertiesOption 패턴 옵션을 사용하여 이 동작을 변경할 수 있습니다.

와일드카드 일치

QRegularExpression 에서 와일드카드 일치를 수행하는 직접적인 방법은 없지만, QRegularExpression::wildcardToRegularExpression() 메서드는 글로브 패턴을 해당 용도로 사용할 수 있는 Perl 호환 정규식으로 변환하는 데 제공됩니다.

예를 들어 다음과 같은 코드가 있다고 가정해 보세요:

QRegExp wildcard("*.txt");
wildcard.setPatternSyntax(QRegExp::Wildcard);

다음과 같은 코드가 있는 경우 다음과 같이 다시 작성할 수 있습니다:

auto wildcard = QRegularExpression(QRegularExpression::wildcardToRegularExpression("*.txt"));

단, 일부 셸과 유사한 와일드카드 패턴은 예상대로 변환되지 않을 수 있다는 점에 유의하세요. 다음 예제 코드는 위에서 언급한 함수를 사용하여 단순히 변환하면 자동으로 깨집니다:

const QString fp1("C:/Users/dummy/files/content.txt");
const QString fp2("/home/dummy/files/content.txt");

QRegExp re1("*/files/*");
re1.setPatternSyntax(QRegExp::Wildcard);
re1.exactMatch(fp1); // returns true
re1.exactMatch(fp2); // returns true

// but converted with QRegularExpression::wildcardToRegularExpression()

QRegularExpression re2(QRegularExpression::wildcardToRegularExpression("*/files/*"));
re2.match(fp1).hasMatch(); // returns false
re2.match(fp2).hasMatch(); // returns false

이는 기본적으로 QRegularExpression::wildcardToRegularExpression()가 반환하는 정규식이 완전히 고정되어 있기 때문입니다. 앵커링되지 않은 정규식을 얻으려면 변환 옵션으로 QRegularExpression::UnanchoredWildcardConversion 을 전달하세요:

QRegularExpression re3(QRegularExpression::wildcardToRegularExpression(
                           "*/files/*", QRegularExpression::UnanchoredWildcardConversion));
re3.match(fp1).hasMatch(); // returns true
re3.match(fp2).hasMatch(); // returns true

최소 매칭

QRegExp::setMinimal()은 단순히 한정자의 욕심을 반전시켜 최소 일치를 구현했습니다(QRegExp는 *?, +? 등과 같은 게으른 한정자를 지원하지 않았습니다). QRegularExpression 은 대신 욕심, 게으른, 소유격 한정자를 지원합니다. QRegularExpression::InvertedGreedinessOption 패턴 옵션은 QRegExp::setMinimal()의 효과를 모방하는 데 유용할 수 있습니다. 활성화하면 수량화자의 욕심을 반전시킵니다(욕심 많은 수량화자는 게으른 수량화자가 되고 그 반대의 경우도 마찬가지입니다).

캐럿 모드

QRegularExpression::AnchorAtOffsetMatchOption 일치 옵션은 QRegExp::CaretAtOffset 동작을 에뮬레이트하는 데 사용할 수 있습니다. 다른 QRegExp::CaretMode 모드에 해당하는 것은 없습니다.