PageRenderTime 41ms CodeModel.GetById 17ms RepoModel.GetById 1ms app.codeStats 0ms

/kdewebdev-3.5.10/php/function.preg-split.html

#
HTML | 479 lines | 476 code | 3 blank | 0 comment | 0 complexity | 0f664a25d87459b660b9a7cff2114c40 MD5 | raw file
Possible License(s): AGPL-1.0, CC-BY-SA-3.0, GPL-2.0 
    

  1. <HTML
    2. 

  2. ><HEAD
    3. 

  3. ><TITLE
    4. 

  4. >preg_split</TITLE
    5. 

  5. ><META
    6. 

  6. NAME="GENERATOR"
    7. 

  7. CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
    8. 

  8. REL="HOME"
    9. 

  9. TITLE="PHP Manual"
    10. 

  10. HREF="index.html"><LINK
    11. 

  11. REL="UP"
    12. 

  12. TITLE="Regular Expression Functions (Perl-Compatible)"
    13. 

  13. HREF="ref.pcre.html"><LINK
    14. 

  14. REL="PREVIOUS"
    15. 

  15. TITLE="preg_replace"
    16. 

  16. HREF="function.preg-replace.html"><LINK
    17. 

  17. REL="NEXT"
    18. 

  18. TITLE="qtdom functions"
    19. 

  19. HREF="ref.qtdom.html"><META
    20. 

  20. HTTP-EQUIV="Content-type"
    21. 

  21. CONTENT="text/html; charset=ISO-8859-1"></HEAD
    22. 

  22. ><BODY
    23. 

  23. CLASS="refentry"
    24. 

  24. BGCOLOR="#FFFFFF"
    25. 

  25. TEXT="#000000"
    26. 

  26. LINK="#0000FF"
    27. 

  27. VLINK="#840084"
    28. 

  28. ALINK="#0000FF"
    29. 

  29. ><DIV
    30. 

  30. CLASS="NAVHEADER"
    31. 

  31. ><TABLE
    32. 

  32. SUMMARY="Header navigation table"
    33. 

  33. WIDTH="100%"
    34. 

  34. BORDER="0"
    35. 

  35. CELLPADDING="0"
    36. 

  36. CELLSPACING="0"
    37. 

  37. ><TR
    38. 

  38. ><TH
    39. 

  39. COLSPAN="3"
    40. 

  40. ALIGN="center"
    41. 

  41. >PHP Manual</TH
    42. 

  42. ></TR
    43. 

  43. ><TR
    44. 

  44. ><TD
    45. 

  45. WIDTH="10%"
    46. 

  46. ALIGN="left"
    47. 

  47. VALIGN="bottom"
    48. 

  48. ><A
    49. 

  49. HREF="function.preg-replace.html"
    50. 

  50. ACCESSKEY="P"
    51. 

  51. >Prev</A
    52. 

  52. ></TD
    53. 

  53. ><TD
    54. 

  54. WIDTH="80%"
    55. 

  55. ALIGN="center"
    56. 

  56. VALIGN="bottom"
    57. 

  57. ></TD
    58. 

  58. ><TD
    59. 

  59. WIDTH="10%"
    60. 

  60. ALIGN="right"
    61. 

  61. VALIGN="bottom"
    62. 

  62. ><A
    63. 

  63. HREF="ref.qtdom.html"
    64. 

  64. ACCESSKEY="N"
    65. 

  65. >Next</A
    66. 

  66. ></TD
    67. 

  67. ></TR
    68. 

  68. ></TABLE
    69. 

  69. ><HR
    70. 

  70. ALIGN="LEFT"
    71. 

  71. WIDTH="100%"></DIV
    72. 

  72. ><H1
    73. 

  73. ><A
    74. 

  74. NAME="function.preg-split"
    75. 

  75. ></A
    76. 

  76. >preg_split</H1
    77. 

  77. ><DIV
    78. 

  78. CLASS="refnamediv"
    79. 

  79. ><A
    80. 

  80. NAME="AEN81772"
    81. 

  81. ></A
    82. 

  82. ><P
    83. 

  83. >    (PHP 3&#62;= 3.0.9, PHP 4 )</P
    84. 

  84. >preg_split&nbsp;--&nbsp;Split string by a regular expression</DIV
    85. 

  85. ><DIV
    86. 

  86. CLASS="refsect1"
    87. 

  87. ><A
    88. 

  88. NAME="AEN81775"
    89. 

  89. ></A
    90. 

  90. ><H2
    91. 

  91. >Description</H2
    92. 

  92. >array <B
    93. 

  93. CLASS="methodname"
    94. 

  94. >preg_split</B
    95. 

  95. > ( string pattern, string subject [, int limit [, int flags]])<BR
    96. 

  96. ></BR
    97. 

  97. ><DIV
    98. 

  98. CLASS="note"
    99. 

  99. ><BLOCKQUOTE
    100. 

  100. CLASS="note"
    101. 

  101. ><P
    102. 

  102. ><B
    103. 

  103. >Note: </B
    104. 

  104. >
    105. 

  105.       Parameter <TT
    106. 

  106. CLASS="parameter"
    107. 

  107. ><I
    108. 

  108. >flags</I
    109. 

  109. ></TT
    110. 

  110. > was added in PHP 4 Beta 3.
    111. 

  111.      </P
    112. 

  112. ></BLOCKQUOTE
    113. 

  113. ></DIV
    114. 

  114. ><P
    115. 

  115. >&#13;     Returns an array containing substrings of
    116. 

  116.      <TT
    117. 

  117. CLASS="parameter"
    118. 

  118. ><I
    119. 

  119. >subject</I
    120. 

  120. ></TT
    121. 

  121. > split along boundaries matched by
    122. 

  122.      <TT
    123. 

  123. CLASS="parameter"
    124. 

  124. ><I
    125. 

  125. >pattern</I
    126. 

  126. ></TT
    127. 

  127. >.
    128. 

  128.     </P
    129. 

  129. ><P
    130. 

  130. >&#13;     If <TT
    131. 

  131. CLASS="parameter"
    132. 

  132. ><I
    133. 

  133. >limit</I
    134. 

  134. ></TT
    135. 

  135. > is specified, then only substrings up to
    136. 

  136.      <TT
    137. 

  137. CLASS="parameter"
    138. 

  138. ><I
    139. 

  139. >limit</I
    140. 

  140. ></TT
    141. 

  141. > are returned, and if
    142. 

  142.      <TT
    143. 

  143. CLASS="parameter"
    144. 

  144. ><I
    145. 

  145. >limit</I
    146. 

  146. ></TT
    147. 

  147. > is -1, it actually means "no limit", which is
    148. 

  148.      useful for specifying the <TT
    149. 

  149. CLASS="parameter"
    150. 

  150. ><I
    151. 

  151. >flags</I
    152. 

  152. ></TT
    153. 

  153. >.
    154. 

  154.     </P
    155. 

  155. ><P
    156. 

  156. >&#13;     <TT
    157. 

  157. CLASS="parameter"
    158. 

  158. ><I
    159. 

  159. >flags</I
    160. 

  160. ></TT
    161. 

  161. > can be any combination of the following flags
    162. 

  162.      (combined with bitwise | operator):
    163. 

  163.       <P
    164. 

  164. ></P
    165. 

  165. ><DIV
    166. 

  166. CLASS="variablelist"
    167. 

  167. ><DL
    168. 

  168. ><DT
    169. 

  169. >PREG_SPLIT_NO_EMPTY</DT
    170. 

  170. ><DD
    171. 

  171. ><P
    172. 

  172. >&#13;         If this flag is set, only non-empty pieces will be returned by
    173. 

  173.          <B
    174. 

  174. CLASS="function"
    175. 

  175. >preg_split()</B
    176. 

  176. >.
    177. 

  177.          </P
    178. 

  178. ></DD
    179. 

  179. ><DT
    180. 

  180. >PREG_SPLIT_DELIM_CAPTURE</DT
    181. 

  181. ><DD
    182. 

  182. ><P
    183. 

  183. >&#13;         If this flag is set, parenthesized expression in the delimiter pattern
    184. 

  184.          will be captured and returned as well. This flag was added for 4.0.5.
    185. 

  185.          </P
    186. 

  186. ></DD
    187. 

  187. ><DT
    188. 

  188. >PREG_SPLIT_OFFSET_CAPTURE</DT
    189. 

  189. ><DD
    190. 

  190. ><P
    191. 

  191. >&#13;          If this flag is set, for every occuring match the appendant string
    192. 

  192.           offset will also be returned. Note that this changes the return
    193. 

  193.           value in an array where every element is an array consisting of the
    194. 

  194.           matched string at offset <TT
    195. 

  195. CLASS="literal"
    196. 

  196. >0</TT
    197. 

  197. > and it's string offset
    198. 

  198.           into <TT
    199. 

  199. CLASS="parameter"
    200. 

  200. ><I
    201. 

  201. >subject</I
    202. 

  202. ></TT
    203. 

  203. > at offset <TT
    204. 

  204. CLASS="literal"
    205. 

  205. >1</TT
    206. 

  206. >.
    207. 

  207.           This flag is available since <TT
    208. 

  208. CLASS="literal"
    209. 

  209. >PHP</TT
    210. 

  210. > 4.3.0 .
    211. 

  211.          </P
    212. 

  212. ></DD
    213. 

  213. ></DL
    214. 

  214. ></DIV
    215. 

  215. >
    216. 

  216.     </P
    217. 

  217. ><P
    218. 

  218. >&#13;    <TABLE
    219. 

  219. WIDTH="100%"
    220. 

  220. BORDER="0"
    221. 

  221. CELLPADDING="0"
    222. 

  222. CELLSPACING="0"
    223. 

  223. CLASS="EXAMPLE"
    224. 

  224. ><TR
    225. 

  225. ><TD
    226. 

  226. ><DIV
    227. 

  227. CLASS="example"
    228. 

  228. ><A
    229. 

  229. NAME="AEN81824"
    230. 

  230. ></A
    231. 

  231. ><P
    232. 

  232. ><B
    233. 

  233. >Example 1. <B
    234. 

  234. CLASS="function"
    235. 

  235. >preg_split()</B
    236. 

  236. > example : Get the parts of a search string.</B
    237. 

  237. ></P
    238. 

  238. ><TABLE
    239. 

  239. BORDER="0"
    240. 

  240. BGCOLOR="#E0E0E0"
    241. 

  241. CELLPADDING="5"
    242. 

  242. ><TR
    243. 

  243. ><TD
    244. 

  244. ><PRE
    245. 

  245. CLASS="php"
    246. 

  246. >// split the phrase by any number of commas or space characters,
    247. 

  247. // which include " ", \r, \t, \n and \f
    248. 

  248. $keywords = preg_split ("/[\s,]+/", "hypertext language, programming");</PRE
    249. 

  249. ></TD
    250. 

  250. ></TR
    251. 

  251. ></TABLE
    252. 

  252. ></DIV
    253. 

  253. ></TD
    254. 

  254. ></TR
    255. 

  255. ></TABLE
    256. 

  256. >
    257. 

  257.     </P
    258. 

  258. ><P
    259. 

  259. >&#13;    <TABLE
    260. 

  260. WIDTH="100%"
    261. 

  261. BORDER="0"
    262. 

  262. CELLPADDING="0"
    263. 

  263. CELLSPACING="0"
    264. 

  264. CLASS="EXAMPLE"
    265. 

  265. ><TR
    266. 

  266. ><TD
    267. 

  267. ><DIV
    268. 

  268. CLASS="example"
    269. 

  269. ><A
    270. 

  270. NAME="AEN81829"
    271. 

  271. ></A
    272. 

  272. ><P
    273. 

  273. ><B
    274. 

  274. >Example 2. Splitting a string into component characters.</B
    275. 

  275. ></P
    276. 

  276. ><TABLE
    277. 

  277. BORDER="0"
    278. 

  278. BGCOLOR="#E0E0E0"
    279. 

  279. CELLPADDING="5"
    280. 

  280. ><TR
    281. 

  281. ><TD
    282. 

  282. ><PRE
    283. 

  283. CLASS="php"
    284. 

  284. >$str = 'string';
    285. 

  285. $chars = preg_split('//', $str, -1, PREG_SPLIT_NO_EMPTY);
    286. 

  286. print_r($chars);</PRE
    287. 

  287. ></TD
    288. 

  288. ></TR
    289. 

  289. ></TABLE
    290. 

  290. ></DIV
    291. 

  291. ></TD
    292. 

  292. ></TR
    293. 

  293. ></TABLE
    294. 

  294. >
    295. 

  295.     </P
    296. 

  296. ><P
    297. 

  297. >&#13;    <TABLE
    298. 

  298. WIDTH="100%"
    299. 

  299. BORDER="0"
    300. 

  300. CELLPADDING="0"
    301. 

  301. CELLSPACING="0"
    302. 

  302. CLASS="EXAMPLE"
    303. 

  303. ><TR
    304. 

  304. ><TD
    305. 

  305. ><DIV
    306. 

  306. CLASS="example"
    307. 

  307. ><A
    308. 

  308. NAME="AEN81833"
    309. 

  309. ></A
    310. 

  310. ><P
    311. 

  311. ><B
    312. 

  312. >Example 3. Splitting a string into matches and their offsets.</B
    313. 

  313. ></P
    314. 

  314. ><TABLE
    315. 

  315. BORDER="0"
    316. 

  316. BGCOLOR="#E0E0E0"
    317. 

  317. CELLPADDING="5"
    318. 

  318. ><TR
    319. 

  319. ><TD
    320. 

  320. ><PRE
    321. 

  321. CLASS="php"
    322. 

  322. >$str = 'hypertext language programming';
    323. 

  323. $chars = preg_split('/ /', $str, -1, PREG_SPLIT_OFFSET_CAPTURE);
    324. 

  324. print_r($chars);</PRE
    325. 

  325. ></TD
    326. 

  326. ></TR
    327. 

  327. ></TABLE
    328. 

  328. ><P
    329. 

  329. >&#13;     will yield
    330. 

  330.      </P
    331. 

  331. ><TABLE
    332. 

  332. BORDER="0"
    333. 

  333. BGCOLOR="#E0E0E0"
    334. 

  334. CELLPADDING="5"
    335. 

  335. ><TR
    336. 

  336. ><TD
    337. 

  337. ><PRE
    338. 

  338. CLASS="screen"
    339. 

  339. >Array
    340. 

  340. (
    341. 

  341.     [0] =&#62; Array
    342. 

  342.         (
    343. 

  343.             [0] =&#62; hypertext
    344. 

  344.             [1] =&#62; 0
    345. 

  345.         )
    346. 

  346. 

  347.     [1] =&#62; Array
    348. 

  348.         (
    349. 

  349.             [0] =&#62; language
    350. 

  350.             [1] =&#62; 10
    351. 

  351.         )
    352. 

  352. 

  353.     [2] =&#62; Array
    354. 

  354.         (
    355. 

  355.             [0] =&#62; programming
    356. 

  356.             [1] =&#62; 19
    357. 

  357.         )
    358. 

  358. 

  359. )</PRE
    360. 

  360. ></TD
    361. 

  361. ></TR
    362. 

  362. ></TABLE
    363. 

  363. ></DIV
    364. 

  364. ></TD
    365. 

  365. ></TR
    366. 

  366. ></TABLE
    367. 

  367. >
    368. 

  368.     </P
    369. 

  369. ><P
    370. 

  370. >&#13;     See also 
    371. 

  371.      <A
    372. 

  372. HREF="function.spliti.html"
    373. 

  373. ><B
    374. 

  374. CLASS="function"
    375. 

  375. >spliti()</B
    376. 

  376. ></A
    377. 

  377. >,
    378. 

  378.      <A
    379. 

  379. HREF="function.split.html"
    380. 

  380. ><B
    381. 

  381. CLASS="function"
    382. 

  382. >split()</B
    383. 

  383. ></A
    384. 

  384. >,
    385. 

  385.      <A
    386. 

  386. HREF="function.implode.html"
    387. 

  387. ><B
    388. 

  388. CLASS="function"
    389. 

  389. >implode()</B
    390. 

  390. ></A
    391. 

  391. >,
    392. 

  392.       <A
    393. 

  393. HREF="function.preg-match.html"
    394. 

  394. ><B
    395. 

  395. CLASS="function"
    396. 

  396. >preg_match()</B
    397. 

  397. ></A
    398. 

  398. >,
    399. 

  399.      <A
    400. 

  400. HREF="function.preg-match-all.html"
    401. 

  401. ><B
    402. 

  402. CLASS="function"
    403. 

  403. >preg_match_all()</B
    404. 

  404. ></A
    405. 

  405. >, and
    406. 

  406.      <A
    407. 

  407. HREF="function.preg-replace.html"
    408. 

  408. ><B
    409. 

  409. CLASS="function"
    410. 

  410. >preg_replace()</B
    411. 

  411. ></A
    412. 

  412. >.
    413. 

  413.     </P
    414. 

  414. ></DIV
    415. 

  415. ><DIV
    416. 

  416. CLASS="NAVFOOTER"
    417. 

  417. ><HR
    418. 

  418. ALIGN="LEFT"
    419. 

  419. WIDTH="100%"><TABLE
    420. 

  420. SUMMARY="Footer navigation table"
    421. 

  421. WIDTH="100%"
    422. 

  422. BORDER="0"
    423. 

  423. CELLPADDING="0"
    424. 

  424. CELLSPACING="0"
    425. 

  425. ><TR
    426. 

  426. ><TD
    427. 

  427. WIDTH="33%"
    428. 

  428. ALIGN="left"
    429. 

  429. VALIGN="top"
    430. 

  430. ><A
    431. 

  431. HREF="function.preg-replace.html"
    432. 

  432. ACCESSKEY="P"
    433. 

  433. >Prev</A
    434. 

  434. ></TD
    435. 

  435. ><TD
    436. 

  436. WIDTH="34%"
    437. 

  437. ALIGN="center"
    438. 

  438. VALIGN="top"
    439. 

  439. ><A
    440. 

  440. HREF="index.html"
    441. 

  441. ACCESSKEY="H"
    442. 

  442. >Home</A
    443. 

  443. ></TD
    444. 

  444. ><TD
    445. 

  445. WIDTH="33%"
    446. 

  446. ALIGN="right"
    447. 

  447. VALIGN="top"
    448. 

  448. ><A
    449. 

  449. HREF="ref.qtdom.html"
    450. 

  450. ACCESSKEY="N"
    451. 

  451. >Next</A
    452. 

  452. ></TD
    453. 

  453. ></TR
    454. 

  454. ><TR
    455. 

  455. ><TD
    456. 

  456. WIDTH="33%"
    457. 

  457. ALIGN="left"
    458. 

  458. VALIGN="top"
    459. 

  459. >preg_replace</TD
    460. 

  460. ><TD
    461. 

  461. WIDTH="34%"
    462. 

  462. ALIGN="center"
    463. 

  463. VALIGN="top"
    464. 

  464. ><A
    465. 

  465. HREF="ref.pcre.html"
    466. 

  466. ACCESSKEY="U"
    467. 

  467. >Up</A
    468. 

  468. ></TD
    469. 

  469. ><TD
    470. 

  470. WIDTH="33%"
    471. 

  471. ALIGN="right"
    472. 

  472. VALIGN="top"
    473. 

  473. >qtdom functions</TD
    474. 

  474. ></TR
    475. 

  475. ></TABLE
    476. 

  476. ></DIV
    477. 

  477. ></BODY
    478. 

  478. ></HTML
    479. 

  479. >
    480.