php-src/ext/pcre/php_pcre.h

81 lines
2.5 KiB
C
Raw Normal View History

/*
+----------------------------------------------------------------------+
| PHP Version 5 |
+----------------------------------------------------------------------+
| Copyright (c) 1997-2004 The PHP Group |
+----------------------------------------------------------------------+
| This source file is subject to version 3.0 of the PHP license, |
2000-02-15 22:24:46 +08:00
| that is bundled with this package in the file LICENSE, and is |
| available through the world-wide-web at the following url: |
| http://www.php.net/license/3_0.txt. |
2000-02-15 22:24:46 +08:00
| If you did not receive a copy of the PHP license and are unable to |
| obtain it through the world-wide-web, please send a note to |
| license@php.net so we can mail you a copy immediately. |
+----------------------------------------------------------------------+
2002-05-14 01:28:38 +08:00
| Author: Andrei Zmievski <andrei@php.net> |
+----------------------------------------------------------------------+
*/
2000-02-15 22:24:46 +08:00
/* $Id$ */
#ifndef PHP_PCRE_H
#define PHP_PCRE_H
#if HAVE_PCRE || HAVE_BUNDLED_PCRE
#if HAVE_BUNDLED_PCRE
1999-05-27 09:19:00 +08:00
#include "pcrelib/pcre.h"
#else
#include "pcre.h"
#endif
1999-07-21 04:57:04 +08:00
#if HAVE_LOCALE_H
#include <locale.h>
#endif
A few changes here. 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.
1999-05-26 23:22:02 +08:00
PHP_FUNCTION(preg_match);
PHP_FUNCTION(preg_match_all);
PHP_FUNCTION(preg_replace);
PHP_FUNCTION(preg_replace_callback);
PHP_FUNCTION(preg_split);
1999-06-04 21:56:23 +08:00
PHP_FUNCTION(preg_quote);
1999-06-10 22:41:38 +08:00
PHP_FUNCTION(preg_grep);
PHPAPI char *php_pcre_replace(char *regex, int regex_len, char *subject, int subject_len, zval *replace_val, int is_callable_replace, int *result_len, int limit TSRMLS_DC);
PHPAPI pcre* pcre_get_compiled_regex(char *regex, pcre_extra **extra, int *options TSRMLS_DC);
PHPAPI pcre* pcre_get_compiled_regex_ex(char *regex, pcre_extra **extra, int *preg_options, int *coptions TSRMLS_DC);
extern zend_module_entry pcre_module_entry;
#define pcre_module_ptr &pcre_module_entry
typedef struct {
2001-01-23 03:29:44 +08:00
pcre *re;
pcre_extra *extra;
1999-07-05 23:25:51 +08:00
int preg_options;
1999-07-21 04:57:04 +08:00
#if HAVE_SETLOCALE
char *locale;
unsigned const char *tables;
#endif
int compile_options;
} pcre_cache_entry;
2001-07-30 23:41:11 +08:00
ZEND_BEGIN_MODULE_GLOBALS(pcre)
HashTable pcre_cache;
2001-07-30 23:41:11 +08:00
ZEND_END_MODULE_GLOBALS(pcre)
#ifdef ZTS
2001-07-30 23:41:11 +08:00
# define PCRE_G(v) TSRMG(pcre_globals_id, zend_pcre_globals *, v)
#else
# define PCRE_G(v) (pcre_globals.v)
#endif
#else
#define pcre_module_ptr NULL
#endif /* HAVE_PCRE || HAVE_BUNDLED_PCRE */
#define phpext_pcre_ptr pcre_module_ptr
#endif /* PHP_PCRE_H */