Preg_match_all ֆունկցիա

preg_match_all ֆունկցիան կատարում է օրինաչափության գլոբալ որոնում տողում: Առաջին պարամետրին փոխանցվում է կանոնավոր արտահայտություն, երկրորդին՝ որոնման տող, երրորդին՝ արդյունքները պահելու համար նախատեսված զանգված: Չորրորդ օպցիոնալ պարամետրը որոշում է վերադարձվող կառուցվածքի տեսակը, իսկ հինգերորդ օպցիոնալ պարամետրը՝ որոնման սկզբի տեղաշարժը:

Շարահյուսություն

phppreg_match_all(pattern, subject, matches, [flags], [offset]);

Դրոշներ

Տեսնենք, թե ինչ արժեքներ կարող է ընդունել չորրորդ պարամետրը.

Պարամետր Նկարագրություն
PREG_PATTERN_ORDER Լռելյայն ռեժիմ: Արդյունքները խմբավորվում են ընդունիչների (pockets) - զանգվածի զրոյական տարրը պարունակում է զրոյական ընդունիչներ, առաջին տարրը պարունակում է առաջին ընդունիչներ և այլն:
PREG_SET_ORDER Արդյունքները խմբավորվում են ըստ համընկնումների - զանգվածի յուրաքանչյուր տարր պարունակում է գտնված ընդունիչներով զանգված:
PREG_OFFSET_CAPTURE Յուրաքանչյուր համընկնման համար վերադարձվում է դիրքը տողում: Յուրաքանչյուր արդյունք ներկայացնում է զանգված, որտեղ զրոյական տարրը պարունակում է համընկնում, իսկ առաջինը՝ դրա տեղաշարժը:
PREG_UNMATCHED_AS_NULL Չհամընկնող ընդունիչները վերադարձվում են որպես null դատարկ տողերի փոխարեն:

Օրինակ

Գտնենք բոլոր թվանշանները տողում.

php<?php
  $str = 'abc 123 def 456';
  preg_match_all('/\d+/', $str, $res);
  var_dump($res[0]);
?>

Կոդի կատարման արդյունք.

php['123', '456']

Օրինակ

Գտնենք բոլոր 'a' տառները տողում.

php<?php
  $str = 'banana';
  preg_match_all('/a/', $str, $res);
  var_dump($res[0]);
?>

Կոդի կատարման արդյունք.

php['a', 'a', 'a']

Օրինակ

Բացառենք բոլոր ժամանակային դրոշմները տողից և դրանց բաղադրիչները.

php<?php
  $time = '12:01:02 13:03:04 14:05:06';
  preg_match_all('#(\d\d):(\d\d):(\d\d)#', $time, $res);
  var_dump($res);
?>

Կոդի կատարման արդյունք.

php[
  0 => ['12:01:02', '13:03:04', '14:05:06'],
  1 => ['12', '13', '14'],
  2 => ['01', '03', '05'],
  3 => ['02', '04', '06']
]

Օրինակ

Այժմ օգտագործենք PREG_SET_ORDER դրոշը համընկնումներով խմբավորման համար.

php<?php
  $time = '12:01:02 13:03:04 14:05:06';
  preg_match_all('#(\d\d):(\d\d):(\d\d)#', $time, $res, PREG_SET_ORDER);
  var_dump($res);
?>

Կոդի կատարման արդյունք.

php[
  0 => '12:01:02',
  1 => '12',
  2 => '01',
  3 => '02'
],
[
  0 => '13:03:04',
  1 => '13',
  2 => '03',
  3 => '04'
],
[
  0 => '14:05:06',
  1 => '14',
  2 => '05',
  3 => '06'
]

Տես նաև

  • preg_match ֆունկցիան,
    որը որոնում է կանոնավոր արտահայտության առաջին համընկնումը
  • preg_replace ֆունկցիան,
    որը կատարում է որոնում և փոխարինում ըստ կանոնավոր արտահայտության