4 * @todo document, briefly.
12 protected $tempType, $tempMergePrefix;
14 function __construct( $prefix ) {
15 $this->prefix
= $prefix;
20 $this->regex
= "/{$this->prefix}([^\x7f]+)" . Parser
::MARKER_SUFFIX
. '/';
24 * Add a nowiki strip item
28 function addNoWiki( $marker, $value ) {
29 $this->addItem( 'nowiki', $marker, $value );
36 function addGeneral( $marker, $value ) {
37 $this->addItem( 'general', $marker, $value );
46 protected function addItem( $type, $marker, $value ) {
47 if ( !preg_match( $this->regex
, $marker, $m ) ) {
48 throw new MWException( "Invalid marker: $marker" );
51 $this->data
[$type][$m[1]] = $value;
58 function unstripGeneral( $text ) {
59 return $this->unstripType( 'general', $text );
66 function unstripNoWiki( $text ) {
67 return $this->unstripType( 'nowiki', $text );
74 function unstripBoth( $text ) {
75 $text = $this->unstripType( 'general', $text );
76 $text = $this->unstripType( 'nowiki', $text );
85 protected function unstripType( $type, $text ) {
87 if ( !count( $this->data
[$type] ) ) {
91 wfProfileIn( __METHOD__
);
92 $this->tempType
= $type;
95 $text = preg_replace_callback( $this->regex
, array( $this, 'unstripCallback' ), $text );
96 } while ( $text !== $oldText );
97 $this->tempType
= null;
98 wfProfileOut( __METHOD__
);
106 protected function unstripCallback( $m ) {
107 if ( isset( $this->data
[$this->tempType
][$m[1]] ) ) {
108 return $this->data
[$this->tempType
][$m[1]];
115 * Get a StripState object which is sufficient to unstrip the given text.
116 * It will contain the minimum subset of strip items necessary.
118 * @param $text string
122 function getSubState( $text ) {
123 $subState = new StripState( $this->prefix
);
126 $startPos = strpos( $text, $this->prefix
, $pos );
127 $endPos = strpos( $text, Parser
::MARKER_SUFFIX
, $pos );
128 if ( $startPos === false ||
$endPos === false ) {
132 $endPos +
= strlen( Parser
::MARKER_SUFFIX
);
133 $marker = substr( $text, $startPos, $endPos - $startPos );
134 if ( !preg_match( $this->regex
, $marker, $m ) ) {
139 if ( isset( $this->data
['nowiki'][$key] ) ) {
140 $subState->data
['nowiki'][$key] = $this->data
['nowiki'][$key];
141 } elseif ( isset( $this->data
['general'][$key] ) ) {
142 $subState->data
['general'][$key] = $this->data
['general'][$key];
150 * Merge another StripState object into this one. The strip marker keys
151 * will not be preserved. The strings in the $texts array will have their
152 * strip markers rewritten, the resulting array of strings will be returned.
154 * @param $otherState StripState
155 * @param $texts Array
158 function merge( $otherState, $texts ) {
159 $mergePrefix = Parser
::getRandomString();
161 foreach ( $otherState->data
as $type => $items ) {
162 foreach ( $items as $key => $value ) {
163 $this->data
[$type]["$mergePrefix-$key"] = $value;
167 $this->tempMergePrefix
= $mergePrefix;
168 $texts = preg_replace_callback( $otherState->regex
, array( $this, 'mergeCallback' ), $texts );
169 $this->tempMergePrefix
= null;
173 protected function mergeCallback( $m ) {
175 return "{$this->prefix}{$this->tempMergePrefix}-$key" . Parser
::MARKER_SUFFIX
;