mirror of
https://github.com/php/php-src.git
synced 2025-08-16 14:08:47 +02:00
0062ae6218
First of all, as per extensive discussion on the list, the functions are now
prefixed with "preg" instead of "pcre".
Secondly, global matching is now possible using preg_match_all. Please, give
suggestions on a better name if this one doesn't sit well with you. Possible
names are preg_global_match and preg_gmatch.
preg_match_all takes 4 arguments: a regex pattern, a subject string,
the array for capturing subpatterns, and a parameter that tells how the results
in the subpatterns array are arranged.
Basically, preg_match_all will go through the subject string and try to capture
all the matches that it finds, not just the first one like preg_match.
4th parameter can be PREG_PATTERN_ORDER (default) or PREG_SET_ORDER.
Example:
preg_match_all("|</?([^>]+)>|", "<div align=left>a test</div>", $out, PREG_PATTERN_ORDER);
This returns results so that $out[0] is an array of full pattern matches, $out[1] is an array
of first captured subpattern matches, and so on.
$out[0] -> ("<div align=left>", "</div>")
$out[1] -> ("div align=left", "div")
Example:
preg_match_all("|</?([^>]+)>|", "<div align=left>a test</div>", $out, PREG_SET_ORDER);
This returns results so that $out[0] is an array of first full pattern match and subpatterns,
$out[1] is an array of second full pattern match and subpatterns.
$out[0] -> ("<div align=left>", "div align=left")
$out[1] -> ("</div>", "div")
If anyone has a better name for these PREG_ constants and also which one should be the default,
I'd like to hear it.
85 lines
3.1 KiB
C
85 lines
3.1 KiB
C
/*
|
|
+----------------------------------------------------------------------+
|
|
| PHP HTML Embedded Scripting Language Version 3.0 |
|
|
+----------------------------------------------------------------------+
|
|
| Copyright (c) 1997-1999 PHP Development Team (See Credits file) |
|
|
+----------------------------------------------------------------------+
|
|
| This program is free software; you can redistribute it and/or modify |
|
|
| it under the terms of one of the following licenses: |
|
|
| |
|
|
| A) the GNU General Public License as published by the Free Software |
|
|
| Foundation; either version 2 of the License, or (at your option) |
|
|
| any later version. |
|
|
| |
|
|
| B) the PHP License as published by the PHP Development Team and |
|
|
| included in the distribution in the file: LICENSE |
|
|
| |
|
|
| This program is distributed in the hope that it will be useful, |
|
|
| but WITHOUT ANY WARRANTY; without even the implied warranty of |
|
|
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
|
|
| GNU General Public License for more details. |
|
|
| |
|
|
| You should have received a copy of both licenses referred to here. |
|
|
| If you did not, or have any questions about PHP licensing, please |
|
|
| contact core@php.net. |
|
|
+----------------------------------------------------------------------+
|
|
| Authors: Andrey Zmievski <andrey@ispi.net> |
|
|
+----------------------------------------------------------------------+
|
|
*/
|
|
|
|
/* $Id$ */
|
|
|
|
#ifndef _PHP_PCRE_H
|
|
#define _PHP_PCRE_H
|
|
|
|
#if HAVE_LIBPCRE
|
|
|
|
#include "pcre.h"
|
|
|
|
extern void php_info_pcre(ZEND_MODULE_INFO_FUNC_ARGS);
|
|
extern int php_minit_pcre(INIT_FUNC_ARGS);
|
|
extern int php_mshutdown_pcre(SHUTDOWN_FUNC_ARGS);
|
|
extern int php_rinit_pcre(INIT_FUNC_ARGS);
|
|
|
|
PHP_FUNCTION(preg_match);
|
|
PHP_FUNCTION(preg_match_all);
|
|
PHP_FUNCTION(preg_replace);
|
|
|
|
extern zend_module_entry pcre_module_entry;
|
|
#define pcre_module_ptr &pcre_module_entry
|
|
|
|
typedef struct {
|
|
pcre *re;
|
|
pcre_extra *extra;
|
|
} pcre_cache_entry;
|
|
|
|
typedef struct {
|
|
HashTable pcre_cache;
|
|
} php_pcre_globals;
|
|
|
|
#ifdef ZTS
|
|
# define PCRE_LS_D php_pcre_globals *pcre_globals
|
|
# define PCRE_LS_DC , PCRE_LS_D
|
|
# define PCRE_LS_C pcre_globals
|
|
# define PCRE_LS_CC , PCRE_LS_C
|
|
# define PCRE_G(v) (pcre_globals->v)
|
|
# define PCRE_LS_FETCH() php_pcre_globals *pcre_globals = ts_resource(pcre_globals_id);
|
|
#else
|
|
# define PCRE_LS_D
|
|
# define PCRE_LS_DC
|
|
# define PCRE_LS_C
|
|
# define PCRE_LS_CC
|
|
# define PCRE_G(v) (pcre_globals.v)
|
|
# define PCRE_LS_FETCH()
|
|
extern ZEND_API php_pcre_globals pcre_globals;
|
|
#endif
|
|
|
|
#else
|
|
|
|
#define pcre_module_ptr NULL
|
|
|
|
#endif /* HAVE_LIBPCRE */
|
|
|
|
#define phpext_pcre_ptr pcre_module_ptr
|
|
|
|
#endif /* _PHP_PCRE_H */
|