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;
93 $out = preg_replace_callback( $this->regex
, array( $this, 'unstripCallback' ), $text );
94 $this->tempType
= null;
95 wfProfileOut( __METHOD__
);
103 protected function unstripCallback( $m ) {
104 if ( isset( $this->data
[$this->tempType
][$m[1]] ) ) {
105 return $this->data
[$this->tempType
][$m[1]];
112 * Get a StripState object which is sufficient to unstrip the given text.
113 * It will contain the minimum subset of strip items necessary.
115 * @param $text string
119 function getSubState( $text ) {
120 $subState = new StripState( $this->prefix
);
123 $startPos = strpos( $text, $this->prefix
, $pos );
124 $endPos = strpos( $text, Parser
::MARKER_SUFFIX
, $pos );
125 if ( $startPos === false ||
$endPos === false ) {
129 $endPos +
= strlen( Parser
::MARKER_SUFFIX
);
130 $marker = substr( $text, $startPos, $endPos - $startPos );
131 if ( !preg_match( $this->regex
, $marker, $m ) ) {
136 if ( isset( $this->data
['nowiki'][$key] ) ) {
137 $subState->data
['nowiki'][$key] = $this->data
['nowiki'][$key];
138 } elseif ( isset( $this->data
['general'][$key] ) ) {
139 $subState->data
['general'][$key] = $this->data
['general'][$key];
147 * Merge another StripState object into this one. The strip marker keys
148 * will not be preserved. The strings in the $texts array will have their
149 * strip markers rewritten, the resulting array of strings will be returned.
151 * @param $otherState StripState
152 * @param $texts Array
155 function merge( $otherState, $texts ) {
156 $mergePrefix = Parser
::getRandomString();
158 foreach ( $otherState->data
as $type => $items ) {
159 foreach ( $items as $key => $value ) {
160 $this->data
[$type]["$mergePrefix-$key"] = $value;
164 $this->tempMergePrefix
= $mergePrefix;
165 $texts = preg_replace_callback( $otherState->regex
, array( $this, 'mergeCallback' ), $texts );
166 $this->tempMergePrefix
= null;
170 protected function mergeCallback( $m ) {
172 return "{$this->prefix}{$this->tempMergePrefix}-$key" . Parser
::MARKER_SUFFIX
;