PageRenderTime 91ms CodeModel.GetById 19ms RepoModel.GetById 0ms app.codeStats 1ms

/wp-includes/formatting.php

https://github.com/markjaquith/WordPress
PHP | 6092 lines | 3186 code | 542 blank | 2364 comment | 447 complexity | 07c999e235e53a7a49e2685497a52c26 MD5 | raw file
Possible License(s): GPL-2.0, AGPL-1.0, LGPL-2.1
  1. <?php
  2. /**
  3. * Main WordPress Formatting API.
  4. *
  5. * Handles many functions for formatting output.
  6. *
  7. * @package WordPress
  8. */
  9. /**
  10. * Replaces common plain text characters with formatted entities.
  11. *
  12. * Returns given text with transformations of quotes into smart quotes, apostrophes,
  13. * dashes, ellipses, the trademark symbol, and the multiplication symbol.
  14. *
  15. * As an example,
  16. *
  17. * 'cause today's effort makes it worth tomorrow's "holiday" ...
  18. *
  19. * Becomes:
  20. *
  21. * &#8217;cause today&#8217;s effort makes it worth tomorrow&#8217;s &#8220;holiday&#8221; &#8230;
  22. *
  23. * Code within certain HTML blocks are skipped.
  24. *
  25. * Do not use this function before the {@see 'init'} action hook; everything will break.
  26. *
  27. * @since 0.71
  28. *
  29. * @global array $wp_cockneyreplace Array of formatted entities for certain common phrases.
  30. * @global array $shortcode_tags
  31. *
  32. * @param string $text The text to be formatted.
  33. * @param bool $reset Set to true for unit testing. Translated patterns will reset.
  34. * @return string The string replaced with HTML entities.
  35. */
  36. function wptexturize( $text, $reset = false ) {
  37. global $wp_cockneyreplace, $shortcode_tags;
  38. static $static_characters = null,
  39. $static_replacements = null,
  40. $dynamic_characters = null,
  41. $dynamic_replacements = null,
  42. $default_no_texturize_tags = null,
  43. $default_no_texturize_shortcodes = null,
  44. $run_texturize = true,
  45. $apos = null,
  46. $prime = null,
  47. $double_prime = null,
  48. $opening_quote = null,
  49. $closing_quote = null,
  50. $opening_single_quote = null,
  51. $closing_single_quote = null,
  52. $open_q_flag = '<!--oq-->',
  53. $open_sq_flag = '<!--osq-->',
  54. $apos_flag = '<!--apos-->';
  55. // If there's nothing to do, just stop.
  56. if ( empty( $text ) || false === $run_texturize ) {
  57. return $text;
  58. }
  59. // Set up static variables. Run once only.
  60. if ( $reset || ! isset( $static_characters ) ) {
  61. /**
  62. * Filters whether to skip running wptexturize().
  63. *
  64. * Returning false from the filter will effectively short-circuit wptexturize()
  65. * and return the original text passed to the function instead.
  66. *
  67. * The filter runs only once, the first time wptexturize() is called.
  68. *
  69. * @since 4.0.0
  70. *
  71. * @see wptexturize()
  72. *
  73. * @param bool $run_texturize Whether to short-circuit wptexturize().
  74. */
  75. $run_texturize = apply_filters( 'run_wptexturize', $run_texturize );
  76. if ( false === $run_texturize ) {
  77. return $text;
  78. }
  79. /* translators: Opening curly double quote. */
  80. $opening_quote = _x( '&#8220;', 'opening curly double quote' );
  81. /* translators: Closing curly double quote. */
  82. $closing_quote = _x( '&#8221;', 'closing curly double quote' );
  83. /* translators: Apostrophe, for example in 'cause or can't. */
  84. $apos = _x( '&#8217;', 'apostrophe' );
  85. /* translators: Prime, for example in 9' (nine feet). */
  86. $prime = _x( '&#8242;', 'prime' );
  87. /* translators: Double prime, for example in 9" (nine inches). */
  88. $double_prime = _x( '&#8243;', 'double prime' );
  89. /* translators: Opening curly single quote. */
  90. $opening_single_quote = _x( '&#8216;', 'opening curly single quote' );
  91. /* translators: Closing curly single quote. */
  92. $closing_single_quote = _x( '&#8217;', 'closing curly single quote' );
  93. /* translators: En dash. */
  94. $en_dash = _x( '&#8211;', 'en dash' );
  95. /* translators: Em dash. */
  96. $em_dash = _x( '&#8212;', 'em dash' );
  97. $default_no_texturize_tags = array( 'pre', 'code', 'kbd', 'style', 'script', 'tt' );
  98. $default_no_texturize_shortcodes = array( 'code' );
  99. // If a plugin has provided an autocorrect array, use it.
  100. if ( isset( $wp_cockneyreplace ) ) {
  101. $cockney = array_keys( $wp_cockneyreplace );
  102. $cockneyreplace = array_values( $wp_cockneyreplace );
  103. } else {
  104. /*
  105. * translators: This is a comma-separated list of words that defy the syntax of quotations in normal use,
  106. * for example... 'We do not have enough words yet'... is a typical quoted phrase. But when we write
  107. * lines of code 'til we have enough of 'em, then we need to insert apostrophes instead of quotes.
  108. */
  109. $cockney = explode(
  110. ',',
  111. _x(
  112. "'tain't,'twere,'twas,'tis,'twill,'til,'bout,'nuff,'round,'cause,'em",
  113. 'Comma-separated list of words to texturize in your language'
  114. )
  115. );
  116. $cockneyreplace = explode(
  117. ',',
  118. _x(
  119. '&#8217;tain&#8217;t,&#8217;twere,&#8217;twas,&#8217;tis,&#8217;twill,&#8217;til,&#8217;bout,&#8217;nuff,&#8217;round,&#8217;cause,&#8217;em',
  120. 'Comma-separated list of replacement words in your language'
  121. )
  122. );
  123. }
  124. $static_characters = array_merge( array( '...', '``', '\'\'', ' (tm)' ), $cockney );
  125. $static_replacements = array_merge( array( '&#8230;', $opening_quote, $closing_quote, ' &#8482;' ), $cockneyreplace );
  126. // Pattern-based replacements of characters.
  127. // Sort the remaining patterns into several arrays for performance tuning.
  128. $dynamic_characters = array(
  129. 'apos' => array(),
  130. 'quote' => array(),
  131. 'dash' => array(),
  132. );
  133. $dynamic_replacements = array(
  134. 'apos' => array(),
  135. 'quote' => array(),
  136. 'dash' => array(),
  137. );
  138. $dynamic = array();
  139. $spaces = wp_spaces_regexp();
  140. // '99' and '99" are ambiguous among other patterns; assume it's an abbreviated year at the end of a quotation.
  141. if ( "'" !== $apos || "'" !== $closing_single_quote ) {
  142. $dynamic[ '/\'(\d\d)\'(?=\Z|[.,:;!?)}\-\]]|&gt;|' . $spaces . ')/' ] = $apos_flag . '$1' . $closing_single_quote;
  143. }
  144. if ( "'" !== $apos || '"' !== $closing_quote ) {
  145. $dynamic[ '/\'(\d\d)"(?=\Z|[.,:;!?)}\-\]]|&gt;|' . $spaces . ')/' ] = $apos_flag . '$1' . $closing_quote;
  146. }
  147. // '99 '99s '99's (apostrophe) But never '9 or '99% or '999 or '99.0.
  148. if ( "'" !== $apos ) {
  149. $dynamic['/\'(?=\d\d(?:\Z|(?![%\d]|[.,]\d)))/'] = $apos_flag;
  150. }
  151. // Quoted numbers like '0.42'.
  152. if ( "'" !== $opening_single_quote && "'" !== $closing_single_quote ) {
  153. $dynamic[ '/(?<=\A|' . $spaces . ')\'(\d[.,\d]*)\'/' ] = $open_sq_flag . '$1' . $closing_single_quote;
  154. }
  155. // Single quote at start, or preceded by (, {, <, [, ", -, or spaces.
  156. if ( "'" !== $opening_single_quote ) {
  157. $dynamic[ '/(?<=\A|[([{"\-]|&lt;|' . $spaces . ')\'/' ] = $open_sq_flag;
  158. }
  159. // Apostrophe in a word. No spaces, double apostrophes, or other punctuation.
  160. if ( "'" !== $apos ) {
  161. $dynamic[ '/(?<!' . $spaces . ')\'(?!\Z|[.,:;!?"\'(){}[\]\-]|&[lg]t;|' . $spaces . ')/' ] = $apos_flag;
  162. }
  163. $dynamic_characters['apos'] = array_keys( $dynamic );
  164. $dynamic_replacements['apos'] = array_values( $dynamic );
  165. $dynamic = array();
  166. // Quoted numbers like "42".
  167. if ( '"' !== $opening_quote && '"' !== $closing_quote ) {
  168. $dynamic[ '/(?<=\A|' . $spaces . ')"(\d[.,\d]*)"/' ] = $open_q_flag . '$1' . $closing_quote;
  169. }
  170. // Double quote at start, or preceded by (, {, <, [, -, or spaces, and not followed by spaces.
  171. if ( '"' !== $opening_quote ) {
  172. $dynamic[ '/(?<=\A|[([{\-]|&lt;|' . $spaces . ')"(?!' . $spaces . ')/' ] = $open_q_flag;
  173. }
  174. $dynamic_characters['quote'] = array_keys( $dynamic );
  175. $dynamic_replacements['quote'] = array_values( $dynamic );
  176. $dynamic = array();
  177. // Dashes and spaces.
  178. $dynamic['/---/'] = $em_dash;
  179. $dynamic[ '/(?<=^|' . $spaces . ')--(?=$|' . $spaces . ')/' ] = $em_dash;
  180. $dynamic['/(?<!xn)--/'] = $en_dash;
  181. $dynamic[ '/(?<=^|' . $spaces . ')-(?=$|' . $spaces . ')/' ] = $en_dash;
  182. $dynamic_characters['dash'] = array_keys( $dynamic );
  183. $dynamic_replacements['dash'] = array_values( $dynamic );
  184. }
  185. // Must do this every time in case plugins use these filters in a context sensitive manner.
  186. /**
  187. * Filters the list of HTML elements not to texturize.
  188. *
  189. * @since 2.8.0
  190. *
  191. * @param string[] $default_no_texturize_tags An array of HTML element names.
  192. */
  193. $no_texturize_tags = apply_filters( 'no_texturize_tags', $default_no_texturize_tags );
  194. /**
  195. * Filters the list of shortcodes not to texturize.
  196. *
  197. * @since 2.8.0
  198. *
  199. * @param string[] $default_no_texturize_shortcodes An array of shortcode names.
  200. */
  201. $no_texturize_shortcodes = apply_filters( 'no_texturize_shortcodes', $default_no_texturize_shortcodes );
  202. $no_texturize_tags_stack = array();
  203. $no_texturize_shortcodes_stack = array();
  204. // Look for shortcodes and HTML elements.
  205. preg_match_all( '@\[/?([^<>&/\[\]\x00-\x20=]++)@', $text, $matches );
  206. $tagnames = array_intersect( array_keys( $shortcode_tags ), $matches[1] );
  207. $found_shortcodes = ! empty( $tagnames );
  208. $shortcode_regex = $found_shortcodes ? _get_wptexturize_shortcode_regex( $tagnames ) : '';
  209. $regex = _get_wptexturize_split_regex( $shortcode_regex );
  210. $textarr = preg_split( $regex, $text, -1, PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY );
  211. foreach ( $textarr as &$curl ) {
  212. // Only call _wptexturize_pushpop_element if $curl is a delimiter.
  213. $first = $curl[0];
  214. if ( '<' === $first ) {
  215. if ( '<!--' === substr( $curl, 0, 4 ) ) {
  216. // This is an HTML comment delimiter.
  217. continue;
  218. } else {
  219. // This is an HTML element delimiter.
  220. // Replace each & with &#038; unless it already looks like an entity.
  221. $curl = preg_replace( '/&(?!#(?:\d+|x[a-f0-9]+);|[a-z1-4]{1,8};)/i', '&#038;', $curl );
  222. _wptexturize_pushpop_element( $curl, $no_texturize_tags_stack, $no_texturize_tags );
  223. }
  224. } elseif ( '' === trim( $curl ) ) {
  225. // This is a newline between delimiters. Performance improves when we check this.
  226. continue;
  227. } elseif ( '[' === $first && $found_shortcodes && 1 === preg_match( '/^' . $shortcode_regex . '$/', $curl ) ) {
  228. // This is a shortcode delimiter.
  229. if ( '[[' !== substr( $curl, 0, 2 ) && ']]' !== substr( $curl, -2 ) ) {
  230. // Looks like a normal shortcode.
  231. _wptexturize_pushpop_element( $curl, $no_texturize_shortcodes_stack, $no_texturize_shortcodes );
  232. } else {
  233. // Looks like an escaped shortcode.
  234. continue;
  235. }
  236. } elseif ( empty( $no_texturize_shortcodes_stack ) && empty( $no_texturize_tags_stack ) ) {
  237. // This is neither a delimiter, nor is this content inside of no_texturize pairs. Do texturize.
  238. $curl = str_replace( $static_characters, $static_replacements, $curl );
  239. if ( false !== strpos( $curl, "'" ) ) {
  240. $curl = preg_replace( $dynamic_characters['apos'], $dynamic_replacements['apos'], $curl );
  241. $curl = wptexturize_primes( $curl, "'", $prime, $open_sq_flag, $closing_single_quote );
  242. $curl = str_replace( $apos_flag, $apos, $curl );
  243. $curl = str_replace( $open_sq_flag, $opening_single_quote, $curl );
  244. }
  245. if ( false !== strpos( $curl, '"' ) ) {
  246. $curl = preg_replace( $dynamic_characters['quote'], $dynamic_replacements['quote'], $curl );
  247. $curl = wptexturize_primes( $curl, '"', $double_prime, $open_q_flag, $closing_quote );
  248. $curl = str_replace( $open_q_flag, $opening_quote, $curl );
  249. }
  250. if ( false !== strpos( $curl, '-' ) ) {
  251. $curl = preg_replace( $dynamic_characters['dash'], $dynamic_replacements['dash'], $curl );
  252. }
  253. // 9x9 (times), but never 0x9999.
  254. if ( 1 === preg_match( '/(?<=\d)x\d/', $curl ) ) {
  255. // Searching for a digit is 10 times more expensive than for the x, so we avoid doing this one!
  256. $curl = preg_replace( '/\b(\d(?(?<=0)[\d\.,]+|[\d\.,]*))x(\d[\d\.,]*)\b/', '$1&#215;$2', $curl );
  257. }
  258. // Replace each & with &#038; unless it already looks like an entity.
  259. $curl = preg_replace( '/&(?!#(?:\d+|x[a-f0-9]+);|[a-z1-4]{1,8};)/i', '&#038;', $curl );
  260. }
  261. }
  262. return implode( '', $textarr );
  263. }
  264. /**
  265. * Implements a logic tree to determine whether or not "7'." represents seven feet,
  266. * then converts the special char into either a prime char or a closing quote char.
  267. *
  268. * @since 4.3.0
  269. *
  270. * @param string $haystack The plain text to be searched.
  271. * @param string $needle The character to search for such as ' or ".
  272. * @param string $prime The prime char to use for replacement.
  273. * @param string $open_quote The opening quote char. Opening quote replacement must be
  274. * accomplished already.
  275. * @param string $close_quote The closing quote char to use for replacement.
  276. * @return string The $haystack value after primes and quotes replacements.
  277. */
  278. function wptexturize_primes( $haystack, $needle, $prime, $open_quote, $close_quote ) {
  279. $spaces = wp_spaces_regexp();
  280. $flag = '<!--wp-prime-or-quote-->';
  281. $quote_pattern = "/$needle(?=\\Z|[.,:;!?)}\\-\\]]|&gt;|" . $spaces . ')/';
  282. $prime_pattern = "/(?<=\\d)$needle/";
  283. $flag_after_digit = "/(?<=\\d)$flag/";
  284. $flag_no_digit = "/(?<!\\d)$flag/";
  285. $sentences = explode( $open_quote, $haystack );
  286. foreach ( $sentences as $key => &$sentence ) {
  287. if ( false === strpos( $sentence, $needle ) ) {
  288. continue;
  289. } elseif ( 0 !== $key && 0 === substr_count( $sentence, $close_quote ) ) {
  290. $sentence = preg_replace( $quote_pattern, $flag, $sentence, -1, $count );
  291. if ( $count > 1 ) {
  292. // This sentence appears to have multiple closing quotes. Attempt Vulcan logic.
  293. $sentence = preg_replace( $flag_no_digit, $close_quote, $sentence, -1, $count2 );
  294. if ( 0 === $count2 ) {
  295. // Try looking for a quote followed by a period.
  296. $count2 = substr_count( $sentence, "$flag." );
  297. if ( $count2 > 0 ) {
  298. // Assume the rightmost quote-period match is the end of quotation.
  299. $pos = strrpos( $sentence, "$flag." );
  300. } else {
  301. // When all else fails, make the rightmost candidate a closing quote.
  302. // This is most likely to be problematic in the context of bug #18549.
  303. $pos = strrpos( $sentence, $flag );
  304. }
  305. $sentence = substr_replace( $sentence, $close_quote, $pos, strlen( $flag ) );
  306. }
  307. // Use conventional replacement on any remaining primes and quotes.
  308. $sentence = preg_replace( $prime_pattern, $prime, $sentence );
  309. $sentence = preg_replace( $flag_after_digit, $prime, $sentence );
  310. $sentence = str_replace( $flag, $close_quote, $sentence );
  311. } elseif ( 1 == $count ) {
  312. // Found only one closing quote candidate, so give it priority over primes.
  313. $sentence = str_replace( $flag, $close_quote, $sentence );
  314. $sentence = preg_replace( $prime_pattern, $prime, $sentence );
  315. } else {
  316. // No closing quotes found. Just run primes pattern.
  317. $sentence = preg_replace( $prime_pattern, $prime, $sentence );
  318. }
  319. } else {
  320. $sentence = preg_replace( $prime_pattern, $prime, $sentence );
  321. $sentence = preg_replace( $quote_pattern, $close_quote, $sentence );
  322. }
  323. if ( '"' === $needle && false !== strpos( $sentence, '"' ) ) {
  324. $sentence = str_replace( '"', $close_quote, $sentence );
  325. }
  326. }
  327. return implode( $open_quote, $sentences );
  328. }
  329. /**
  330. * Search for disabled element tags. Push element to stack on tag open and pop
  331. * on tag close.
  332. *
  333. * Assumes first char of $text is tag opening and last char is tag closing.
  334. * Assumes second char of $text is optionally '/' to indicate closing as in </html>.
  335. *
  336. * @since 2.9.0
  337. * @access private
  338. *
  339. * @param string $text Text to check. Must be a tag like `<html>` or `[shortcode]`.
  340. * @param string[] $stack Array of open tag elements.
  341. * @param string[] $disabled_elements Array of tag names to match against. Spaces are not allowed in tag names.
  342. */
  343. function _wptexturize_pushpop_element( $text, &$stack, $disabled_elements ) {
  344. // Is it an opening tag or closing tag?
  345. if ( isset( $text[1] ) && '/' !== $text[1] ) {
  346. $opening_tag = true;
  347. $name_offset = 1;
  348. } elseif ( 0 === count( $stack ) ) {
  349. // Stack is empty. Just stop.
  350. return;
  351. } else {
  352. $opening_tag = false;
  353. $name_offset = 2;
  354. }
  355. // Parse out the tag name.
  356. $space = strpos( $text, ' ' );
  357. if ( false === $space ) {
  358. $space = -1;
  359. } else {
  360. $space -= $name_offset;
  361. }
  362. $tag = substr( $text, $name_offset, $space );
  363. // Handle disabled tags.
  364. if ( in_array( $tag, $disabled_elements, true ) ) {
  365. if ( $opening_tag ) {
  366. /*
  367. * This disables texturize until we find a closing tag of our type
  368. * (e.g. <pre>) even if there was invalid nesting before that.
  369. *
  370. * Example: in the case <pre>sadsadasd</code>"baba"</pre>
  371. * "baba" won't be texturized.
  372. */
  373. array_push( $stack, $tag );
  374. } elseif ( end( $stack ) == $tag ) {
  375. array_pop( $stack );
  376. }
  377. }
  378. }
  379. /**
  380. * Replaces double line breaks with paragraph elements.
  381. *
  382. * A group of regex replaces used to identify text formatted with newlines and
  383. * replace double line breaks with HTML paragraph tags. The remaining line breaks
  384. * after conversion become <<br />> tags, unless $br is set to '0' or 'false'.
  385. *
  386. * @since 0.71
  387. *
  388. * @param string $pee The text which has to be formatted.
  389. * @param bool $br Optional. If set, this will convert all remaining line breaks
  390. * after paragraphing. Line breaks within `<script>`, `<style>`,
  391. * and `<svg>` tags are not affected. Default true.
  392. * @return string Text which has been converted into correct paragraph tags.
  393. */
  394. function wpautop( $pee, $br = true ) {
  395. $pre_tags = array();
  396. if ( trim( $pee ) === '' ) {
  397. return '';
  398. }
  399. // Just to make things a little easier, pad the end.
  400. $pee = $pee . "\n";
  401. /*
  402. * Pre tags shouldn't be touched by autop.
  403. * Replace pre tags with placeholders and bring them back after autop.
  404. */
  405. if ( strpos( $pee, '<pre' ) !== false ) {
  406. $pee_parts = explode( '</pre>', $pee );
  407. $last_pee = array_pop( $pee_parts );
  408. $pee = '';
  409. $i = 0;
  410. foreach ( $pee_parts as $pee_part ) {
  411. $start = strpos( $pee_part, '<pre' );
  412. // Malformed HTML?
  413. if ( false === $start ) {
  414. $pee .= $pee_part;
  415. continue;
  416. }
  417. $name = "<pre wp-pre-tag-$i></pre>";
  418. $pre_tags[ $name ] = substr( $pee_part, $start ) . '</pre>';
  419. $pee .= substr( $pee_part, 0, $start ) . $name;
  420. $i++;
  421. }
  422. $pee .= $last_pee;
  423. }
  424. // Change multiple <br>'s into two line breaks, which will turn into paragraphs.
  425. $pee = preg_replace( '|<br\s*/?>\s*<br\s*/?>|', "\n\n", $pee );
  426. $allblocks = '(?:table|thead|tfoot|caption|col|colgroup|tbody|tr|td|th|div|dl|dd|dt|ul|ol|li|pre|form|map|area|blockquote|address|math|style|p|h[1-6]|hr|fieldset|legend|section|article|aside|hgroup|header|footer|nav|figure|figcaption|details|menu|summary)';
  427. // Add a double line break above block-level opening tags.
  428. $pee = preg_replace( '!(<' . $allblocks . '[\s/>])!', "\n\n$1", $pee );
  429. // Add a double line break below block-level closing tags.
  430. $pee = preg_replace( '!(</' . $allblocks . '>)!', "$1\n\n", $pee );
  431. // Add a double line break after hr tags, which are self closing.
  432. $pee = preg_replace( '!(<hr\s*?/?>)!', "$1\n\n", $pee );
  433. // Standardize newline characters to "\n".
  434. $pee = str_replace( array( "\r\n", "\r" ), "\n", $pee );
  435. // Find newlines in all elements and add placeholders.
  436. $pee = wp_replace_in_html_tags( $pee, array( "\n" => ' <!-- wpnl --> ' ) );
  437. // Collapse line breaks before and after <option> elements so they don't get autop'd.
  438. if ( strpos( $pee, '<option' ) !== false ) {
  439. $pee = preg_replace( '|\s*<option|', '<option', $pee );
  440. $pee = preg_replace( '|</option>\s*|', '</option>', $pee );
  441. }
  442. /*
  443. * Collapse line breaks inside <object> elements, before <param> and <embed> elements
  444. * so they don't get autop'd.
  445. */
  446. if ( strpos( $pee, '</object>' ) !== false ) {
  447. $pee = preg_replace( '|(<object[^>]*>)\s*|', '$1', $pee );
  448. $pee = preg_replace( '|\s*</object>|', '</object>', $pee );
  449. $pee = preg_replace( '%\s*(</?(?:param|embed)[^>]*>)\s*%', '$1', $pee );
  450. }
  451. /*
  452. * Collapse line breaks inside <audio> and <video> elements,
  453. * before and after <source> and <track> elements.
  454. */
  455. if ( strpos( $pee, '<source' ) !== false || strpos( $pee, '<track' ) !== false ) {
  456. $pee = preg_replace( '%([<\[](?:audio|video)[^>\]]*[>\]])\s*%', '$1', $pee );
  457. $pee = preg_replace( '%\s*([<\[]/(?:audio|video)[>\]])%', '$1', $pee );
  458. $pee = preg_replace( '%\s*(<(?:source|track)[^>]*>)\s*%', '$1', $pee );
  459. }
  460. // Collapse line breaks before and after <figcaption> elements.
  461. if ( strpos( $pee, '<figcaption' ) !== false ) {
  462. $pee = preg_replace( '|\s*(<figcaption[^>]*>)|', '$1', $pee );
  463. $pee = preg_replace( '|</figcaption>\s*|', '</figcaption>', $pee );
  464. }
  465. // Remove more than two contiguous line breaks.
  466. $pee = preg_replace( "/\n\n+/", "\n\n", $pee );
  467. // Split up the contents into an array of strings, separated by double line breaks.
  468. $pees = preg_split( '/\n\s*\n/', $pee, -1, PREG_SPLIT_NO_EMPTY );
  469. // Reset $pee prior to rebuilding.
  470. $pee = '';
  471. // Rebuild the content as a string, wrapping every bit with a <p>.
  472. foreach ( $pees as $tinkle ) {
  473. $pee .= '<p>' . trim( $tinkle, "\n" ) . "</p>\n";
  474. }
  475. // Under certain strange conditions it could create a P of entirely whitespace.
  476. $pee = preg_replace( '|<p>\s*</p>|', '', $pee );
  477. // Add a closing <p> inside <div>, <address>, or <form> tag if missing.
  478. $pee = preg_replace( '!<p>([^<]+)</(div|address|form)>!', '<p>$1</p></$2>', $pee );
  479. // If an opening or closing block element tag is wrapped in a <p>, unwrap it.
  480. $pee = preg_replace( '!<p>\s*(</?' . $allblocks . '[^>]*>)\s*</p>!', '$1', $pee );
  481. // In some cases <li> may get wrapped in <p>, fix them.
  482. $pee = preg_replace( '|<p>(<li.+?)</p>|', '$1', $pee );
  483. // If a <blockquote> is wrapped with a <p>, move it inside the <blockquote>.
  484. $pee = preg_replace( '|<p><blockquote([^>]*)>|i', '<blockquote$1><p>', $pee );
  485. $pee = str_replace( '</blockquote></p>', '</p></blockquote>', $pee );
  486. // If an opening or closing block element tag is preceded by an opening <p> tag, remove it.
  487. $pee = preg_replace( '!<p>\s*(</?' . $allblocks . '[^>]*>)!', '$1', $pee );
  488. // If an opening or closing block element tag is followed by a closing <p> tag, remove it.
  489. $pee = preg_replace( '!(</?' . $allblocks . '[^>]*>)\s*</p>!', '$1', $pee );
  490. // Optionally insert line breaks.
  491. if ( $br ) {
  492. // Replace newlines that shouldn't be touched with a placeholder.
  493. $pee = preg_replace_callback( '/<(script|style|svg).*?<\/\\1>/s', '_autop_newline_preservation_helper', $pee );
  494. // Normalize <br>
  495. $pee = str_replace( array( '<br>', '<br/>' ), '<br />', $pee );
  496. // Replace any new line characters that aren't preceded by a <br /> with a <br />.
  497. $pee = preg_replace( '|(?<!<br />)\s*\n|', "<br />\n", $pee );
  498. // Replace newline placeholders with newlines.
  499. $pee = str_replace( '<WPPreserveNewline />', "\n", $pee );
  500. }
  501. // If a <br /> tag is after an opening or closing block tag, remove it.
  502. $pee = preg_replace( '!(</?' . $allblocks . '[^>]*>)\s*<br />!', '$1', $pee );
  503. // If a <br /> tag is before a subset of opening or closing block tags, remove it.
  504. $pee = preg_replace( '!<br />(\s*</?(?:p|li|div|dl|dd|dt|th|pre|td|ul|ol)[^>]*>)!', '$1', $pee );
  505. $pee = preg_replace( "|\n</p>$|", '</p>', $pee );
  506. // Replace placeholder <pre> tags with their original content.
  507. if ( ! empty( $pre_tags ) ) {
  508. $pee = str_replace( array_keys( $pre_tags ), array_values( $pre_tags ), $pee );
  509. }
  510. // Restore newlines in all elements.
  511. if ( false !== strpos( $pee, '<!-- wpnl -->' ) ) {
  512. $pee = str_replace( array( ' <!-- wpnl --> ', '<!-- wpnl -->' ), "\n", $pee );
  513. }
  514. return $pee;
  515. }
  516. /**
  517. * Separate HTML elements and comments from the text.
  518. *
  519. * @since 4.2.4
  520. *
  521. * @param string $input The text which has to be formatted.
  522. * @return string[] Array of the formatted text.
  523. */
  524. function wp_html_split( $input ) {
  525. return preg_split( get_html_split_regex(), $input, -1, PREG_SPLIT_DELIM_CAPTURE );
  526. }
  527. /**
  528. * Retrieve the regular expression for an HTML element.
  529. *
  530. * @since 4.4.0
  531. *
  532. * @return string The regular expression
  533. */
  534. function get_html_split_regex() {
  535. static $regex;
  536. if ( ! isset( $regex ) ) {
  537. // phpcs:disable Squiz.Strings.ConcatenationSpacing.PaddingFound -- don't remove regex indentation
  538. $comments =
  539. '!' // Start of comment, after the <.
  540. . '(?:' // Unroll the loop: Consume everything until --> is found.
  541. . '-(?!->)' // Dash not followed by end of comment.
  542. . '[^\-]*+' // Consume non-dashes.
  543. . ')*+' // Loop possessively.
  544. . '(?:-->)?'; // End of comment. If not found, match all input.
  545. $cdata =
  546. '!\[CDATA\[' // Start of comment, after the <.
  547. . '[^\]]*+' // Consume non-].
  548. . '(?:' // Unroll the loop: Consume everything until ]]> is found.
  549. . '](?!]>)' // One ] not followed by end of comment.
  550. . '[^\]]*+' // Consume non-].
  551. . ')*+' // Loop possessively.
  552. . '(?:]]>)?'; // End of comment. If not found, match all input.
  553. $escaped =
  554. '(?=' // Is the element escaped?
  555. . '!--'
  556. . '|'
  557. . '!\[CDATA\['
  558. . ')'
  559. . '(?(?=!-)' // If yes, which type?
  560. . $comments
  561. . '|'
  562. . $cdata
  563. . ')';
  564. $regex =
  565. '/(' // Capture the entire match.
  566. . '<' // Find start of element.
  567. . '(?' // Conditional expression follows.
  568. . $escaped // Find end of escaped element.
  569. . '|' // ...else...
  570. . '[^>]*>?' // Find end of normal element.
  571. . ')'
  572. . ')/';
  573. // phpcs:enable
  574. }
  575. return $regex;
  576. }
  577. /**
  578. * Retrieve the combined regular expression for HTML and shortcodes.
  579. *
  580. * @access private
  581. * @ignore
  582. * @internal This function will be removed in 4.5.0 per Shortcode API Roadmap.
  583. * @since 4.4.0
  584. *
  585. * @param string $shortcode_regex The result from _get_wptexturize_shortcode_regex(). Optional.
  586. * @return string The regular expression
  587. */
  588. function _get_wptexturize_split_regex( $shortcode_regex = '' ) {
  589. static $html_regex;
  590. if ( ! isset( $html_regex ) ) {
  591. // phpcs:disable Squiz.Strings.ConcatenationSpacing.PaddingFound -- don't remove regex indentation
  592. $comment_regex =
  593. '!' // Start of comment, after the <.
  594. . '(?:' // Unroll the loop: Consume everything until --> is found.
  595. . '-(?!->)' // Dash not followed by end of comment.
  596. . '[^\-]*+' // Consume non-dashes.
  597. . ')*+' // Loop possessively.
  598. . '(?:-->)?'; // End of comment. If not found, match all input.
  599. $html_regex = // Needs replaced with wp_html_split() per Shortcode API Roadmap.
  600. '<' // Find start of element.
  601. . '(?(?=!--)' // Is this a comment?
  602. . $comment_regex // Find end of comment.
  603. . '|'
  604. . '[^>]*>?' // Find end of element. If not found, match all input.
  605. . ')';
  606. // phpcs:enable
  607. }
  608. if ( empty( $shortcode_regex ) ) {
  609. $regex = '/(' . $html_regex . ')/';
  610. } else {
  611. $regex = '/(' . $html_regex . '|' . $shortcode_regex . ')/';
  612. }
  613. return $regex;
  614. }
  615. /**
  616. * Retrieve the regular expression for shortcodes.
  617. *
  618. * @access private
  619. * @ignore
  620. * @since 4.4.0
  621. *
  622. * @param string[] $tagnames Array of shortcodes to find.
  623. * @return string The regular expression
  624. */
  625. function _get_wptexturize_shortcode_regex( $tagnames ) {
  626. $tagregexp = implode( '|', array_map( 'preg_quote', $tagnames ) );
  627. $tagregexp = "(?:$tagregexp)(?=[\\s\\]\\/])"; // Excerpt of get_shortcode_regex().
  628. // phpcs:disable Squiz.Strings.ConcatenationSpacing.PaddingFound -- don't remove regex indentation
  629. $regex =
  630. '\[' // Find start of shortcode.
  631. . '[\/\[]?' // Shortcodes may begin with [/ or [[.
  632. . $tagregexp // Only match registered shortcodes, because performance.
  633. . '(?:'
  634. . '[^\[\]<>]+' // Shortcodes do not contain other shortcodes. Quantifier critical.
  635. . '|'
  636. . '<[^\[\]>]*>' // HTML elements permitted. Prevents matching ] before >.
  637. . ')*+' // Possessive critical.
  638. . '\]' // Find end of shortcode.
  639. . '\]?'; // Shortcodes may end with ]].
  640. // phpcs:enable
  641. return $regex;
  642. }
  643. /**
  644. * Replace characters or phrases within HTML elements only.
  645. *
  646. * @since 4.2.3
  647. *
  648. * @param string $haystack The text which has to be formatted.
  649. * @param array $replace_pairs In the form array('from' => 'to', ...).
  650. * @return string The formatted text.
  651. */
  652. function wp_replace_in_html_tags( $haystack, $replace_pairs ) {
  653. // Find all elements.
  654. $textarr = wp_html_split( $haystack );
  655. $changed = false;
  656. // Optimize when searching for one item.
  657. if ( 1 === count( $replace_pairs ) ) {
  658. // Extract $needle and $replace.
  659. foreach ( $replace_pairs as $needle => $replace ) {
  660. }
  661. // Loop through delimiters (elements) only.
  662. for ( $i = 1, $c = count( $textarr ); $i < $c; $i += 2 ) {
  663. if ( false !== strpos( $textarr[ $i ], $needle ) ) {
  664. $textarr[ $i ] = str_replace( $needle, $replace, $textarr[ $i ] );
  665. $changed = true;
  666. }
  667. }
  668. } else {
  669. // Extract all $needles.
  670. $needles = array_keys( $replace_pairs );
  671. // Loop through delimiters (elements) only.
  672. for ( $i = 1, $c = count( $textarr ); $i < $c; $i += 2 ) {
  673. foreach ( $needles as $needle ) {
  674. if ( false !== strpos( $textarr[ $i ], $needle ) ) {
  675. $textarr[ $i ] = strtr( $textarr[ $i ], $replace_pairs );
  676. $changed = true;
  677. // After one strtr() break out of the foreach loop and look at next element.
  678. break;
  679. }
  680. }
  681. }
  682. }
  683. if ( $changed ) {
  684. $haystack = implode( $textarr );
  685. }
  686. return $haystack;
  687. }
  688. /**
  689. * Newline preservation help function for wpautop
  690. *
  691. * @since 3.1.0
  692. * @access private
  693. *
  694. * @param array $matches preg_replace_callback matches array
  695. * @return string
  696. */
  697. function _autop_newline_preservation_helper( $matches ) {
  698. return str_replace( "\n", '<WPPreserveNewline />', $matches[0] );
  699. }
  700. /**
  701. * Don't auto-p wrap shortcodes that stand alone
  702. *
  703. * Ensures that shortcodes are not wrapped in `<p>...</p>`.
  704. *
  705. * @since 2.9.0
  706. *
  707. * @global array $shortcode_tags
  708. *
  709. * @param string $pee The content.
  710. * @return string The filtered content.
  711. */
  712. function shortcode_unautop( $pee ) {
  713. global $shortcode_tags;
  714. if ( empty( $shortcode_tags ) || ! is_array( $shortcode_tags ) ) {
  715. return $pee;
  716. }
  717. $tagregexp = implode( '|', array_map( 'preg_quote', array_keys( $shortcode_tags ) ) );
  718. $spaces = wp_spaces_regexp();
  719. // phpcs:disable Squiz.Strings.ConcatenationSpacing.PaddingFound,WordPress.WhiteSpace.PrecisionAlignment.Found -- don't remove regex indentation
  720. $pattern =
  721. '/'
  722. . '<p>' // Opening paragraph.
  723. . '(?:' . $spaces . ')*+' // Optional leading whitespace.
  724. . '(' // 1: The shortcode.
  725. . '\\[' // Opening bracket.
  726. . "($tagregexp)" // 2: Shortcode name.
  727. . '(?![\\w-])' // Not followed by word character or hyphen.
  728. // Unroll the loop: Inside the opening shortcode tag.
  729. . '[^\\]\\/]*' // Not a closing bracket or forward slash.
  730. . '(?:'
  731. . '\\/(?!\\])' // A forward slash not followed by a closing bracket.
  732. . '[^\\]\\/]*' // Not a closing bracket or forward slash.
  733. . ')*?'
  734. . '(?:'
  735. . '\\/\\]' // Self closing tag and closing bracket.
  736. . '|'
  737. . '\\]' // Closing bracket.
  738. . '(?:' // Unroll the loop: Optionally, anything between the opening and closing shortcode tags.
  739. . '[^\\[]*+' // Not an opening bracket.
  740. . '(?:'
  741. . '\\[(?!\\/\\2\\])' // An opening bracket not followed by the closing shortcode tag.
  742. . '[^\\[]*+' // Not an opening bracket.
  743. . ')*+'
  744. . '\\[\\/\\2\\]' // Closing shortcode tag.
  745. . ')?'
  746. . ')'
  747. . ')'
  748. . '(?:' . $spaces . ')*+' // Optional trailing whitespace.
  749. . '<\\/p>' // Closing paragraph.
  750. . '/';
  751. // phpcs:enable
  752. return preg_replace( $pattern, '$1', $pee );
  753. }
  754. /**
  755. * Checks to see if a string is utf8 encoded.
  756. *
  757. * NOTE: This function checks for 5-Byte sequences, UTF8
  758. * has Bytes Sequences with a maximum length of 4.
  759. *
  760. * @author bmorel at ssi dot fr (modified)
  761. * @since 1.2.1
  762. *
  763. * @param string $str The string to be checked
  764. * @return bool True if $str fits a UTF-8 model, false otherwise.
  765. */
  766. function seems_utf8( $str ) {
  767. mbstring_binary_safe_encoding();
  768. $length = strlen( $str );
  769. reset_mbstring_encoding();
  770. for ( $i = 0; $i < $length; $i++ ) {
  771. $c = ord( $str[ $i ] );
  772. if ( $c < 0x80 ) {
  773. $n = 0; // 0bbbbbbb
  774. } elseif ( ( $c & 0xE0 ) == 0xC0 ) {
  775. $n = 1; // 110bbbbb
  776. } elseif ( ( $c & 0xF0 ) == 0xE0 ) {
  777. $n = 2; // 1110bbbb
  778. } elseif ( ( $c & 0xF8 ) == 0xF0 ) {
  779. $n = 3; // 11110bbb
  780. } elseif ( ( $c & 0xFC ) == 0xF8 ) {
  781. $n = 4; // 111110bb
  782. } elseif ( ( $c & 0xFE ) == 0xFC ) {
  783. $n = 5; // 1111110b
  784. } else {
  785. return false; // Does not match any model.
  786. }
  787. for ( $j = 0; $j < $n; $j++ ) { // n bytes matching 10bbbbbb follow ?
  788. if ( ( ++$i == $length ) || ( ( ord( $str[ $i ] ) & 0xC0 ) != 0x80 ) ) {
  789. return false;
  790. }
  791. }
  792. }
  793. return true;
  794. }
  795. /**
  796. * Converts a number of special characters into their HTML entities.
  797. *
  798. * Specifically deals with: &, <, >, ", and '.
  799. *
  800. * $quote_style can be set to ENT_COMPAT to encode " to
  801. * &quot;, or ENT_QUOTES to do both. Default is ENT_NOQUOTES where no quotes are encoded.
  802. *
  803. * @since 1.2.2
  804. * @since 5.5.0 `$quote_style` also accepts `ENT_XML1`.
  805. * @access private
  806. *
  807. * @param string $string The text which is to be encoded.
  808. * @param int|string $quote_style Optional. Converts double quotes if set to ENT_COMPAT,
  809. * both single and double if set to ENT_QUOTES or none if set to ENT_NOQUOTES.
  810. * Converts single and double quotes, as well as converting HTML
  811. * named entities (that are not also XML named entities) to their
  812. * code points if set to ENT_XML1. Also compatible with old values;
  813. * converting single quotes if set to 'single',
  814. * double if set to 'double' or both if otherwise set.
  815. * Default is ENT_NOQUOTES.
  816. * @param false|string $charset Optional. The character encoding of the string. Default false.
  817. * @param bool $double_encode Optional. Whether to encode existing HTML entities. Default false.
  818. * @return string The encoded text with HTML entities.
  819. */
  820. function _wp_specialchars( $string, $quote_style = ENT_NOQUOTES, $charset = false, $double_encode = false ) {
  821. $string = (string) $string;
  822. if ( 0 === strlen( $string ) ) {
  823. return '';
  824. }
  825. // Don't bother if there are no specialchars - saves some processing.
  826. if ( ! preg_match( '/[&<>"\']/', $string ) ) {
  827. return $string;
  828. }
  829. // Account for the previous behaviour of the function when the $quote_style is not an accepted value.
  830. if ( empty( $quote_style ) ) {
  831. $quote_style = ENT_NOQUOTES;
  832. } elseif ( ENT_XML1 === $quote_style ) {
  833. $quote_style = ENT_QUOTES | ENT_XML1;
  834. } elseif ( ! in_array( $quote_style, array( ENT_NOQUOTES, ENT_COMPAT, ENT_QUOTES, 'single', 'double' ), true ) ) {
  835. $quote_style = ENT_QUOTES;
  836. }
  837. // Store the site charset as a static to avoid multiple calls to wp_load_alloptions().
  838. if ( ! $charset ) {
  839. static $_charset = null;
  840. if ( ! isset( $_charset ) ) {
  841. $alloptions = wp_load_alloptions();
  842. $_charset = isset( $alloptions['blog_charset'] ) ? $alloptions['blog_charset'] : '';
  843. }
  844. $charset = $_charset;
  845. }
  846. if ( in_array( $charset, array( 'utf8', 'utf-8', 'UTF8' ), true ) ) {
  847. $charset = 'UTF-8';
  848. }
  849. $_quote_style = $quote_style;
  850. if ( 'double' === $quote_style ) {
  851. $quote_style = ENT_COMPAT;
  852. $_quote_style = ENT_COMPAT;
  853. } elseif ( 'single' === $quote_style ) {
  854. $quote_style = ENT_NOQUOTES;
  855. }
  856. if ( ! $double_encode ) {
  857. // Guarantee every &entity; is valid, convert &garbage; into &amp;garbage;
  858. // This is required for PHP < 5.4.0 because ENT_HTML401 flag is unavailable.
  859. $string = wp_kses_normalize_entities( $string, ( $quote_style & ENT_XML1 ) ? 'xml' : 'html' );
  860. }
  861. $string = htmlspecialchars( $string, $quote_style, $charset, $double_encode );
  862. // Back-compat.
  863. if ( 'single' === $_quote_style ) {
  864. $string = str_replace( "'", '&#039;', $string );
  865. }
  866. return $string;
  867. }
  868. /**
  869. * Converts a number of HTML entities into their special characters.
  870. *
  871. * Specifically deals with: &, <, >, ", and '.
  872. *
  873. * $quote_style can be set to ENT_COMPAT to decode " entities,
  874. * or ENT_QUOTES to do both " and '. Default is ENT_NOQUOTES where no quotes are decoded.
  875. *
  876. * @since 2.8.0
  877. *
  878. * @param string $string The text which is to be decoded.
  879. * @param string|int $quote_style Optional. Converts double quotes if set to ENT_COMPAT,
  880. * both single and double if set to ENT_QUOTES or
  881. * none if set to ENT_NOQUOTES.
  882. * Also compatible with old _wp_specialchars() values;
  883. * converting single quotes if set to 'single',
  884. * double if set to 'double' or both if otherwise set.
  885. * Default is ENT_NOQUOTES.
  886. * @return string The decoded text without HTML entities.
  887. */
  888. function wp_specialchars_decode( $string, $quote_style = ENT_NOQUOTES ) {
  889. $string = (string) $string;
  890. if ( 0 === strlen( $string ) ) {
  891. return '';
  892. }
  893. // Don't bother if there are no entities - saves a lot of processing.
  894. if ( strpos( $string, '&' ) === false ) {
  895. return $string;
  896. }
  897. // Match the previous behaviour of _wp_specialchars() when the $quote_style is not an accepted value.
  898. if ( empty( $quote_style ) ) {
  899. $quote_style = ENT_NOQUOTES;
  900. } elseif ( ! in_array( $quote_style, array( 0, 2, 3, 'single', 'double' ), true ) ) {
  901. $quote_style = ENT_QUOTES;
  902. }
  903. // More complete than get_html_translation_table( HTML_SPECIALCHARS ).
  904. $single = array(
  905. '&#039;' => '\'',
  906. '&#x27;' => '\'',
  907. );
  908. $single_preg = array(
  909. '/&#0*39;/' => '&#039;',
  910. '/&#x0*27;/i' => '&#x27;',
  911. );
  912. $double = array(
  913. '&quot;' => '"',
  914. '&#034;' => '"',
  915. '&#x22;' => '"',
  916. );
  917. $double_preg = array(
  918. '/&#0*34;/' => '&#034;',
  919. '/&#x0*22;/i' => '&#x22;',
  920. );
  921. $others = array(
  922. '&lt;' => '<',
  923. '&#060;' => '<',
  924. '&gt;' => '>',
  925. '&#062;' => '>',
  926. '&amp;' => '&',
  927. '&#038;' => '&',
  928. '&#x26;' => '&',
  929. );
  930. $others_preg = array(
  931. '/&#0*60;/' => '&#060;',
  932. '/&#0*62;/' => '&#062;',
  933. '/&#0*38;/' => '&#038;',
  934. '/&#x0*26;/i' => '&#x26;',
  935. );
  936. if ( ENT_QUOTES === $quote_style ) {
  937. $translation = array_merge( $single, $double, $others );
  938. $translation_preg = array_merge( $single_preg, $double_preg, $others_preg );
  939. } elseif ( ENT_COMPAT === $quote_style || 'double' === $quote_style ) {
  940. $translation = array_merge( $double, $others );
  941. $translation_preg = array_merge( $double_preg, $others_preg );
  942. } elseif ( 'single' === $quote_style ) {
  943. $translation = array_merge( $single, $others );
  944. $translation_preg = array_merge( $single_preg, $others_preg );
  945. } elseif ( ENT_NOQUOTES === $quote_style ) {
  946. $translation = $others;
  947. $translation_preg = $others_preg;
  948. }
  949. // Remove zero padding on numeric entities.
  950. $string = preg_replace( array_keys( $translation_preg ), array_values( $translation_preg ), $string );
  951. // Replace characters according to translation table.
  952. return strtr( $string, $translation );
  953. }
  954. /**
  955. * Checks for invalid UTF8 in a string.
  956. *
  957. * @since 2.8.0
  958. *
  959. * @param string $string The text which is to be checked.
  960. * @param bool $strip Optional. Whether to attempt to strip out invalid UTF8. Default false.
  961. * @return string The checked text.
  962. */
  963. function wp_check_invalid_utf8( $string, $strip = false ) {
  964. $string = (string) $string;
  965. if ( 0 === strlen( $string ) ) {
  966. return '';
  967. }
  968. // Store the site charset as a static to avoid multiple calls to get_option().
  969. static $is_utf8 = null;
  970. if ( ! isset( $is_utf8 ) ) {
  971. $is_utf8 = in_array( get_option( 'blog_charset' ), array( 'utf8', 'utf-8', 'UTF8', 'UTF-8' ), true );
  972. }
  973. if ( ! $is_utf8 ) {
  974. return $string;
  975. }
  976. // Check for support for utf8 in the installed PCRE library once and store the result in a static.
  977. static $utf8_pcre = null;
  978. if ( ! isset( $utf8_pcre ) ) {
  979. // phpcs:ignore WordPress.PHP.NoSilencedErrors.Discouraged
  980. $utf8_pcre = @preg_match( '/^./u', 'a' );
  981. }
  982. // We can't demand utf8 in the PCRE installation, so just return the string in those cases.
  983. if ( ! $utf8_pcre ) {
  984. return $string;
  985. }
  986. // phpcs:ignore WordPress.PHP.NoSilencedErrors.Discouraged -- preg_match fails when it encounters invalid UTF8 in $string.
  987. if ( 1 === @preg_match( '/^./us', $string ) ) {
  988. return $string;
  989. }
  990. // Attempt to strip the bad chars if requested (not recommended).
  991. if ( $strip && function_exists( 'iconv' ) ) {
  992. return iconv( 'utf-8', 'utf-8', $string );
  993. }
  994. return '';
  995. }
  996. /**
  997. * Encode the Unicode values to be used in the URI.
  998. *
  999. * @since 1.5.0
  1000. * @since 5.8.3 Added the `encode_ascii_characters` parameter.
  1001. *
  1002. * @param string $utf8_string String to encode.
  1003. * @param int $length Max length of the string
  1004. * @param bool $encode_ascii_characters Whether to encode ascii characters such as < " '
  1005. * @return string String with Unicode encoded for URI.
  1006. */
  1007. function utf8_uri_encode( $utf8_string, $length = 0, $encode_ascii_characters = false ) {
  1008. $unicode = '';
  1009. $values = array();
  1010. $num_octets = 1;
  1011. $unicode_length = 0;
  1012. mbstring_binary_safe_encoding();
  1013. $string_length = strlen( $utf8_string );
  1014. reset_mbstring_encoding();
  1015. for ( $i = 0; $i < $string_length; $i++ ) {
  1016. $value = ord( $utf8_string[ $i ] );
  1017. if ( $value < 128 ) {
  1018. $char = chr( $value );
  1019. $encoded_char = $encode_ascii_characters ? rawurlencode( $char ) : $char;
  1020. $encoded_char_length = strlen( $encoded_char );
  1021. if ( $length && ( $unicode_length + $encoded_char_length ) > $length ) {
  1022. break;
  1023. }
  1024. $unicode .= $encoded_char;
  1025. $unicode_length += $encoded_char_length;
  1026. } else {
  1027. if ( count( $values ) == 0 ) {
  1028. if ( $value < 224 ) {
  1029. $num_octets = 2;
  1030. } elseif ( $value < 240 ) {
  1031. $num_octets = 3;
  1032. } else {
  1033. $num_octets = 4;
  1034. }
  1035. }
  1036. $values[] = $value;
  1037. if ( $length && ( $unicode_length + ( $num_octets * 3 ) ) > $length ) {
  1038. break;
  1039. }
  1040. if ( count( $values ) == $num_octets ) {
  1041. for ( $j = 0; $j < $num_octets; $j++ ) {
  1042. $unicode .= '%' . dechex( $values[ $j ] );
  1043. }
  1044. $unicode_length += $num_octets * 3;
  1045. $values = array();
  1046. $num_octets = 1;
  1047. }
  1048. }
  1049. }
  1050. return $unicode;
  1051. }
  1052. /**
  1053. * Converts all accent characters to ASCII characters.
  1054. *
  1055. * If there are no accent characters, then the string given is just returned.
  1056. *
  1057. * **Accent characters converted:**
  1058. *
  1059. * Currency signs:
  1060. *
  1061. * | Code | Glyph | Replacement | Description |
  1062. * | -------- | ----- | ----------- | ------------------- |
  1063. * | U+00A3 | £ | (empty) | British Pound sign |
  1064. * | U+20AC | € | E | Euro sign |
  1065. *
  1066. * Decompositions for Latin-1 Supplement:
  1067. *
  1068. * | Code | Glyph | Replacement | Description |
  1069. * | ------- | ----- | ----------- | -------------------------------------- |
  1070. * | U+00AA | ª | a | Feminine ordinal indicator |
  1071. * | U+00BA | º | o | Masculine ordinal indicator |
  1072. * | U+00C0 | À | A | Latin capital letter A with grave |
  1073. * | U+00C1 | Á | A | Latin capital letter A with acute |
  1074. * | U+00C2 | Â | A | Latin capital letter A with circumflex |
  1075. * | U+00C3 | Ã | A | Latin capital letter A with tilde |
  1076. * | U+00C4 | Ä | A | Latin capital letter A with diaeresis |
  1077. * | U+00C5 | Å | A | Latin capital letter A with ring above |
  1078. * | U+00C6 | Æ | AE | Latin capital letter AE |
  1079. * | U+00C7 | Ç | C | Latin capital letter C with cedilla |
  1080. * | U+00C8 | È | E | Latin capital letter E with grave |
  1081. * | U+00C9 | É | E | Latin capital letter E with acute |
  1082. * | U+00CA | Ê | E | Latin capital letter E with circumflex |
  1083. * | U+00CB | Ë | E | Latin capital letter E with diaeresis |
  1084. * | U+00CC | Ì | I | Latin capital letter I with grave |
  1085. * | U+00CD | Í | I | Latin capital letter I with acute |
  1086. * | U+00CE | Î | I | Latin capital letter I with circumflex |
  1087. * | U+00CF | Ï | I | Latin capital letter I with diaeresis |
  1088. * | U+00D0 | Ð | D | Latin capital letter Eth |
  1089. * | U+00D1 | Ñ | N | Latin capital letter N with tilde |
  1090. * | U+00D2 | Ò | O | Latin capital letter O with grave |
  1091. * | U+00D3 | Ó | O | Latin capital letter O with acute |
  1092. * | U+00D4 | Ô | O | Latin capital letter O with circumflex |
  1093. * | U+00D5 | Õ | O | Latin capital letter O with tilde |
  1094. * | U+00D6 | Ö | O | Latin capital letter O with diaeresis |
  1095. * | U+00D8 | Ø | O | Latin capital letter O with stroke |
  1096. * | U+00D9 | Ù | U | Latin capital letter U with grave |
  1097. * | U+00DA | Ú | U | Latin capital letter U with acute |
  1098. * | U+00DB | Û | U | Latin capital letter U with circumflex |
  1099. * | U+00DC | Ü | U | Latin capital letter U with diaeresis |
  1100. * | U+00DD | Ý | Y | Latin capital letter Y with acute |
  1101. * | U+00DE | Þ | TH | Latin capital letter Thorn |
  1102. * | U+00DF | ß | s | Latin small letter sharp s |
  1103. * | U+00E0 | à | a | Latin small letter a with grave |
  1104. * | U+00E1 | á | a | Latin small letter a with acute |
  1105. * | U+00E2 | â | a | Latin small letter a with circumflex |
  1106. * | U+00E3 | ã | a | Latin small letter a with tilde |
  1107. * | U+00E4 | ä | a | Latin small letter a with diaeresis |
  1108. * | U+00E5 | å | a | Latin small letter a with ring above |
  1109. * | U+00E6 | æ | ae | Latin small letter ae |
  1110. * | U+00E7 | ç | c | Latin small letter c with cedilla |
  1111. * | U+00E8 | è | e | Latin small letter e with grave |
  1112. * | U+00E9 | é | e | Latin small letter e with acute |
  1113. * | U+00EA | ê | e | Latin small letter e with circumflex |
  1114. * | U+00EB | ë | e | Latin small letter e with diaeresis |
  1115. * | U+00EC | ì | i | Latin small letter i with grave |
  1116. * | U+00ED | í | i | Latin small letter i with acute |
  1117. * | U+00EE | î | i | Latin small letter i with circumflex |
  1118. * | U+00EF | ï | i | Latin small letter i with diaeresis |
  1119. * | U+00F0 | ð | d | Latin small letter Eth |
  1120. * | U+00F1 | ñ | n | Latin small letter n with tilde |
  1121. * | U+00F2 | ò | o | Latin small letter o with grave |
  1122. * | U+00F3 | ó | o | Latin small letter o with acute |
  1123. * | U+00F4 | ô | o | Latin small letter o with circumflex |
  1124. * | U+00F5 | õ | o | Latin small letter o with tilde |
  1125. * | U+00F6 | ö | o | Latin small letter o with diaeresis |
  1126. * | U+00F8 | ø | o | Latin small letter o with stroke |
  1127. * | U+00F9 | ù | u | Latin small letter u with grave |
  1128. * | U+00FA | ú | u | Latin small letter u with acute |
  1129. * | U+00FB | û | u | Latin small letter u with circumflex |
  1130. * | U+00FC | ü | u | Latin small letter u with diaeresis |
  1131. * | U+00FD | ý | y | Latin small letter y with acute |
  1132. * | U+00FE | þ | th | Latin small letter Thorn |
  1133. * | U+00FF | ÿ | y | Latin small letter y with diaeresis |
  1134. *
  1135. * Decompositions for Latin Extended-A:
  1136. *
  1137. * | Code | Glyph | Replacement | Description |
  1138. * | ------- | ----- | ----------- | ------------------------------------------------- |
  1139. * | U+0100 | Ā | A | Latin capital letter A with macron |
  1140. * | U+0101 | ā | a | Latin small letter a with macron |
  1141. * | U+0102 | Ă | A | Latin capital letter A with breve |
  1142. * | U+0103 | ă | a | Latin small letter a with breve |
  1143. * | U+0104 | Ą | A | Latin capital letter A with ogonek |
  1144. * | U+0105 | ą | a | Latin small letter a with ogonek |
  1145. * | U+01006 | Ć | C | Latin capital letter C with acute |
  1146. * | U+0107 | ć | c | Latin small letter c with acute |
  1147. * | U+0108 | Ĉ | C | Latin capital letter C with circumflex |
  1148. * | U+0109 | ĉ | c | Latin small letter c with circumflex |
  1149. * | U+010A | Ċ | C | Latin capital letter C with dot above |
  1150. * | U+010B | ċ | c | Latin small letter c with dot above |
  1151. * | U+010C | Č | C | Latin capital letter C with caron |
  1152. * | U+010D | č | c | Latin small letter c with caron |
  1153. * | U+010E | Ď | D | Latin capital letter D with caron |
  1154. * | U+010F | ď | d | Latin small letter d with caron |
  1155. * | U+0110 | Đ | D | Latin capital letter D with stroke |
  1156. * | U+0111 | đ | d | Latin small letter d with stroke |
  1157. * | U+0112 | Ē | E | Latin capital letter E with macron |
  1158. * | U+0113 | ē | e | Latin small letter e with macron |
  1159. * | U+0114 | Ĕ | E | Latin capital letter E with breve |
  1160. * | U+0115 | ĕ | e | Latin small letter e with breve |
  1161. * | U+0116 | Ė | E | Latin capital letter E with dot above |
  1162. * | U+0117 | ė | e | Latin small letter e with dot above |
  1163. * | U+0118 | Ę | E | Latin capital letter E with ogonek |
  1164. * | U+0119 | ę | e | Latin small letter e with ogonek |
  1165. * | U+011A | Ě | E | Latin capital letter E with caron |
  1166. * | U+011B | ě | e | Latin small letter e with caron |
  1167. * | U+011C | Ĝ | G | Latin capital letter G with circumflex |
  1168. * | U+011D | ĝ | g | Latin small letter g with circumflex |
  1169. * | U+011E | Ğ | G | Latin capital letter G with breve |
  1170. * | U+011F | ğ | g | Latin small letter g with breve |
  1171. * | U+0120 | Ġ | G | Latin capital letter G with dot above |
  1172. * | U+0121 | ġ | g | Latin small letter g with dot above |
  1173. * | U+0122 | Ģ | G | Latin capital letter G with cedilla |
  1174. * | U+0123 | ģ | g | Latin small letter g with cedilla |
  1175. * | U+0124 | Ĥ | H | Latin capital letter H with circumflex |
  1176. * | U+0125 | ĥ | h | Latin small letter h with circumflex |
  1177. * | U+0126 | Ħ | H | Latin capital letter H with stroke |
  1178. * | U+0127 | ħ | h | Latin small letter h with stroke |
  1179. * | U+0128 | Ĩ | I | Latin capital letter I with tilde |
  1180. * | U+0129 | ĩ | i | Latin small letter i with tilde |
  1181. * | U+012A | Ī | I | Latin capital letter I with macron |
  1182. * | U+012B | ī | i | Latin small letter i with macron |
  1183. * | U+012C | Ĭ | I | Latin capital letter I with breve |
  1184. * | U+012D | ĭ | i | Latin small letter i with breve |
  1185. * | U+012E | Į | I | Latin capital letter I with ogonek |
  1186. * | U+012F | į | i | Latin small letter i with ogonek |
  1187. * | U+0130 | İ | I | Latin capital letter I with dot above |
  1188. * | U+0131 | ı | i | Latin small letter dotless i |
  1189. * | U+0132 | IJ | IJ | Latin capital ligature IJ |
  1190. * | U+0133 | ij | ij | Latin small ligature ij |
  1191. * | U+0134 | Ĵ | J | Latin capital letter J with circumflex |
  1192. * | U+0135 | ĵ | j | Latin small letter j with circumflex |
  1193. * | U+0136 | Ķ | K | Latin capital letter K with cedilla |
  1194. * | U+0137 | ķ | k | Latin small letter k with cedilla |
  1195. * | U+0138 | ĸ | k | Latin small letter Kra |
  1196. * | U+0139 | Ĺ | L | Latin capital letter L with acute |
  1197. * | U+013A | ĺ | l | Latin small letter l with acute |
  1198. * | U+013B | Ļ | L | Latin capital letter L with cedilla |
  1199. * | U+013C | ļ | l | Latin small letter l with cedilla |
  1200. * | U+013D | Ľ | L | Latin capital letter L with caron |
  1201. * | U+013E | ľ | l | Latin small letter l with caron |
  1202. * | U+013F | Ŀ | L | Latin capital letter L with middle dot |
  1203. * | U+0140 | ŀ | l | Latin small letter l with middle dot |
  1204. * | U+0141 | Ł | L | Latin capital letter L with stroke |
  1205. * | U+0142 | ł | l | Latin small letter l with stroke |
  1206. * | U+0143 | Ń | N | Latin capital letter N with acute |
  1207. * | U+0144 | ń | n | Latin small letter N with acute |
  1208. * | U+0145 | Ņ | N | Latin capital letter N with cedilla |
  1209. * | U+0146 | ņ | n | Latin small letter n with cedilla |
  1210. * | U+0147 | Ň | N | Latin capital letter N with caron |
  1211. * | U+0148 | ň | n | Latin small letter n with caron |
  1212. * | U+0149 | ʼn | n | Latin small letter n preceded by apostrophe |
  1213. * | U+014A | Ŋ | N | Latin capital letter Eng |
  1214. * | U+014B | ŋ | n | Latin small letter Eng |
  1215. * | U+014C | Ō | O | Latin capital letter O with macron |
  1216. * | U+014D | ō | o | Latin small letter o with macron |
  1217. * | U+014E | Ŏ | O | Latin capital letter O with breve |
  1218. * | U+014F | ŏ | o | Latin small letter o with breve |
  1219. * | U+0150 | Ő | O | Latin capital letter O with double acute |
  1220. * | U+0151 | ő | o | Latin small letter o with double acute |
  1221. * | U+0152 | Π| OE | Latin capital ligature OE |
  1222. * | U+0153 | œ | oe | Latin small ligature oe |
  1223. * | U+0154 | Ŕ | R | Latin capital letter R with acute |
  1224. * | U+0155 | ŕ | r | Latin small letter r with acute |
  1225. * | U+0156 | Ŗ | R | Latin capital letter R with cedilla |
  1226. * | U+0157 | ŗ | r | Latin small letter r with cedilla |
  1227. * | U+0158 | Ř | R | Latin capital letter R with caron |
  1228. * | U+0159 | ř | r | Latin small letter r with caron |
  1229. * | U+015A | Ś | S | Latin capital letter S with acute |
  1230. * | U+015B | ś | s | Latin small letter s with acute |
  1231. * | U+015C | Ŝ | S | Latin capital letter S with circumflex |
  1232. * | U+015D | ŝ | s | Latin small letter s with circumflex |
  1233. * | U+015E | Ş | S | Latin capital letter S with cedilla |
  1234. * | U+015F | ş | s | Latin small letter s with cedilla |
  1235. * | U+0160 | Š | S | Latin capital letter S with caron |
  1236. * | U+0161 | š | s | Latin small letter s with caron |
  1237. * | U+0162 | Ţ | T | Latin capital letter T with cedilla |
  1238. * | U+0163 | ţ | t | Latin small letter t with cedilla |
  1239. * | U+0164 | Ť | T | Latin capital letter T with caron |
  1240. * | U+0165 | ť | t | Latin small letter t with caron |
  1241. * | U+0166 | Ŧ | T | Latin capital letter T with stroke |
  1242. * | U+0167 | ŧ | t | Latin small letter t with stroke |
  1243. * | U+0168 | Ũ | U | Latin capital letter U with tilde |
  1244. * | U+0169 | ũ | u | Latin small letter u with tilde |
  1245. * | U+016A | Ū | U | Latin capital letter U with macron |
  1246. * | U+016B | ū | u | Latin small letter u with macron |
  1247. * | U+016C | Ŭ | U | Latin capital letter U with breve |
  1248. * | U+016D | ŭ | u | Latin small letter u with breve |
  1249. * | U+016E | Ů | U | Latin capital letter U with ring above |
  1250. * | U+016F | ů | u | Latin small letter u with ring above |
  1251. * | U+0170 | Ű | U | Latin capital letter U with double acute |
  1252. * | U+0171 | ű | u | Latin small letter u with double acute |
  1253. * | U+0172 | Ų | U | Latin capital letter U with ogonek |
  1254. * | U+0173 | ų | u | Latin small letter u with ogonek |
  1255. * | U+0174 | Ŵ | W | Latin capital letter W with circumflex |
  1256. * | U+0175 | ŵ | w | Latin small letter w with circumflex |
  1257. * | U+0176 | Ŷ | Y | Latin capital letter Y with circumflex |
  1258. * | U+0177 | ŷ | y | Latin small letter y with circumflex |
  1259. * | U+0178 | Ÿ | Y | Latin capital letter Y with diaeresis |
  1260. * | U+0179 | Ź | Z | Latin capital letter Z with acute |
  1261. * | U+017A | ź | z | Latin small letter z with acute |
  1262. * | U+017B | Ż | Z | Latin capital letter Z with dot above |
  1263. * | U+017C | ż | z | Latin small letter z with dot above |
  1264. * | U+017D | Ž | Z | Latin capital letter Z with caron |
  1265. * | U+017E | ž | z | Latin small letter z with caron |
  1266. * | U+017F | ſ | s | Latin small letter long s |
  1267. * | U+01A0 | Ơ | O | Latin capital letter O with horn |
  1268. * | U+01A1 | ơ | o | Latin small letter o with horn |
  1269. * | U+01AF | Ư | U | Latin capital letter U with horn |
  1270. * | U+01B0 | ư | u | Latin small letter u with horn |
  1271. * | U+01CD | Ǎ | A | Latin capital letter A with caron |
  1272. * | U+01CE | ǎ | a | Latin small letter a with caron |
  1273. * | U+01CF | Ǐ | I | Latin capital letter I with caron |
  1274. * | U+01D0 | ǐ | i | Latin small letter i with caron |
  1275. * | U+01D1 | Ǒ | O | Latin capital letter O with caron |
  1276. * | U+01D2 | ǒ | o | Latin small letter o with caron |
  1277. * | U+01D3 | Ǔ | U | Latin capital letter U with caron |
  1278. * | U+01D4 | ǔ | u | Latin small letter u with caron |
  1279. * | U+01D5 | Ǖ | U | Latin capital letter U with diaeresis and macron |
  1280. * | U+01D6 | ǖ | u | Latin small letter u with diaeresis and macron |
  1281. * | U+01D7 | Ǘ | U | Latin capital letter U with diaeresis and acute |
  1282. * | U+01D8 | ǘ | u | Latin small letter u with diaeresis and acute |
  1283. * | U+01D9 | Ǚ | U | Latin capital letter U with diaeresis and caron |
  1284. * | U+01DA | ǚ | u | Latin small letter u with diaeresis and caron |
  1285. * | U+01DB | Ǜ | U | Latin capital letter U with diaeresis and grave |
  1286. * | U+01DC | ǜ | u | Latin small letter u with diaeresis and grave |
  1287. *
  1288. * Decompositions for Latin Extended-B:
  1289. *
  1290. * | Code | Glyph | Replacement | Description |
  1291. * | -------- | ----- | ----------- | ----------------------------------------- |
  1292. * | U+0218 | Ș | S | Latin capital letter S with comma below |
  1293. * | U+0219 | ș | s | Latin small letter s with comma below |
  1294. * | U+021A | Ț | T | Latin capital letter T with comma below |
  1295. * | U+021B | ț | t | Latin small letter t with comma below |
  1296. *
  1297. * Vowels with diacritic (Chinese, Hanyu Pinyin):
  1298. *
  1299. * | Code | Glyph | Replacement | Description |
  1300. * | -------- | ----- | ----------- | ----------------------------------------------------- |
  1301. * | U+0251 | ɑ | a | Latin small letter alpha |
  1302. * | U+1EA0 | Ạ | A | Latin capital letter A with dot below |
  1303. * | U+1EA1 | ạ | a | Latin small letter a with dot below |
  1304. * | U+1EA2 | Ả | A | Latin capital letter A with hook above |
  1305. * | U+1EA3 | ả | a | Latin small letter a with hook above |
  1306. * | U+1EA4 | Ấ | A | Latin capital letter A with circumflex and acute |
  1307. * | U+1EA5 | ấ | a | Latin small letter a with circumflex and acute |
  1308. * | U+1EA6 | Ầ | A | Latin capital letter A with circumflex and grave |
  1309. * | U+1EA7 | ầ | a | Latin small letter a with circumflex and grave |
  1310. * | U+1EA8 | Ẩ | A | Latin capital letter A with circumflex and hook above |
  1311. * | U+1EA9 | ẩ | a | Latin small letter a with circumflex and hook above |
  1312. * | U+1EAA | Ẫ | A | Latin capital letter A with circumflex and tilde |
  1313. * | U+1EAB | ẫ | a | Latin small letter a with circumflex and tilde |
  1314. * | U+1EA6 | Ậ | A | Latin capital letter A with circumflex and dot below |
  1315. * | U+1EAD | ậ | a | Latin small letter a with circumflex and dot below |
  1316. * | U+1EAE | Ắ | A | Latin capital letter A with breve and acute |
  1317. * | U+1EAF | ắ | a | Latin small letter a with breve and acute |
  1318. * | U+1EB0 | Ằ | A | Latin capital letter A with breve and grave |
  1319. * | U+1EB1 | ằ | a | Latin small letter a with breve and grave |
  1320. * | U+1EB2 | Ẳ | A | Latin capital letter A with breve and hook above |
  1321. * | U+1EB3 | ẳ | a | Latin small letter a with breve and hook above |
  1322. * | U+1EB4 | Ẵ | A | Latin capital letter A with breve and tilde |
  1323. * | U+1EB5 | ẵ | a | Latin small letter a with breve and tilde |
  1324. * | U+1EB6 | Ặ | A | Latin capital letter A with breve and dot below |
  1325. * | U+1EB7 | ặ | a | Latin small letter a with breve and dot below |
  1326. * | U+1EB8 | Ẹ | E | Latin capital letter E with dot below |
  1327. * | U+1EB9 | ẹ | e | Latin small letter e with dot below |
  1328. * | U+1EBA | Ẻ | E | Latin capital letter E with hook above |
  1329. * | U+1EBB | ẻ | e | Latin small letter e with hook above |
  1330. * | U+1EBC | Ẽ | E | Latin capital letter E with tilde |
  1331. * | U+1EBD | ẽ | e | Latin small letter e with tilde |
  1332. * | U+1EBE | Ế | E | Latin capital letter E with circumflex and acute |
  1333. * | U+1EBF | ế | e | Latin small letter e with circumflex and acute |
  1334. * | U+1EC0 | Ề | E | Latin capital letter E with circumflex and grave |
  1335. * | U+1EC1 | ề | e | Latin small letter e with circumflex and grave |
  1336. * | U+1EC2 | Ể | E | Latin capital letter E with circumflex and hook above |
  1337. * | U+1EC3 | ể | e | Latin small letter e with circumflex and hook above |
  1338. * | U+1EC4 | Ễ | E | Latin capital letter E with circumflex and tilde |
  1339. * | U+1EC5 | ễ | e | Latin small letter e with circumflex and tilde |
  1340. * | U+1EC6 | Ệ | E | Latin capital letter E with circumflex and dot below |
  1341. * | U+1EC7 | ệ | e | Latin small letter e with circumflex and dot below |
  1342. * | U+1EC8 | Ỉ | I | Latin capital letter I with hook above |
  1343. * | U+1EC9 | ỉ | i | Latin small letter i with hook above |
  1344. * | U+1ECA | Ị | I | Latin capital letter I with dot below |
  1345. * | U+1ECB | ị | i | Latin small letter i with dot below |
  1346. * | U+1ECC | Ọ | O | Latin capital letter O with dot below |
  1347. * | U+1ECD | ọ | o | Latin small letter o with dot below |
  1348. * | U+1ECE | Ỏ | O | Latin capital letter O with hook above |
  1349. * | U+1ECF | ỏ | o | Latin small letter o with hook above |
  1350. * | U+1ED0 | Ố | O | Latin capital letter O with circumflex and acute |
  1351. * | U+1ED1 | ố | o | Latin small letter o with circumflex and acute |
  1352. * | U+1ED2 | Ồ | O | Latin capital letter O with circumflex and grave |
  1353. * | U+1ED3 | ồ | o | Latin small letter o with circumflex and grave |
  1354. * | U+1ED4 | Ổ | O | Latin capital letter O with circumflex and hook above |
  1355. * | U+1ED5 | ổ | o | Latin small letter o with circumflex and hook above |
  1356. * | U+1ED6 | Ỗ | O | Latin capital letter O with circumflex and tilde |
  1357. * | U+1ED7 | ỗ | o | Latin small letter o with circumflex and tilde |
  1358. * | U+1ED8 | Ộ | O | Latin capital letter O with circumflex and dot below |
  1359. * | U+1ED9 | ộ | o | Latin small letter o with circumflex and dot below |
  1360. * | U+1EDA | Ớ | O | Latin capital letter O with horn and acute |
  1361. * | U+1EDB | ớ | o | Latin small letter o with horn and acute |
  1362. * | U+1EDC | Ờ | O | Latin capital letter O with horn and grave |
  1363. * | U+1EDD | ờ | o | Latin small letter o with horn and grave |
  1364. * | U+1EDE | Ở | O | Latin capital letter O with horn and hook above |
  1365. * | U+1EDF | ở | o | Latin small letter o with horn and hook above |
  1366. * | U+1EE0 | Ỡ | O | Latin capital letter O with horn and tilde |
  1367. * | U+1EE1 | ỡ | o | Latin small letter o with horn and tilde |
  1368. * | U+1EE2 | Ợ | O | Latin capital letter O with horn and dot below |
  1369. * | U+1EE3 | ợ | o | Latin small letter o with horn and dot below |
  1370. * | U+1EE4 | Ụ | U | Latin capital letter U with dot below |
  1371. * | U+1EE5 | ụ | u | Latin small letter u with dot below |
  1372. * | U+1EE6 | Ủ | U | Latin capital letter U with hook above |
  1373. * | U+1EE7 | ủ | u | Latin small letter u with hook above |
  1374. * | U+1EE8 | Ứ | U | Latin capital letter U with horn and acute |
  1375. * | U+1EE9 | ứ | u | Latin small letter u with horn and acute |
  1376. * | U+1EEA | Ừ | U | Latin capital letter U with horn and grave |
  1377. * | U+1EEB | ừ | u | Latin small letter u with horn and grave |
  1378. * | U+1EEC | Ử | U | Latin capital letter U with horn and hook above |
  1379. * | U+1EED | ử | u | Latin small letter u with horn and hook above |
  1380. * | U+1EEE | Ữ | U | Latin capital letter U with horn and tilde |
  1381. * | U+1EEF | ữ | u | Latin small letter u with horn and tilde |
  1382. * | U+1EF0 | Ự | U | Latin capital letter U with horn and dot below |
  1383. * | U+1EF1 | ự | u | Latin small letter u with horn and dot below |
  1384. * | U+1EF2 | Ỳ | Y | Latin capital letter Y with grave |
  1385. * | U+1EF3 | ỳ | y | Latin small letter y with grave |
  1386. * | U+1EF4 | Ỵ | Y | Latin capital letter Y with dot below |
  1387. * | U+1EF5 | ỵ | y | Latin small letter y with dot below |
  1388. * | U+1EF6 | Ỷ | Y | Latin capital letter Y with hook above |
  1389. * | U+1EF7 | ỷ | y | Latin small letter y with hook above |
  1390. * | U+1EF8 | Ỹ | Y | Latin capital letter Y with tilde |
  1391. * | U+1EF9 | ỹ | y | Latin small letter y with tilde |
  1392. *
  1393. * German (`de_DE`), German formal (`de_DE_formal`), German (Switzerland) formal (`de_CH`),
  1394. * German (Switzerland) informal (`de_CH_informal`), and German (Austria) (`de_AT`) locales:
  1395. *
  1396. * | Code | Glyph | Replacement | Description |
  1397. * | -------- | ----- | ----------- | --------------------------------------- |
  1398. * | U+00C4 | Ä | Ae | Latin capital letter A with diaeresis |
  1399. * | U+00E4 | ä | ae | Latin small letter a with diaeresis |
  1400. * | U+00D6 | Ö | Oe | Latin capital letter O with diaeresis |
  1401. * | U+00F6 | ö | oe | Latin small letter o with diaeresis |
  1402. * | U+00DC | Ü | Ue | Latin capital letter U with diaeresis |
  1403. * | U+00FC | ü | ue | Latin small letter u with diaeresis |
  1404. * | U+00DF | ß | ss | Latin small letter sharp s |
  1405. *
  1406. * Danish (`da_DK`) locale:
  1407. *
  1408. * | Code | Glyph | Replacement | Description |
  1409. * | -------- | ----- | ----------- | --------------------------------------- |
  1410. * | U+00C6 | Æ | Ae | Latin capital letter AE |
  1411. * | U+00E6 | æ | ae | Latin small letter ae |
  1412. * | U+00D8 | Ø | Oe | Latin capital letter O with stroke |
  1413. * | U+00F8 | ø | oe | Latin small letter o with stroke |
  1414. * | U+00C5 | Å | Aa | Latin capital letter A with ring above |
  1415. * | U+00E5 | å | aa | Latin small letter a with ring above |
  1416. *
  1417. * Catalan (`ca`) locale:
  1418. *
  1419. * | Code | Glyph | Replacement | Description |
  1420. * | -------- | ----- | ----------- | --------------------------------------- |
  1421. * | U+00B7 | l·l | ll | Flown dot (between two Ls) |
  1422. *
  1423. * Serbian (`sr_RS`) and Bosnian (`bs_BA`) locales:
  1424. *
  1425. * | Code | Glyph | Replacement | Description |
  1426. * | -------- | ----- | ----------- | --------------------------------------- |
  1427. * | U+0110 | Đ | DJ | Latin capital letter D with stroke |
  1428. * | U+0111 | đ | dj | Latin small letter d with stroke |
  1429. *
  1430. * @since 1.2.1
  1431. * @since 4.6.0 Added locale support for `de_CH`, `de_CH_informal`, and `ca`.
  1432. * @since 4.7.0 Added locale support for `sr_RS`.
  1433. * @since 4.8.0 Added locale support for `bs_BA`.
  1434. * @since 5.7.0 Added locale support for `de_AT`.
  1435. *
  1436. * @param string $string Text that might have accent characters
  1437. * @return string Filtered string with replaced "nice" characters.
  1438. */
  1439. function remove_accents( $string ) {
  1440. if ( ! preg_match( '/[\x80-\xff]/', $string ) ) {
  1441. return $string;
  1442. }
  1443. if ( seems_utf8( $string ) ) {
  1444. $chars = array(
  1445. // Decompositions for Latin-1 Supplement.
  1446. 'ª' => 'a',
  1447. 'º' => 'o',
  1448. 'À' => 'A',
  1449. 'Á' => 'A',
  1450. 'Â' => 'A',
  1451. 'Ã' => 'A',
  1452. 'Ä' => 'A',
  1453. 'Å' => 'A',
  1454. 'Æ' => 'AE',
  1455. 'Ç' => 'C',
  1456. 'È' => 'E',
  1457. 'É' => 'E',
  1458. 'Ê' => 'E',
  1459. 'Ë' => 'E',
  1460. 'Ì' => 'I',
  1461. 'Í' => 'I',
  1462. 'Î' => 'I',
  1463. 'Ï' => 'I',
  1464. 'Ð' => 'D',
  1465. 'Ñ' => 'N',
  1466. 'Ò' => 'O',
  1467. 'Ó' => 'O',
  1468. 'Ô' => 'O',
  1469. 'Õ' => 'O',
  1470. 'Ö' => 'O',
  1471. 'Ù' => 'U',
  1472. 'Ú' => 'U',
  1473. 'Û' => 'U',
  1474. 'Ü' => 'U',
  1475. 'Ý' => 'Y',
  1476. 'Þ' => 'TH',
  1477. 'ß' => 's',
  1478. 'à' => 'a',
  1479. 'á' => 'a',
  1480. 'â' => 'a',
  1481. 'ã' => 'a',
  1482. 'ä' => 'a',
  1483. 'å' => 'a',
  1484. 'æ' => 'ae',
  1485. 'ç' => 'c',
  1486. 'è' => 'e',
  1487. 'é' => 'e',
  1488. 'ê' => 'e',
  1489. 'ë' => 'e',
  1490. 'ì' => 'i',
  1491. 'í' => 'i',
  1492. 'î' => 'i',
  1493. 'ï' => 'i',
  1494. 'ð' => 'd',
  1495. 'ñ' => 'n',
  1496. 'ò' => 'o',
  1497. 'ó' => 'o',
  1498. 'ô' => 'o',
  1499. 'õ' => 'o',
  1500. 'ö' => 'o',
  1501. 'ø' => 'o',
  1502. 'ù' => 'u',
  1503. 'ú' => 'u',
  1504. 'û' => 'u',
  1505. 'ü' => 'u',
  1506. 'ý' => 'y',
  1507. 'þ' => 'th',
  1508. 'ÿ' => 'y',
  1509. 'Ø' => 'O',
  1510. // Decompositions for Latin Extended-A.
  1511. 'Ā' => 'A',
  1512. 'ā' => 'a',
  1513. 'Ă' => 'A',
  1514. 'ă' => 'a',
  1515. 'Ą' => 'A',
  1516. 'ą' => 'a',
  1517. 'Ć' => 'C',
  1518. 'ć' => 'c',
  1519. 'Ĉ' => 'C',
  1520. 'ĉ' => 'c',
  1521. 'Ċ' => 'C',
  1522. 'ċ' => 'c',
  1523. 'Č' => 'C',
  1524. 'č' => 'c',
  1525. 'Ď' => 'D',
  1526. 'ď' => 'd',
  1527. 'Đ' => 'D',
  1528. 'đ' => 'd',
  1529. 'Ē' => 'E',
  1530. 'ē' => 'e',
  1531. 'Ĕ' => 'E',
  1532. 'ĕ' => 'e',
  1533. 'Ė' => 'E',
  1534. 'ė' => 'e',
  1535. 'Ę' => 'E',
  1536. 'ę' => 'e',
  1537. 'Ě' => 'E',
  1538. 'ě' => 'e',
  1539. 'Ĝ' => 'G',
  1540. 'ĝ' => 'g',
  1541. 'Ğ' => 'G',
  1542. 'ğ' => 'g',
  1543. 'Ġ' => 'G',
  1544. 'ġ' => 'g',
  1545. 'Ģ' => 'G',
  1546. 'ģ' => 'g',
  1547. 'Ĥ' => 'H',
  1548. 'ĥ' => 'h',
  1549. 'Ħ' => 'H',
  1550. 'ħ' => 'h',
  1551. 'Ĩ' => 'I',
  1552. 'ĩ' => 'i',
  1553. 'Ī' => 'I',
  1554. 'ī' => 'i',
  1555. 'Ĭ' => 'I',
  1556. 'ĭ' => 'i',
  1557. 'Į' => 'I',
  1558. 'į' => 'i',
  1559. 'İ' => 'I',
  1560. 'ı' => 'i',
  1561. 'IJ' => 'IJ',
  1562. 'ij' => 'ij',
  1563. 'Ĵ' => 'J',
  1564. 'ĵ' => 'j',
  1565. 'Ķ' => 'K',
  1566. 'ķ' => 'k',
  1567. 'ĸ' => 'k',
  1568. 'Ĺ' => 'L',
  1569. 'ĺ' => 'l',
  1570. 'Ļ' => 'L',
  1571. 'ļ' => 'l',
  1572. 'Ľ' => 'L',
  1573. 'ľ' => 'l',
  1574. 'Ŀ' => 'L',
  1575. 'ŀ' => 'l',
  1576. 'Ł' => 'L',
  1577. 'ł' => 'l',
  1578. 'Ń' => 'N',
  1579. 'ń' => 'n',
  1580. 'Ņ' => 'N',
  1581. 'ņ' => 'n',
  1582. 'Ň' => 'N',
  1583. 'ň' => 'n',
  1584. 'ʼn' => 'n',
  1585. 'Ŋ' => 'N',
  1586. 'ŋ' => 'n',
  1587. 'Ō' => 'O',
  1588. 'ō' => 'o',
  1589. 'Ŏ' => 'O',
  1590. 'ŏ' => 'o',
  1591. 'Ő' => 'O',
  1592. 'ő' => 'o',
  1593. 'Œ' => 'OE',
  1594. 'œ' => 'oe',
  1595. 'Ŕ' => 'R',
  1596. 'ŕ' => 'r',
  1597. 'Ŗ' => 'R',
  1598. 'ŗ' => 'r',
  1599. 'Ř' => 'R',
  1600. 'ř' => 'r',
  1601. 'Ś' => 'S',
  1602. 'ś' => 's',
  1603. 'Ŝ' => 'S',
  1604. 'ŝ' => 's',
  1605. 'Ş' => 'S',
  1606. 'ş' => 's',
  1607. 'Š' => 'S',
  1608. 'š' => 's',
  1609. 'Ţ' => 'T',
  1610. 'ţ' => 't',
  1611. 'Ť' => 'T',
  1612. 'ť' => 't',
  1613. 'Ŧ' => 'T',
  1614. 'ŧ' => 't',
  1615. 'Ũ' => 'U',
  1616. 'ũ' => 'u',
  1617. 'Ū' => 'U',
  1618. 'ū' => 'u',
  1619. 'Ŭ' => 'U',
  1620. 'ŭ' => 'u',
  1621. 'Ů' => 'U',
  1622. 'ů' => 'u',
  1623. 'Ű' => 'U',
  1624. 'ű' => 'u',
  1625. 'Ų' => 'U',
  1626. 'ų' => 'u',
  1627. 'Ŵ' => 'W',
  1628. 'ŵ' => 'w',
  1629. 'Ŷ' => 'Y',
  1630. 'ŷ' => 'y',
  1631. 'Ÿ' => 'Y',
  1632. 'Ź' => 'Z',
  1633. 'ź' => 'z',
  1634. 'Ż' => 'Z',
  1635. 'ż' => 'z',
  1636. 'Ž' => 'Z',
  1637. 'ž' => 'z',
  1638. 'ſ' => 's',
  1639. // Decompositions for Latin Extended-B.
  1640. 'Ș' => 'S',
  1641. 'ș' => 's',
  1642. 'Ț' => 'T',
  1643. 'ț' => 't',
  1644. // Euro sign.
  1645. '€' => 'E',
  1646. // GBP (Pound) sign.
  1647. '£' => '',
  1648. // Vowels with diacritic (Vietnamese).
  1649. // Unmarked.
  1650. 'Ơ' => 'O',
  1651. 'ơ' => 'o',
  1652. 'Ư' => 'U',
  1653. 'ư' => 'u',
  1654. // Grave accent.
  1655. 'Ầ' => 'A',
  1656. 'ầ' => 'a',
  1657. 'Ằ' => 'A',
  1658. 'ằ' => 'a',
  1659. 'Ề' => 'E',
  1660. 'ề' => 'e',
  1661. 'Ồ' => 'O',
  1662. 'ồ' => 'o',
  1663. 'Ờ' => 'O',
  1664. 'ờ' => 'o',
  1665. 'Ừ' => 'U',
  1666. 'ừ' => 'u',
  1667. 'Ỳ' => 'Y',
  1668. 'ỳ' => 'y',
  1669. // Hook.
  1670. 'Ả' => 'A',
  1671. 'ả' => 'a',
  1672. 'Ẩ' => 'A',
  1673. 'ẩ' => 'a',
  1674. 'Ẳ' => 'A',
  1675. 'ẳ' => 'a',
  1676. 'Ẻ' => 'E',
  1677. 'ẻ' => 'e',
  1678. 'Ể' => 'E',
  1679. 'ể' => 'e',
  1680. 'Ỉ' => 'I',
  1681. 'ỉ' => 'i',
  1682. 'Ỏ' => 'O',
  1683. 'ỏ' => 'o',
  1684. 'Ổ' => 'O',
  1685. 'ổ' => 'o',
  1686. 'Ở' => 'O',
  1687. 'ở' => 'o',
  1688. 'Ủ' => 'U',
  1689. 'ủ' => 'u',
  1690. 'Ử' => 'U',
  1691. 'ử' => 'u',
  1692. 'Ỷ' => 'Y',
  1693. 'ỷ' => 'y',
  1694. // Tilde.
  1695. 'Ẫ' => 'A',
  1696. 'ẫ' => 'a',
  1697. 'Ẵ' => 'A',
  1698. 'ẵ' => 'a',
  1699. 'Ẽ' => 'E',
  1700. 'ẽ' => 'e',
  1701. 'Ễ' => 'E',
  1702. 'ễ' => 'e',
  1703. 'Ỗ' => 'O',
  1704. 'ỗ' => 'o',
  1705. 'Ỡ' => 'O',
  1706. 'ỡ' => 'o',
  1707. 'Ữ' => 'U',
  1708. 'ữ' => 'u',
  1709. 'Ỹ' => 'Y',
  1710. 'ỹ' => 'y',
  1711. // Acute accent.
  1712. 'Ấ' => 'A',
  1713. 'ấ' => 'a',
  1714. 'Ắ' => 'A',
  1715. 'ắ' => 'a',
  1716. 'Ế' => 'E',
  1717. 'ế' => 'e',
  1718. 'Ố' => 'O',
  1719. 'ố' => 'o',
  1720. 'Ớ' => 'O',
  1721. 'ớ' => 'o',
  1722. 'Ứ' => 'U',
  1723. 'ứ' => 'u',
  1724. // Dot below.
  1725. 'Ạ' => 'A',
  1726. 'ạ' => 'a',
  1727. 'Ậ' => 'A',
  1728. 'ậ' => 'a',
  1729. 'Ặ' => 'A',
  1730. 'ặ' => 'a',
  1731. 'Ẹ' => 'E',
  1732. 'ẹ' => 'e',
  1733. 'Ệ' => 'E',
  1734. 'ệ' => 'e',
  1735. 'Ị' => 'I',
  1736. 'ị' => 'i',
  1737. 'Ọ' => 'O',
  1738. 'ọ' => 'o',
  1739. 'Ộ' => 'O',
  1740. 'ộ' => 'o',
  1741. 'Ợ' => 'O',
  1742. 'ợ' => 'o',
  1743. 'Ụ' => 'U',
  1744. 'ụ' => 'u',
  1745. 'Ự' => 'U',
  1746. 'ự' => 'u',
  1747. 'Ỵ' => 'Y',
  1748. 'ỵ' => 'y',
  1749. // Vowels with diacritic (Chinese, Hanyu Pinyin).
  1750. 'ɑ' => 'a',
  1751. // Macron.
  1752. 'Ǖ' => 'U',
  1753. 'ǖ' => 'u',
  1754. // Acute accent.
  1755. 'Ǘ' => 'U',
  1756. 'ǘ' => 'u',
  1757. // Caron.
  1758. 'Ǎ' => 'A',
  1759. 'ǎ' => 'a',
  1760. 'Ǐ' => 'I',
  1761. 'ǐ' => 'i',
  1762. 'Ǒ' => 'O',
  1763. 'ǒ' => 'o',
  1764. 'Ǔ' => 'U',
  1765. 'ǔ' => 'u',
  1766. 'Ǚ' => 'U',
  1767. 'ǚ' => 'u',
  1768. // Grave accent.
  1769. 'Ǜ' => 'U',
  1770. 'ǜ' => 'u',
  1771. );
  1772. // Used for locale-specific rules.
  1773. $locale = get_locale();
  1774. if ( in_array( $locale, array( 'de_DE', 'de_DE_formal', 'de_CH', 'de_CH_informal', 'de_AT' ), true ) ) {
  1775. $chars['Ä'] = 'Ae';
  1776. $chars['ä'] = 'ae';
  1777. $chars['Ö'] = 'Oe';
  1778. $chars['ö'] = 'oe';
  1779. $chars['Ü'] = 'Ue';
  1780. $chars['ü'] = 'ue';
  1781. $chars['ß'] = 'ss';
  1782. } elseif ( 'da_DK' === $locale ) {
  1783. $chars['Æ'] = 'Ae';
  1784. $chars['æ'] = 'ae';
  1785. $chars['Ø'] = 'Oe';
  1786. $chars['ø'] = 'oe';
  1787. $chars['Å'] = 'Aa';
  1788. $chars['å'] = 'aa';
  1789. } elseif ( 'ca' === $locale ) {
  1790. $chars['l·l'] = 'll';
  1791. } elseif ( 'sr_RS' === $locale || 'bs_BA' === $locale ) {
  1792. $chars['Đ'] = 'DJ';
  1793. $chars['đ'] = 'dj';
  1794. }
  1795. $string = strtr( $string, $chars );
  1796. } else {
  1797. $chars = array();
  1798. // Assume ISO-8859-1 if not UTF-8.
  1799. $chars['in'] = "\x80\x83\x8a\x8e\x9a\x9e"
  1800. . "\x9f\xa2\xa5\xb5\xc0\xc1\xc2"
  1801. . "\xc3\xc4\xc5\xc7\xc8\xc9\xca"
  1802. . "\xcb\xcc\xcd\xce\xcf\xd1\xd2"
  1803. . "\xd3\xd4\xd5\xd6\xd8\xd9\xda"
  1804. . "\xdb\xdc\xdd\xe0\xe1\xe2\xe3"
  1805. . "\xe4\xe5\xe7\xe8\xe9\xea\xeb"
  1806. . "\xec\xed\xee\xef\xf1\xf2\xf3"
  1807. . "\xf4\xf5\xf6\xf8\xf9\xfa\xfb"
  1808. . "\xfc\xfd\xff";
  1809. $chars['out'] = 'EfSZszYcYuAAAAAACEEEEIIIINOOOOOOUUUUYaaaaaaceeeeiiiinoooooouuuuyy';
  1810. $string = strtr( $string, $chars['in'], $chars['out'] );
  1811. $double_chars = array();
  1812. $double_chars['in'] = array( "\x8c", "\x9c", "\xc6", "\xd0", "\xde", "\xdf", "\xe6", "\xf0", "\xfe" );
  1813. $double_chars['out'] = array( 'OE', 'oe', 'AE', 'DH', 'TH', 'ss', 'ae', 'dh', 'th' );
  1814. $string = str_replace( $double_chars['in'], $double_chars['out'], $string );
  1815. }
  1816. return $string;
  1817. }
  1818. /**
  1819. * Sanitizes a filename, replacing whitespace with dashes.
  1820. *
  1821. * Removes special characters that are illegal in filenames on certain
  1822. * operating systems and special characters requiring special escaping
  1823. * to manipulate at the command line. Replaces spaces and consecutive
  1824. * dashes with a single dash. Trims period, dash and underscore from beginning
  1825. * and end of filename. It is not guaranteed that this function will return a
  1826. * filename that is allowed to be uploaded.
  1827. *
  1828. * @since 2.1.0
  1829. *
  1830. * @param string $filename The filename to be sanitized.
  1831. * @return string The sanitized filename.
  1832. */
  1833. function sanitize_file_name( $filename ) {
  1834. $filename_raw = $filename;
  1835. $filename = remove_accents( $filename );
  1836. $special_chars = array( '?', '[', ']', '/', '\\', '=', '<', '>', ':', ';', ',', "'", '"', '&', '$', '#', '*', '(', ')', '|', '~', '`', '!', '{', '}', '%', '+', '’', '«', '»', '”', '“', chr( 0 ) );
  1837. // Check for support for utf8 in the installed PCRE library once and store the result in a static.
  1838. static $utf8_pcre = null;
  1839. if ( ! isset( $utf8_pcre ) ) {
  1840. // phpcs:ignore WordPress.PHP.NoSilencedErrors.Discouraged
  1841. $utf8_pcre = @preg_match( '/^./u', 'a' );
  1842. }
  1843. if ( ! seems_utf8( $filename ) ) {
  1844. $_ext = pathinfo( $filename, PATHINFO_EXTENSION );
  1845. $_name = pathinfo( $filename, PATHINFO_FILENAME );
  1846. $filename = sanitize_title_with_dashes( $_name ) . '.' . $_ext;
  1847. }
  1848. if ( $utf8_pcre ) {
  1849. $filename = preg_replace( "#\x{00a0}#siu", ' ', $filename );
  1850. }
  1851. /**
  1852. * Filters the list of characters to remove from a filename.
  1853. *
  1854. * @since 2.8.0
  1855. *
  1856. * @param string[] $special_chars Array of characters to remove.
  1857. * @param string $filename_raw The original filename to be sanitized.
  1858. */
  1859. $special_chars = apply_filters( 'sanitize_file_name_chars', $special_chars, $filename_raw );
  1860. $filename = str_replace( $special_chars, '', $filename );
  1861. $filename = str_replace( array( '%20', '+' ), '-', $filename );
  1862. $filename = preg_replace( '/[\r\n\t -]+/', '-', $filename );
  1863. $filename = trim( $filename, '.-_' );
  1864. if ( false === strpos( $filename, '.' ) ) {
  1865. $mime_types = wp_get_mime_types();
  1866. $filetype = wp_check_filetype( 'test.' . $filename, $mime_types );
  1867. if ( $filetype['ext'] === $filename ) {
  1868. $filename = 'unnamed-file.' . $filetype['ext'];
  1869. }
  1870. }
  1871. // Split the filename into a base and extension[s].
  1872. $parts = explode( '.', $filename );
  1873. // Return if only one extension.
  1874. if ( count( $parts ) <= 2 ) {
  1875. /** This filter is documented in wp-includes/formatting.php */
  1876. return apply_filters( 'sanitize_file_name', $filename, $filename_raw );
  1877. }
  1878. // Process multiple extensions.
  1879. $filename = array_shift( $parts );
  1880. $extension = array_pop( $parts );
  1881. $mimes = get_allowed_mime_types();
  1882. /*
  1883. * Loop over any intermediate extensions. Postfix them with a trailing underscore
  1884. * if they are a 2 - 5 character long alpha string not in the allowed extension list.
  1885. */
  1886. foreach ( (array) $parts as $part ) {
  1887. $filename .= '.' . $part;
  1888. if ( preg_match( '/^[a-zA-Z]{2,5}\d?$/', $part ) ) {
  1889. $allowed = false;
  1890. foreach ( $mimes as $ext_preg => $mime_match ) {
  1891. $ext_preg = '!^(' . $ext_preg . ')$!i';
  1892. if ( preg_match( $ext_preg, $part ) ) {
  1893. $allowed = true;
  1894. break;
  1895. }
  1896. }
  1897. if ( ! $allowed ) {
  1898. $filename .= '_';
  1899. }
  1900. }
  1901. }
  1902. $filename .= '.' . $extension;
  1903. /**
  1904. * Filters a sanitized filename string.
  1905. *
  1906. * @since 2.8.0
  1907. *
  1908. * @param string $filename Sanitized filename.
  1909. * @param string $filename_raw The filename prior to sanitization.
  1910. */
  1911. return apply_filters( 'sanitize_file_name', $filename, $filename_raw );
  1912. }
  1913. /**
  1914. * Sanitizes a username, stripping out unsafe characters.
  1915. *
  1916. * Removes tags, octets, entities, and if strict is enabled, will only keep
  1917. * alphanumeric, _, space, ., -, @. After sanitizing, it passes the username,
  1918. * raw username (the username in the parameter), and the value of $strict as
  1919. * parameters for the {@see 'sanitize_user'} filter.
  1920. *
  1921. * @since 2.0.0
  1922. *
  1923. * @param string $username The username to be sanitized.
  1924. * @param bool $strict Optional. If set limits $username to specific characters.
  1925. * Default false.
  1926. * @return string The sanitized username, after passing through filters.
  1927. */
  1928. function sanitize_user( $username, $strict = false ) {
  1929. $raw_username = $username;
  1930. $username = wp_strip_all_tags( $username );
  1931. $username = remove_accents( $username );
  1932. // Kill octets.
  1933. $username = preg_replace( '|%([a-fA-F0-9][a-fA-F0-9])|', '', $username );
  1934. // Kill entities.
  1935. $username = preg_replace( '/&.+?;/', '', $username );
  1936. // If strict, reduce to ASCII for max portability.
  1937. if ( $strict ) {
  1938. $username = preg_replace( '|[^a-z0-9 _.\-@]|i', '', $username );
  1939. }
  1940. $username = trim( $username );
  1941. // Consolidate contiguous whitespace.
  1942. $username = preg_replace( '|\s+|', ' ', $username );
  1943. /**
  1944. * Filters a sanitized username string.
  1945. *
  1946. * @since 2.0.1
  1947. *
  1948. * @param string $username Sanitized username.
  1949. * @param string $raw_username The username prior to sanitization.
  1950. * @param bool $strict Whether to limit the sanitization to specific characters.
  1951. */
  1952. return apply_filters( 'sanitize_user', $username, $raw_username, $strict );
  1953. }
  1954. /**
  1955. * Sanitizes a string key.
  1956. *
  1957. * Keys are used as internal identifiers. Lowercase alphanumeric characters,
  1958. * dashes, and underscores are allowed.
  1959. *
  1960. * @since 3.0.0
  1961. *
  1962. * @param string $key String key.
  1963. * @return string Sanitized key.
  1964. */
  1965. function sanitize_key( $key ) {
  1966. $sanitized_key = '';
  1967. if ( is_scalar( $key ) ) {
  1968. $sanitized_key = strtolower( $key );
  1969. $sanitized_key = preg_replace( '/[^a-z0-9_\-]/', '', $sanitized_key );
  1970. }
  1971. /**
  1972. * Filters a sanitized key string.
  1973. *
  1974. * @since 3.0.0
  1975. *
  1976. * @param string $sanitized_key Sanitized key.
  1977. * @param string $key The key prior to sanitization.
  1978. */
  1979. return apply_filters( 'sanitize_key', $sanitized_key, $key );
  1980. }
  1981. /**
  1982. * Sanitizes a string into a slug, which can be used in URLs or HTML attributes.
  1983. *
  1984. * By default, converts accent characters to ASCII characters and further
  1985. * limits the output to alphanumeric characters, underscore (_) and dash (-)
  1986. * through the {@see 'sanitize_title'} filter.
  1987. *
  1988. * If `$title` is empty and `$fallback_title` is set, the latter will be used.
  1989. *
  1990. * @since 1.0.0
  1991. *
  1992. * @param string $title The string to be sanitized.
  1993. * @param string $fallback_title Optional. A title to use if $title is empty. Default empty.
  1994. * @param string $context Optional. The operation for which the string is sanitized.
  1995. * When set to 'save', the string runs through remove_accents().
  1996. * Default 'save'.
  1997. * @return string The sanitized string.
  1998. */
  1999. function sanitize_title( $title, $fallback_title = '', $context = 'save' ) {
  2000. $raw_title = $title;
  2001. if ( 'save' === $context ) {
  2002. $title = remove_accents( $title );
  2003. }
  2004. /**
  2005. * Filters a sanitized title string.
  2006. *
  2007. * @since 1.2.0
  2008. *
  2009. * @param string $title Sanitized title.
  2010. * @param string $raw_title The title prior to sanitization.
  2011. * @param string $context The context for which the title is being sanitized.
  2012. */
  2013. $title = apply_filters( 'sanitize_title', $title, $raw_title, $context );
  2014. if ( '' === $title || false === $title ) {
  2015. $title = $fallback_title;
  2016. }
  2017. return $title;
  2018. }
  2019. /**
  2020. * Sanitizes a title with the 'query' context.
  2021. *
  2022. * Used for querying the database for a value from URL.
  2023. *
  2024. * @since 3.1.0
  2025. *
  2026. * @param string $title The string to be sanitized.
  2027. * @return string The sanitized string.
  2028. */
  2029. function sanitize_title_for_query( $title ) {
  2030. return sanitize_title( $title, '', 'query' );
  2031. }
  2032. /**
  2033. * Sanitizes a title, replacing whitespace and a few other characters with dashes.
  2034. *
  2035. * Limits the output to alphanumeric characters, underscore (_) and dash (-).
  2036. * Whitespace becomes a dash.
  2037. *
  2038. * @since 1.2.0
  2039. *
  2040. * @param string $title The title to be sanitized.
  2041. * @param string $raw_title Optional. Not used. Default empty.
  2042. * @param string $context Optional. The operation for which the string is sanitized.
  2043. * When set to 'save', additional entities are converted to hyphens
  2044. * or stripped entirely. Default 'display'.
  2045. * @return string The sanitized title.
  2046. */
  2047. function sanitize_title_with_dashes( $title, $raw_title = '', $context = 'display' ) {
  2048. $title = strip_tags( $title );
  2049. // Preserve escaped octets.
  2050. $title = preg_replace( '|%([a-fA-F0-9][a-fA-F0-9])|', '---$1---', $title );
  2051. // Remove percent signs that are not part of an octet.
  2052. $title = str_replace( '%', '', $title );
  2053. // Restore octets.
  2054. $title = preg_replace( '|---([a-fA-F0-9][a-fA-F0-9])---|', '%$1', $title );
  2055. if ( seems_utf8( $title ) ) {
  2056. if ( function_exists( 'mb_strtolower' ) ) {
  2057. $title = mb_strtolower( $title, 'UTF-8' );
  2058. }
  2059. $title = utf8_uri_encode( $title, 200 );
  2060. }
  2061. $title = strtolower( $title );
  2062. if ( 'save' === $context ) {
  2063. // Convert &nbsp, &ndash, and &mdash to hyphens.
  2064. $title = str_replace( array( '%c2%a0', '%e2%80%93', '%e2%80%94' ), '-', $title );
  2065. // Convert &nbsp, &ndash, and &mdash HTML entities to hyphens.
  2066. $title = str_replace( array( '&nbsp;', '&#160;', '&ndash;', '&#8211;', '&mdash;', '&#8212;' ), '-', $title );
  2067. // Convert forward slash to hyphen.
  2068. $title = str_replace( '/', '-', $title );
  2069. // Strip these characters entirely.
  2070. $title = str_replace(
  2071. array(
  2072. // Soft hyphens.
  2073. '%c2%ad',
  2074. // &iexcl and &iquest.
  2075. '%c2%a1',
  2076. '%c2%bf',
  2077. // Angle quotes.
  2078. '%c2%ab',
  2079. '%c2%bb',
  2080. '%e2%80%b9',
  2081. '%e2%80%ba',
  2082. // Curly quotes.
  2083. '%e2%80%98',
  2084. '%e2%80%99',
  2085. '%e2%80%9c',
  2086. '%e2%80%9d',
  2087. '%e2%80%9a',
  2088. '%e2%80%9b',
  2089. '%e2%80%9e',
  2090. '%e2%80%9f',
  2091. // Bullet.
  2092. '%e2%80%a2',
  2093. // &copy, &reg, &deg, &hellip, and &trade.
  2094. '%c2%a9',
  2095. '%c2%ae',
  2096. '%c2%b0',
  2097. '%e2%80%a6',
  2098. '%e2%84%a2',
  2099. // Acute accents.
  2100. '%c2%b4',
  2101. '%cb%8a',
  2102. '%cc%81',
  2103. '%cd%81',
  2104. // Grave accent, macron, caron.
  2105. '%cc%80',
  2106. '%cc%84',
  2107. '%cc%8c',
  2108. // Non-visible characters that display without a width.
  2109. '%e2%80%8b',
  2110. '%e2%80%8c',
  2111. '%e2%80%8d',
  2112. '%e2%80%8e',
  2113. '%e2%80%8f',
  2114. '%e2%80%aa',
  2115. '%e2%80%ab',
  2116. '%e2%80%ac',
  2117. '%e2%80%ad',
  2118. '%e2%80%ae',
  2119. '%ef%bb%bf',
  2120. ),
  2121. '',
  2122. $title
  2123. );
  2124. // Convert non-visible characters that display with a width to hyphen.
  2125. $title = str_replace(
  2126. array(
  2127. '%e2%80%80',
  2128. '%e2%80%81',
  2129. '%e2%80%82',
  2130. '%e2%80%83',
  2131. '%e2%80%84',
  2132. '%e2%80%85',
  2133. '%e2%80%86',
  2134. '%e2%80%87',
  2135. '%e2%80%88',
  2136. '%e2%80%89',
  2137. '%e2%80%8a',
  2138. '%e2%80%a8',
  2139. '%e2%80%a9',
  2140. '%e2%80%af',
  2141. ),
  2142. '-',
  2143. $title
  2144. );
  2145. // Convert &times to 'x'.
  2146. $title = str_replace( '%c3%97', 'x', $title );
  2147. }
  2148. // Kill entities.
  2149. $title = preg_replace( '/&.+?;/', '', $title );
  2150. $title = str_replace( '.', '-', $title );
  2151. $title = preg_replace( '/[^%a-z0-9 _-]/', '', $title );
  2152. $title = preg_replace( '/\s+/', '-', $title );
  2153. $title = preg_replace( '|-+|', '-', $title );
  2154. $title = trim( $title, '-' );
  2155. return $title;
  2156. }
  2157. /**
  2158. * Ensures a string is a valid SQL 'order by' clause.
  2159. *
  2160. * Accepts one or more columns, with or without a sort order (ASC / DESC).
  2161. * e.g. 'column_1', 'column_1, column_2', 'column_1 ASC, column_2 DESC' etc.
  2162. *
  2163. * Also accepts 'RAND()'.
  2164. *
  2165. * @since 2.5.1
  2166. *
  2167. * @param string $orderby Order by clause to be validated.
  2168. * @return string|false Returns $orderby if valid, false otherwise.
  2169. */
  2170. function sanitize_sql_orderby( $orderby ) {
  2171. if ( preg_match( '/^\s*(([a-z0-9_]+|`[a-z0-9_]+`)(\s+(ASC|DESC))?\s*(,\s*(?=[a-z0-9_`])|$))+$/i', $orderby ) || preg_match( '/^\s*RAND\(\s*\)\s*$/i', $orderby ) ) {
  2172. return $orderby;
  2173. }
  2174. return false;
  2175. }
  2176. /**
  2177. * Sanitizes an HTML classname to ensure it only contains valid characters.
  2178. *
  2179. * Strips the string down to A-Z,a-z,0-9,_,-. If this results in an empty
  2180. * string then it will return the alternative value supplied.
  2181. *
  2182. * @todo Expand to support the full range of CDATA that a class attribute can contain.
  2183. *
  2184. * @since 2.8.0
  2185. *
  2186. * @param string $class The classname to be sanitized
  2187. * @param string $fallback Optional. The value to return if the sanitization ends up as an empty string.
  2188. * Defaults to an empty string.
  2189. * @return string The sanitized value
  2190. */
  2191. function sanitize_html_class( $class, $fallback = '' ) {
  2192. // Strip out any %-encoded octets.
  2193. $sanitized = preg_replace( '|%[a-fA-F0-9][a-fA-F0-9]|', '', $class );
  2194. // Limit to A-Z, a-z, 0-9, '_', '-'.
  2195. $sanitized = preg_replace( '/[^A-Za-z0-9_-]/', '', $sanitized );
  2196. if ( '' === $sanitized && $fallback ) {
  2197. return sanitize_html_class( $fallback );
  2198. }
  2199. /**
  2200. * Filters a sanitized HTML class string.
  2201. *
  2202. * @since 2.8.0
  2203. *
  2204. * @param string $sanitized The sanitized HTML class.
  2205. * @param string $class HTML class before sanitization.
  2206. * @param string $fallback The fallback string.
  2207. */
  2208. return apply_filters( 'sanitize_html_class', $sanitized, $class, $fallback );
  2209. }
  2210. /**
  2211. * Converts lone & characters into `&#038;` (a.k.a. `&amp;`)
  2212. *
  2213. * @since 0.71
  2214. *
  2215. * @param string $content String of characters to be converted.
  2216. * @param string $deprecated Not used.
  2217. * @return string Converted string.
  2218. */
  2219. function convert_chars( $content, $deprecated = '' ) {
  2220. if ( ! empty( $deprecated ) ) {
  2221. _deprecated_argument( __FUNCTION__, '0.71' );
  2222. }
  2223. if ( strpos( $content, '&' ) !== false ) {
  2224. $content = preg_replace( '/&([^#])(?![a-z1-4]{1,8};)/i', '&#038;$1', $content );
  2225. }
  2226. return $content;
  2227. }
  2228. /**
  2229. * Converts invalid Unicode references range to valid range.
  2230. *
  2231. * @since 4.3.0
  2232. *
  2233. * @param string $content String with entities that need converting.
  2234. * @return string Converted string.
  2235. */
  2236. function convert_invalid_entities( $content ) {
  2237. $wp_htmltranswinuni = array(
  2238. '&#128;' => '&#8364;', // The Euro sign.
  2239. '&#129;' => '',
  2240. '&#130;' => '&#8218;', // These are Windows CP1252 specific characters.
  2241. '&#131;' => '&#402;', // They would look weird on non-Windows browsers.
  2242. '&#132;' => '&#8222;',
  2243. '&#133;' => '&#8230;',
  2244. '&#134;' => '&#8224;',
  2245. '&#135;' => '&#8225;',
  2246. '&#136;' => '&#710;',
  2247. '&#137;' => '&#8240;',
  2248. '&#138;' => '&#352;',
  2249. '&#139;' => '&#8249;',
  2250. '&#140;' => '&#338;',
  2251. '&#141;' => '',
  2252. '&#142;' => '&#381;',
  2253. '&#143;' => '',
  2254. '&#144;' => '',
  2255. '&#145;' => '&#8216;',
  2256. '&#146;' => '&#8217;',
  2257. '&#147;' => '&#8220;',
  2258. '&#148;' => '&#8221;',
  2259. '&#149;' => '&#8226;',
  2260. '&#150;' => '&#8211;',
  2261. '&#151;' => '&#8212;',
  2262. '&#152;' => '&#732;',
  2263. '&#153;' => '&#8482;',
  2264. '&#154;' => '&#353;',
  2265. '&#155;' => '&#8250;',
  2266. '&#156;' => '&#339;',
  2267. '&#157;' => '',
  2268. '&#158;' => '&#382;',
  2269. '&#159;' => '&#376;',
  2270. );
  2271. if ( strpos( $content, '&#1' ) !== false ) {
  2272. $content = strtr( $content, $wp_htmltranswinuni );
  2273. }
  2274. return $content;
  2275. }
  2276. /**
  2277. * Balances tags if forced to, or if the 'use_balanceTags' option is set to true.
  2278. *
  2279. * @since 0.71
  2280. *
  2281. * @param string $text Text to be balanced
  2282. * @param bool $force If true, forces balancing, ignoring the value of the option. Default false.
  2283. * @return string Balanced text
  2284. */
  2285. function balanceTags( $text, $force = false ) { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionNameInvalid
  2286. if ( $force || (int) get_option( 'use_balanceTags' ) === 1 ) {
  2287. return force_balance_tags( $text );
  2288. } else {
  2289. return $text;
  2290. }
  2291. }
  2292. /**
  2293. * Balances tags of string using a modified stack.
  2294. *
  2295. * @since 2.0.4
  2296. * @since 5.3.0 Improve accuracy and add support for custom element tags.
  2297. *
  2298. * @author Leonard Lin <leonard@acm.org>
  2299. * @license GPL
  2300. * @copyright November 4, 2001
  2301. * @version 1.1
  2302. * @todo Make better - change loop condition to $text in 1.2
  2303. * @internal Modified by Scott Reilly (coffee2code) 02 Aug 2004
  2304. * 1.1 Fixed handling of append/stack pop order of end text
  2305. * Added Cleaning Hooks
  2306. * 1.0 First Version
  2307. *
  2308. * @param string $text Text to be balanced.
  2309. * @return string Balanced text.
  2310. */
  2311. function force_balance_tags( $text ) {
  2312. $tagstack = array();
  2313. $stacksize = 0;
  2314. $tagqueue = '';
  2315. $newtext = '';
  2316. // Known single-entity/self-closing tags.
  2317. $single_tags = array( 'area', 'base', 'basefont', 'br', 'col', 'command', 'embed', 'frame', 'hr', 'img', 'input', 'isindex', 'link', 'meta', 'param', 'source', 'track', 'wbr' );
  2318. // Tags that can be immediately nested within themselves.
  2319. $nestable_tags = array( 'article', 'aside', 'blockquote', 'details', 'div', 'figure', 'object', 'q', 'section', 'span' );
  2320. // WP bug fix for comments - in case you REALLY meant to type '< !--'.
  2321. $text = str_replace( '< !--', '< !--', $text );
  2322. // WP bug fix for LOVE <3 (and other situations with '<' before a number).
  2323. $text = preg_replace( '#<([0-9]{1})#', '&lt;$1', $text );
  2324. /**
  2325. * Matches supported tags.
  2326. *
  2327. * To get the pattern as a string without the comments paste into a PHP
  2328. * REPL like `php -a`.
  2329. *
  2330. * @see https://html.spec.whatwg.org/#elements-2
  2331. * @see https://w3c.github.io/webcomponents/spec/custom/#valid-custom-element-name
  2332. *
  2333. * @example
  2334. * ~# php -a
  2335. * php > $s = [paste copied contents of expression below including parentheses];
  2336. * php > echo $s;
  2337. */
  2338. $tag_pattern = (
  2339. '#<' . // Start with an opening bracket.
  2340. '(/?)' . // Group 1 - If it's a closing tag it'll have a leading slash.
  2341. '(' . // Group 2 - Tag name.
  2342. // Custom element tags have more lenient rules than HTML tag names.
  2343. '(?:[a-z](?:[a-z0-9._]*)-(?:[a-z0-9._-]+)+)' .
  2344. '|' .
  2345. // Traditional tag rules approximate HTML tag names.
  2346. '(?:[\w:]+)' .
  2347. ')' .
  2348. '(?:' .
  2349. // We either immediately close the tag with its '>' and have nothing here.
  2350. '\s*' .
  2351. '(/?)' . // Group 3 - "attributes" for empty tag.
  2352. '|' .
  2353. // Or we must start with space characters to separate the tag name from the attributes (or whitespace).
  2354. '(\s+)' . // Group 4 - Pre-attribute whitespace.
  2355. '([^>]*)' . // Group 5 - Attributes.
  2356. ')' .
  2357. '>#' // End with a closing bracket.
  2358. );
  2359. while ( preg_match( $tag_pattern, $text, $regex ) ) {
  2360. $full_match = $regex[0];
  2361. $has_leading_slash = ! empty( $regex[1] );
  2362. $tag_name = $regex[2];
  2363. $tag = strtolower( $tag_name );
  2364. $is_single_tag = in_array( $tag, $single_tags, true );
  2365. $pre_attribute_ws = isset( $regex[4] ) ? $regex[4] : '';
  2366. $attributes = trim( isset( $regex[5] ) ? $regex[5] : $regex[3] );
  2367. $has_self_closer = '/' === substr( $attributes, -1 );
  2368. $newtext .= $tagqueue;
  2369. $i = strpos( $text, $full_match );
  2370. $l = strlen( $full_match );
  2371. // Clear the shifter.
  2372. $tagqueue = '';
  2373. if ( $has_leading_slash ) { // End tag.
  2374. // If too many closing tags.
  2375. if ( $stacksize <= 0 ) {
  2376. $tag = '';
  2377. // Or close to be safe $tag = '/' . $tag.
  2378. // If stacktop value = tag close value, then pop.
  2379. } elseif ( $tagstack[ $stacksize - 1 ] === $tag ) { // Found closing tag.
  2380. $tag = '</' . $tag . '>'; // Close tag.
  2381. array_pop( $tagstack );
  2382. $stacksize--;
  2383. } else { // Closing tag not at top, search for it.
  2384. for ( $j = $stacksize - 1; $j >= 0; $j-- ) {
  2385. if ( $tagstack[ $j ] === $tag ) {
  2386. // Add tag to tagqueue.
  2387. for ( $k = $stacksize - 1; $k >= $j; $k-- ) {
  2388. $tagqueue .= '</' . array_pop( $tagstack ) . '>';
  2389. $stacksize--;
  2390. }
  2391. break;
  2392. }
  2393. }
  2394. $tag = '';
  2395. }
  2396. } else { // Begin tag.
  2397. if ( $has_self_closer ) { // If it presents itself as a self-closing tag...
  2398. // ...but it isn't a known single-entity self-closing tag, then don't let it be treated as such
  2399. // and immediately close it with a closing tag (the tag will encapsulate no text as a result).
  2400. if ( ! $is_single_tag ) {
  2401. $attributes = trim( substr( $attributes, 0, -1 ) ) . "></$tag";
  2402. }
  2403. } elseif ( $is_single_tag ) { // Else if it's a known single-entity tag but it doesn't close itself, do so.
  2404. $pre_attribute_ws = ' ';
  2405. $attributes .= '/';
  2406. } else { // It's not a single-entity tag.
  2407. // If the top of the stack is the same as the tag we want to push, close previous tag.
  2408. if ( $stacksize > 0 && ! in_array( $tag, $nestable_tags, true ) && $tagstack[ $stacksize - 1 ] === $tag ) {
  2409. $tagqueue = '</' . array_pop( $tagstack ) . '>';
  2410. $stacksize--;
  2411. }
  2412. $stacksize = array_push( $tagstack, $tag );
  2413. }
  2414. // Attributes.
  2415. if ( $has_self_closer && $is_single_tag ) {
  2416. // We need some space - avoid <br/> and prefer <br />.
  2417. $pre_attribute_ws = ' ';
  2418. }
  2419. $tag = '<' . $tag . $pre_attribute_ws . $attributes . '>';
  2420. // If already queuing a close tag, then put this tag on too.
  2421. if ( ! empty( $tagqueue ) ) {
  2422. $tagqueue .= $tag;
  2423. $tag = '';
  2424. }
  2425. }
  2426. $newtext .= substr( $text, 0, $i ) . $tag;
  2427. $text = substr( $text, $i + $l );
  2428. }
  2429. // Clear tag queue.
  2430. $newtext .= $tagqueue;
  2431. // Add remaining text.
  2432. $newtext .= $text;
  2433. while ( $x = array_pop( $tagstack ) ) {
  2434. $newtext .= '</' . $x . '>'; // Add remaining tags to close.
  2435. }
  2436. // WP fix for the bug with HTML comments.
  2437. $newtext = str_replace( '< !--', '<!--', $newtext );
  2438. $newtext = str_replace( '< !--', '< !--', $newtext );
  2439. return $newtext;
  2440. }
  2441. /**
  2442. * Acts on text which is about to be edited.
  2443. *
  2444. * The $content is run through esc_textarea(), which uses htmlspecialchars()
  2445. * to convert special characters to HTML entities. If `$richedit` is set to true,
  2446. * it is simply a holder for the {@see 'format_to_edit'} filter.
  2447. *
  2448. * @since 0.71
  2449. * @since 4.4.0 The `$richedit` parameter was renamed to `$rich_text` for clarity.
  2450. *
  2451. * @param string $content The text about to be edited.
  2452. * @param bool $rich_text Optional. Whether `$content` should be considered rich text,
  2453. * in which case it would not be passed through esc_textarea().
  2454. * Default false.
  2455. * @return string The text after the filter (and possibly htmlspecialchars()) has been run.
  2456. */
  2457. function format_to_edit( $content, $rich_text = false ) {
  2458. /**
  2459. * Filters the text to be formatted for editing.
  2460. *
  2461. * @since 1.2.0
  2462. *
  2463. * @param string $content The text, prior to formatting for editing.
  2464. */
  2465. $content = apply_filters( 'format_to_edit', $content );
  2466. if ( ! $rich_text ) {
  2467. $content = esc_textarea( $content );
  2468. }
  2469. return $content;
  2470. }
  2471. /**
  2472. * Add leading zeros when necessary.
  2473. *
  2474. * If you set the threshold to '4' and the number is '10', then you will get
  2475. * back '0010'. If you set the threshold to '4' and the number is '5000', then you
  2476. * will get back '5000'.
  2477. *
  2478. * Uses sprintf to append the amount of zeros based on the $threshold parameter
  2479. * and the size of the number. If the number is large enough, then no zeros will
  2480. * be appended.
  2481. *
  2482. * @since 0.71
  2483. *
  2484. * @param int $number Number to append zeros to if not greater than threshold.
  2485. * @param int $threshold Digit places number needs to be to not have zeros added.
  2486. * @return string Adds leading zeros to number if needed.
  2487. */
  2488. function zeroise( $number, $threshold ) {
  2489. return sprintf( '%0' . $threshold . 's', $number );
  2490. }
  2491. /**
  2492. * Adds backslashes before letters and before a number at the start of a string.
  2493. *
  2494. * @since 0.71
  2495. *
  2496. * @param string $string Value to which backslashes will be added.
  2497. * @return string String with backslashes inserted.
  2498. */
  2499. function backslashit( $string ) {
  2500. if ( isset( $string[0] ) && $string[0] >= '0' && $string[0] <= '9' ) {
  2501. $string = '\\\\' . $string;
  2502. }
  2503. return addcslashes( $string, 'A..Za..z' );
  2504. }
  2505. /**
  2506. * Appends a trailing slash.
  2507. *
  2508. * Will remove trailing forward and backslashes if it exists already before adding
  2509. * a trailing forward slash. This prevents double slashing a string or path.
  2510. *
  2511. * The primary use of this is for paths and thus should be used for paths. It is
  2512. * not restricted to paths and offers no specific path support.
  2513. *
  2514. * @since 1.2.0
  2515. *
  2516. * @param string $string What to add the trailing slash to.
  2517. * @return string String with trailing slash added.
  2518. */
  2519. function trailingslashit( $string ) {
  2520. return untrailingslashit( $string ) . '/';
  2521. }
  2522. /**
  2523. * Removes trailing forward slashes and backslashes if they exist.
  2524. *
  2525. * The primary use of this is for paths and thus should be used for paths. It is
  2526. * not restricted to paths and offers no specific path support.
  2527. *
  2528. * @since 2.2.0
  2529. *
  2530. * @param string $string What to remove the trailing slashes from.
  2531. * @return string String without the trailing slashes.
  2532. */
  2533. function untrailingslashit( $string ) {
  2534. return rtrim( $string, '/\\' );
  2535. }
  2536. /**
  2537. * Adds slashes to a string or recursively adds slashes to strings within an array.
  2538. *
  2539. * Slashes will first be removed if magic_quotes_gpc is set, see {@link
  2540. * https://www.php.net/magic_quotes} for more details.
  2541. *
  2542. * @since 0.71
  2543. *
  2544. * @param string|array $gpc String or array of data to slash.
  2545. * @return string|array Slashed `$gpc`.
  2546. */
  2547. function addslashes_gpc( $gpc ) {
  2548. return wp_slash( $gpc );
  2549. }
  2550. /**
  2551. * Navigates through an array, object, or scalar, and removes slashes from the values.
  2552. *
  2553. * @since 2.0.0
  2554. *
  2555. * @param mixed $value The value to be stripped.
  2556. * @return mixed Stripped value.
  2557. */
  2558. function stripslashes_deep( $value ) {
  2559. return map_deep( $value, 'stripslashes_from_strings_only' );
  2560. }
  2561. /**
  2562. * Callback function for `stripslashes_deep()` which strips slashes from strings.
  2563. *
  2564. * @since 4.4.0
  2565. *
  2566. * @param mixed $value The array or string to be stripped.
  2567. * @return mixed The stripped value.
  2568. */
  2569. function stripslashes_from_strings_only( $value ) {
  2570. return is_string( $value ) ? stripslashes( $value ) : $value;
  2571. }
  2572. /**
  2573. * Navigates through an array, object, or scalar, and encodes the values to be used in a URL.
  2574. *
  2575. * @since 2.2.0
  2576. *
  2577. * @param mixed $value The array or string to be encoded.
  2578. * @return mixed The encoded value.
  2579. */
  2580. function urlencode_deep( $value ) {
  2581. return map_deep( $value, 'urlencode' );
  2582. }
  2583. /**
  2584. * Navigates through an array, object, or scalar, and raw-encodes the values to be used in a URL.
  2585. *
  2586. * @since 3.4.0
  2587. *
  2588. * @param mixed $value The array or string to be encoded.
  2589. * @return mixed The encoded value.
  2590. */
  2591. function rawurlencode_deep( $value ) {
  2592. return map_deep( $value, 'rawurlencode' );
  2593. }
  2594. /**
  2595. * Navigates through an array, object, or scalar, and decodes URL-encoded values
  2596. *
  2597. * @since 4.4.0
  2598. *
  2599. * @param mixed $value The array or string to be decoded.
  2600. * @return mixed The decoded value.
  2601. */
  2602. function urldecode_deep( $value ) {
  2603. return map_deep( $value, 'urldecode' );
  2604. }
  2605. /**
  2606. * Converts email addresses characters to HTML entities to block spam bots.
  2607. *
  2608. * @since 0.71
  2609. *
  2610. * @param string $email_address Email address.
  2611. * @param int $hex_encoding Optional. Set to 1 to enable hex encoding.
  2612. * @return string Converted email address.
  2613. */
  2614. function antispambot( $email_address, $hex_encoding = 0 ) {
  2615. $email_no_spam_address = '';
  2616. for ( $i = 0, $len = strlen( $email_address ); $i < $len; $i++ ) {
  2617. $j = rand( 0, 1 + $hex_encoding );
  2618. if ( 0 == $j ) {
  2619. $email_no_spam_address .= '&#' . ord( $email_address[ $i ] ) . ';';
  2620. } elseif ( 1 == $j ) {
  2621. $email_no_spam_address .= $email_address[ $i ];
  2622. } elseif ( 2 == $j ) {
  2623. $email_no_spam_address .= '%' . zeroise( dechex( ord( $email_address[ $i ] ) ), 2 );
  2624. }
  2625. }
  2626. return str_replace( '@', '&#64;', $email_no_spam_address );
  2627. }
  2628. /**
  2629. * Callback to convert URI match to HTML A element.
  2630. *
  2631. * This function was backported from 2.5.0 to 2.3.2. Regex callback for make_clickable().
  2632. *
  2633. * @since 2.3.2
  2634. * @access private
  2635. *
  2636. * @param array $matches Single Regex Match.
  2637. * @return string HTML A element with URI address.
  2638. */
  2639. function _make_url_clickable_cb( $matches ) {
  2640. $url = $matches[2];
  2641. if ( ')' === $matches[3] && strpos( $url, '(' ) ) {
  2642. // If the trailing character is a closing parethesis, and the URL has an opening parenthesis in it,
  2643. // add the closing parenthesis to the URL. Then we can let the parenthesis balancer do its thing below.
  2644. $url .= $matches[3];
  2645. $suffix = '';
  2646. } else {
  2647. $suffix = $matches[3];
  2648. }
  2649. // Include parentheses in the URL only if paired.
  2650. while ( substr_count( $url, '(' ) < substr_count( $url, ')' ) ) {
  2651. $suffix = strrchr( $url, ')' ) . $suffix;
  2652. $url = substr( $url, 0, strrpos( $url, ')' ) );
  2653. }
  2654. $url = esc_url( $url );
  2655. if ( empty( $url ) ) {
  2656. return $matches[0];
  2657. }
  2658. if ( 'comment_text' === current_filter() ) {
  2659. $rel = 'nofollow ugc';
  2660. } else {
  2661. $rel = 'nofollow';
  2662. }
  2663. /**
  2664. * Filters the rel value that is added to URL matches converted to links.
  2665. *
  2666. * @since 5.3.0
  2667. *
  2668. * @param string $rel The rel value.
  2669. * @param string $url The matched URL being converted to a link tag.
  2670. */
  2671. $rel = apply_filters( 'make_clickable_rel', $rel, $url );
  2672. $rel = esc_attr( $rel );
  2673. return $matches[1] . "<a href=\"$url\" rel=\"$rel\">$url</a>" . $suffix;
  2674. }
  2675. /**
  2676. * Callback to convert URL match to HTML A element.
  2677. *
  2678. * This function was backported from 2.5.0 to 2.3.2. Regex callback for make_clickable().
  2679. *
  2680. * @since 2.3.2
  2681. * @access private
  2682. *
  2683. * @param array $matches Single Regex Match.
  2684. * @return string HTML A element with URL address.
  2685. */
  2686. function _make_web_ftp_clickable_cb( $matches ) {
  2687. $ret = '';
  2688. $dest = $matches[2];
  2689. $dest = 'http://' . $dest;
  2690. // Removed trailing [.,;:)] from URL.
  2691. $last_char = substr( $dest, -1 );
  2692. if ( in_array( $last_char, array( '.', ',', ';', ':', ')' ), true ) === true ) {
  2693. $ret = $last_char;
  2694. $dest = substr( $dest, 0, strlen( $dest ) - 1 );
  2695. }
  2696. $dest = esc_url( $dest );
  2697. if ( empty( $dest ) ) {
  2698. return $matches[0];
  2699. }
  2700. if ( 'comment_text' === current_filter() ) {
  2701. $rel = 'nofollow ugc';
  2702. } else {
  2703. $rel = 'nofollow';
  2704. }
  2705. /** This filter is documented in wp-includes/formatting.php */
  2706. $rel = apply_filters( 'make_clickable_rel', $rel, $dest );
  2707. $rel = esc_attr( $rel );
  2708. return $matches[1] . "<a href=\"$dest\" rel=\"$rel\">$dest</a>$ret";
  2709. }
  2710. /**
  2711. * Callback to convert email address match to HTML A element.
  2712. *
  2713. * This function was backported from 2.5.0 to 2.3.2. Regex callback for make_clickable().
  2714. *
  2715. * @since 2.3.2
  2716. * @access private
  2717. *
  2718. * @param array $matches Single Regex Match.
  2719. * @return string HTML A element with email address.
  2720. */
  2721. function _make_email_clickable_cb( $matches ) {
  2722. $email = $matches[2] . '@' . $matches[3];
  2723. return $matches[1] . "<a href=\"mailto:$email\">$email</a>";
  2724. }
  2725. /**
  2726. * Convert plaintext URI to HTML links.
  2727. *
  2728. * Converts URI, www and ftp, and email addresses. Finishes by fixing links
  2729. * within links.
  2730. *
  2731. * @since 0.71
  2732. *
  2733. * @param string $text Content to convert URIs.
  2734. * @return string Content with converted URIs.
  2735. */
  2736. function make_clickable( $text ) {
  2737. $r = '';
  2738. $textarr = preg_split( '/(<[^<>]+>)/', $text, -1, PREG_SPLIT_DELIM_CAPTURE ); // Split out HTML tags.
  2739. $nested_code_pre = 0; // Keep track of how many levels link is nested inside <pre> or <code>.
  2740. foreach ( $textarr as $piece ) {
  2741. if ( preg_match( '|^<code[\s>]|i', $piece ) || preg_match( '|^<pre[\s>]|i', $piece ) || preg_match( '|^<script[\s>]|i', $piece ) || preg_match( '|^<style[\s>]|i', $piece ) ) {
  2742. $nested_code_pre++;
  2743. } elseif ( $nested_code_pre && ( '</code>' === strtolower( $piece ) || '</pre>' === strtolower( $piece ) || '</script>' === strtolower( $piece ) || '</style>' === strtolower( $piece ) ) ) {
  2744. $nested_code_pre--;
  2745. }
  2746. if ( $nested_code_pre || empty( $piece ) || ( '<' === $piece[0] && ! preg_match( '|^<\s*[\w]{1,20}+://|', $piece ) ) ) {
  2747. $r .= $piece;
  2748. continue;
  2749. }
  2750. // Long strings might contain expensive edge cases...
  2751. if ( 10000 < strlen( $piece ) ) {
  2752. // ...break it up.
  2753. foreach ( _split_str_by_whitespace( $piece, 2100 ) as $chunk ) { // 2100: Extra room for scheme and leading and trailing paretheses.
  2754. if ( 2101 < strlen( $chunk ) ) {
  2755. $r .= $chunk; // Too big, no whitespace: bail.
  2756. } else {
  2757. $r .= make_clickable( $chunk );
  2758. }
  2759. }
  2760. } else {
  2761. $ret = " $piece "; // Pad with whitespace to simplify the regexes.
  2762. $url_clickable = '~
  2763. ([\\s(<.,;:!?]) # 1: Leading whitespace, or punctuation.
  2764. ( # 2: URL.
  2765. [\\w]{1,20}+:// # Scheme and hier-part prefix.
  2766. (?=\S{1,2000}\s) # Limit to URLs less than about 2000 characters long.
  2767. [\\w\\x80-\\xff#%\\~/@\\[\\]*(+=&$-]*+ # Non-punctuation URL character.
  2768. (?: # Unroll the Loop: Only allow puctuation URL character if followed by a non-punctuation URL character.
  2769. [\'.,;:!?)] # Punctuation URL character.
  2770. [\\w\\x80-\\xff#%\\~/@\\[\\]*(+=&$-]++ # Non-punctuation URL character.
  2771. )*
  2772. )
  2773. (\)?) # 3: Trailing closing parenthesis (for parethesis balancing post processing).
  2774. ~xS';
  2775. // The regex is a non-anchored pattern and does not have a single fixed starting character.
  2776. // Tell PCRE to spend more time optimizing since, when used on a page load, it will probably be used several times.
  2777. $ret = preg_replace_callback( $url_clickable, '_make_url_clickable_cb', $ret );
  2778. $ret = preg_replace_callback( '#([\s>])((www|ftp)\.[\w\\x80-\\xff\#$%&~/.\-;:=,?@\[\]+]+)#is', '_make_web_ftp_clickable_cb', $ret );
  2779. $ret = preg_replace_callback( '#([\s>])([.0-9a-z_+-]+)@(([0-9a-z-]+\.)+[0-9a-z]{2,})#i', '_make_email_clickable_cb', $ret );
  2780. $ret = substr( $ret, 1, -1 ); // Remove our whitespace padding.
  2781. $r .= $ret;
  2782. }
  2783. }
  2784. // Cleanup of accidental links within links.
  2785. return preg_replace( '#(<a([ \r\n\t]+[^>]+?>|>))<a [^>]+?>([^>]+?)</a></a>#i', '$1$3</a>', $r );
  2786. }
  2787. /**
  2788. * Breaks a string into chunks by splitting at whitespace characters.
  2789. * The length of each returned chunk is as close to the specified length goal as possible,
  2790. * with the caveat that each chunk includes its trailing delimiter.
  2791. * Chunks longer than the goal are guaranteed to not have any inner whitespace.
  2792. *
  2793. * Joining the returned chunks with empty delimiters reconstructs the input string losslessly.
  2794. *
  2795. * Input string must have no null characters (or eventual transformations on output chunks must not care about null characters)
  2796. *
  2797. * _split_str_by_whitespace( "1234 67890 1234 67890a cd 1234 890 123456789 1234567890a 45678 1 3 5 7 90 ", 10 ) ==
  2798. * array (
  2799. * 0 => '1234 67890 ', // 11 characters: Perfect split.
  2800. * 1 => '1234 ', // 5 characters: '1234 67890a' was too long.
  2801. * 2 => '67890a cd ', // 10 characters: '67890a cd 1234' was too long.
  2802. * 3 => '1234 890 ', // 11 characters: Perfect split.
  2803. * 4 => '123456789 ', // 10 characters: '123456789 1234567890a' was too long.
  2804. * 5 => '1234567890a ', // 12 characters: Too long, but no inner whitespace on which to split.
  2805. * 6 => ' 45678 ', // 11 characters: Perfect split.
  2806. * 7 => '1 3 5 7 90 ', // 11 characters: End of $string.
  2807. * );
  2808. *
  2809. * @since 3.4.0
  2810. * @access private
  2811. *
  2812. * @param string $string The string to split.
  2813. * @param int $goal The desired chunk length.
  2814. * @return array Numeric array of chunks.
  2815. */
  2816. function _split_str_by_whitespace( $string, $goal ) {
  2817. $chunks = array();
  2818. $string_nullspace = strtr( $string, "\r\n\t\v\f ", "\000\000\000\000\000\000" );
  2819. while ( $goal < strlen( $string_nullspace ) ) {
  2820. $pos = strrpos( substr( $string_nullspace, 0, $goal + 1 ), "\000" );
  2821. if ( false === $pos ) {
  2822. $pos = strpos( $string_nullspace, "\000", $goal + 1 );
  2823. if ( false === $pos ) {
  2824. break;
  2825. }
  2826. }
  2827. $chunks[] = substr( $string, 0, $pos + 1 );
  2828. $string = substr( $string, $pos + 1 );
  2829. $string_nullspace = substr( $string_nullspace, $pos + 1 );
  2830. }
  2831. if ( $string ) {
  2832. $chunks[] = $string;
  2833. }
  2834. return $chunks;
  2835. }
  2836. /**
  2837. * Callback to add a rel attribute to HTML A element.
  2838. *
  2839. * Will remove already existing string before adding to prevent invalidating (X)HTML.
  2840. *
  2841. * @since 5.3.0
  2842. *
  2843. * @param array $matches Single match.
  2844. * @param string $rel The rel attribute to add.
  2845. * @return string HTML A element with the added rel attribute.
  2846. */
  2847. function wp_rel_callback( $matches, $rel ) {
  2848. $text = $matches[1];
  2849. $atts = wp_kses_hair( $matches[1], wp_allowed_protocols() );
  2850. if ( ! empty( $atts['href'] ) ) {
  2851. if ( in_array( strtolower( wp_parse_url( $atts['href']['value'], PHP_URL_SCHEME ) ), array( 'http', 'https' ), true ) ) {
  2852. if ( strtolower( wp_parse_url( $atts['href']['value'], PHP_URL_HOST ) ) === strtolower( wp_parse_url( home_url(), PHP_URL_HOST ) ) ) {
  2853. return "<a $text>";
  2854. }
  2855. }
  2856. }
  2857. if ( ! empty( $atts['rel'] ) ) {
  2858. $parts = array_map( 'trim', explode( ' ', $atts['rel']['value'] ) );
  2859. $rel_array = array_map( 'trim', explode( ' ', $rel ) );
  2860. $parts = array_unique( array_merge( $parts, $rel_array ) );
  2861. $rel = implode( ' ', $parts );
  2862. unset( $atts['rel'] );
  2863. $html = '';
  2864. foreach ( $atts as $name => $value ) {
  2865. if ( isset( $value['vless'] ) && 'y' === $value['vless'] ) {
  2866. $html .= $name . ' ';
  2867. } else {
  2868. $html .= "{$name}=\"" . esc_attr( $value['value'] ) . '" ';
  2869. }
  2870. }
  2871. $text = trim( $html );
  2872. }
  2873. return "<a $text rel=\"" . esc_attr( $rel ) . '">';
  2874. }
  2875. /**
  2876. * Adds `rel="nofollow"` string to all HTML A elements in content.
  2877. *
  2878. * @since 1.5.0
  2879. *
  2880. * @param string $text Content that may contain HTML A elements.
  2881. * @return string Converted content.
  2882. */
  2883. function wp_rel_nofollow( $text ) {
  2884. // This is a pre-save filter, so text is already escaped.
  2885. $text = stripslashes( $text );
  2886. $text = preg_replace_callback(
  2887. '|<a (.+?)>|i',
  2888. static function( $matches ) {
  2889. return wp_rel_callback( $matches, 'nofollow' );
  2890. },
  2891. $text
  2892. );
  2893. return wp_slash( $text );
  2894. }
  2895. /**
  2896. * Callback to add `rel="nofollow"` string to HTML A element.
  2897. *
  2898. * @since 2.3.0
  2899. * @deprecated 5.3.0 Use wp_rel_callback()
  2900. *
  2901. * @param array $matches Single match.
  2902. * @return string HTML A Element with `rel="nofollow"`.
  2903. */
  2904. function wp_rel_nofollow_callback( $matches ) {
  2905. return wp_rel_callback( $matches, 'nofollow' );
  2906. }
  2907. /**
  2908. * Adds `rel="nofollow ugc"` string to all HTML A elements in content.
  2909. *
  2910. * @since 5.3.0
  2911. *
  2912. * @param string $text Content that may contain HTML A elements.
  2913. * @return string Converted content.
  2914. */
  2915. function wp_rel_ugc( $text ) {
  2916. // This is a pre-save filter, so text is already escaped.
  2917. $text = stripslashes( $text );
  2918. $text = preg_replace_callback(
  2919. '|<a (.+?)>|i',
  2920. static function( $matches ) {
  2921. return wp_rel_callback( $matches, 'nofollow ugc' );
  2922. },
  2923. $text
  2924. );
  2925. return wp_slash( $text );
  2926. }
  2927. /**
  2928. * Adds `rel="noopener"` to all HTML A elements that have a target.
  2929. *
  2930. * @since 5.1.0
  2931. * @since 5.6.0 Removed 'noreferrer' relationship.
  2932. *
  2933. * @param string $text Content that may contain HTML A elements.
  2934. * @return string Converted content.
  2935. */
  2936. function wp_targeted_link_rel( $text ) {
  2937. // Don't run (more expensive) regex if no links with targets.
  2938. if ( stripos( $text, 'target' ) === false || stripos( $text, '<a ' ) === false || is_serialized( $text ) ) {
  2939. return $text;
  2940. }
  2941. $script_and_style_regex = '/<(script|style).*?<\/\\1>/si';
  2942. preg_match_all( $script_and_style_regex, $text, $matches );
  2943. $extra_parts = $matches[0];
  2944. $html_parts = preg_split( $script_and_style_regex, $text );
  2945. foreach ( $html_parts as &$part ) {
  2946. $part = preg_replace_callback( '|<a\s([^>]*target\s*=[^>]*)>|i', 'wp_targeted_link_rel_callback', $part );
  2947. }
  2948. $text = '';
  2949. for ( $i = 0; $i < count( $html_parts ); $i++ ) {
  2950. $text .= $html_parts[ $i ];
  2951. if ( isset( $extra_parts[ $i ] ) ) {
  2952. $text .= $extra_parts[ $i ];
  2953. }
  2954. }
  2955. return $text;
  2956. }
  2957. /**
  2958. * Callback to add `rel="noopener"` string to HTML A element.
  2959. *
  2960. * Will not duplicate an existing 'noopener' value to avoid invalidating the HTML.
  2961. *
  2962. * @since 5.1.0
  2963. * @since 5.6.0 Removed 'noreferrer' relationship.
  2964. *
  2965. * @param array $matches Single match.
  2966. * @return string HTML A Element with `rel="noopener"` in addition to any existing values.
  2967. */
  2968. function wp_targeted_link_rel_callback( $matches ) {
  2969. $link_html = $matches[1];
  2970. $original_link_html = $link_html;
  2971. // Consider the HTML escaped if there are no unescaped quotes.
  2972. $is_escaped = ! preg_match( '/(^|[^\\\\])[\'"]/', $link_html );
  2973. if ( $is_escaped ) {
  2974. // Replace only the quotes so that they are parsable by wp_kses_hair(), leave the rest as is.
  2975. $link_html = preg_replace( '/\\\\([\'"])/', '$1', $link_html );
  2976. }
  2977. $atts = wp_kses_hair( $link_html, wp_allowed_protocols() );
  2978. /**
  2979. * Filters the rel values that are added to links with `target` attribute.
  2980. *
  2981. * @since 5.1.0
  2982. *
  2983. * @param string $rel The rel values.
  2984. * @param string $link_html The matched content of the link tag including all HTML attributes.
  2985. */
  2986. $rel = apply_filters( 'wp_targeted_link_rel', 'noopener', $link_html );
  2987. // Return early if no rel values to be added or if no actual target attribute.
  2988. if ( ! $rel || ! isset( $atts['target'] ) ) {
  2989. return "<a $original_link_html>";
  2990. }
  2991. if ( isset( $atts['rel'] ) ) {
  2992. $all_parts = preg_split( '/\s/', "{$atts['rel']['value']} $rel", -1, PREG_SPLIT_NO_EMPTY );
  2993. $rel = implode( ' ', array_unique( $all_parts ) );
  2994. }
  2995. $atts['rel']['whole'] = 'rel="' . esc_attr( $rel ) . '"';
  2996. $link_html = implode( ' ', array_column( $atts, 'whole' ) );
  2997. if ( $is_escaped ) {
  2998. $link_html = preg_replace( '/[\'"]/', '\\\\$0', $link_html );
  2999. }
  3000. return "<a $link_html>";
  3001. }
  3002. /**
  3003. * Adds all filters modifying the rel attribute of targeted links.
  3004. *
  3005. * @since 5.1.0
  3006. */
  3007. function wp_init_targeted_link_rel_filters() {
  3008. $filters = array(
  3009. 'title_save_pre',
  3010. 'content_save_pre',
  3011. 'excerpt_save_pre',
  3012. 'content_filtered_save_pre',
  3013. 'pre_comment_content',
  3014. 'pre_term_description',
  3015. 'pre_link_description',
  3016. 'pre_link_notes',
  3017. 'pre_user_description',
  3018. );
  3019. foreach ( $filters as $filter ) {
  3020. add_filter( $filter, 'wp_targeted_link_rel' );
  3021. }
  3022. }
  3023. /**
  3024. * Removes all filters modifying the rel attribute of targeted links.
  3025. *
  3026. * @since 5.1.0
  3027. */
  3028. function wp_remove_targeted_link_rel_filters() {
  3029. $filters = array(
  3030. 'title_save_pre',
  3031. 'content_save_pre',
  3032. 'excerpt_save_pre',
  3033. 'content_filtered_save_pre',
  3034. 'pre_comment_content',
  3035. 'pre_term_description',
  3036. 'pre_link_description',
  3037. 'pre_link_notes',
  3038. 'pre_user_description',
  3039. );
  3040. foreach ( $filters as $filter ) {
  3041. remove_filter( $filter, 'wp_targeted_link_rel' );
  3042. }
  3043. }
  3044. /**
  3045. * Convert one smiley code to the icon graphic file equivalent.
  3046. *
  3047. * Callback handler for convert_smilies().
  3048. *
  3049. * Looks up one smiley code in the $wpsmiliestrans global array and returns an
  3050. * `<img>` string for that smiley.
  3051. *
  3052. * @since 2.8.0
  3053. *
  3054. * @global array $wpsmiliestrans
  3055. *
  3056. * @param array $matches Single match. Smiley code to convert to image.
  3057. * @return string Image string for smiley.
  3058. */
  3059. function translate_smiley( $matches ) {
  3060. global $wpsmiliestrans;
  3061. if ( count( $matches ) == 0 ) {
  3062. return '';
  3063. }
  3064. $smiley = trim( reset( $matches ) );
  3065. $img = $wpsmiliestrans[ $smiley ];
  3066. $matches = array();
  3067. $ext = preg_match( '/\.([^.]+)$/', $img, $matches ) ? strtolower( $matches[1] ) : false;
  3068. $image_exts = array( 'jpg', 'jpeg', 'jpe', 'gif', 'png', 'webp' );
  3069. // Don't convert smilies that aren't images - they're probably emoji.
  3070. if ( ! in_array( $ext, $image_exts, true ) ) {
  3071. return $img;
  3072. }
  3073. /**
  3074. * Filters the Smiley image URL before it's used in the image element.
  3075. *
  3076. * @since 2.9.0
  3077. *
  3078. * @param string $smiley_url URL for the smiley image.
  3079. * @param string $img Filename for the smiley image.
  3080. * @param string $site_url Site URL, as returned by site_url().
  3081. */
  3082. $src_url = apply_filters( 'smilies_src', includes_url( "images/smilies/$img" ), $img, site_url() );
  3083. return sprintf( '<img src="%s" alt="%s" class="wp-smiley" style="height: 1em; max-height: 1em;" />', esc_url( $src_url ), esc_attr( $smiley ) );
  3084. }
  3085. /**
  3086. * Convert text equivalent of smilies to images.
  3087. *
  3088. * Will only convert smilies if the option 'use_smilies' is true and the global
  3089. * used in the function isn't empty.
  3090. *
  3091. * @since 0.71
  3092. *
  3093. * @global string|array $wp_smiliessearch
  3094. *
  3095. * @param string $text Content to convert smilies from text.
  3096. * @return string Converted content with text smilies replaced with images.
  3097. */
  3098. function convert_smilies( $text ) {
  3099. global $wp_smiliessearch;
  3100. $output = '';
  3101. if ( get_option( 'use_smilies' ) && ! empty( $wp_smiliessearch ) ) {
  3102. // HTML loop taken from texturize function, could possible be consolidated.
  3103. $textarr = preg_split( '/(<.*>)/U', $text, -1, PREG_SPLIT_DELIM_CAPTURE ); // Capture the tags as well as in between.
  3104. $stop = count( $textarr ); // Loop stuff.
  3105. // Ignore proessing of specific tags.
  3106. $tags_to_ignore = 'code|pre|style|script|textarea';
  3107. $ignore_block_element = '';
  3108. for ( $i = 0; $i < $stop; $i++ ) {
  3109. $content = $textarr[ $i ];
  3110. // If we're in an ignore block, wait until we find its closing tag.
  3111. if ( '' === $ignore_block_element && preg_match( '/^<(' . $tags_to_ignore . ')[^>]*>/', $content, $matches ) ) {
  3112. $ignore_block_element = $matches[1];
  3113. }
  3114. // If it's not a tag and not in ignore block.
  3115. if ( '' === $ignore_block_element && strlen( $content ) > 0 && '<' !== $content[0] ) {
  3116. $content = preg_replace_callback( $wp_smiliessearch, 'translate_smiley', $content );
  3117. }
  3118. // Did we exit ignore block?
  3119. if ( '' !== $ignore_block_element && '</' . $ignore_block_element . '>' === $content ) {
  3120. $ignore_block_element = '';
  3121. }
  3122. $output .= $content;
  3123. }
  3124. } else {
  3125. // Return default text.
  3126. $output = $text;
  3127. }
  3128. return $output;
  3129. }
  3130. /**
  3131. * Verifies that an email is valid.
  3132. *
  3133. * Does not grok i18n domains. Not RFC compliant.
  3134. *
  3135. * @since 0.71
  3136. *
  3137. * @param string $email Email address to verify.
  3138. * @param bool $deprecated Deprecated.
  3139. * @return string|false Valid email address on success, false on failure.
  3140. */
  3141. function is_email( $email, $deprecated = false ) {
  3142. if ( ! empty( $deprecated ) ) {
  3143. _deprecated_argument( __FUNCTION__, '3.0.0' );
  3144. }
  3145. // Test for the minimum length the email can be.
  3146. if ( strlen( $email ) < 6 ) {
  3147. /**
  3148. * Filters whether an email address is valid.
  3149. *
  3150. * This filter is evaluated under several different contexts, such as 'email_too_short',
  3151. * 'email_no_at', 'local_invalid_chars', 'domain_period_sequence', 'domain_period_limits',
  3152. * 'domain_no_periods', 'sub_hyphen_limits', 'sub_invalid_chars', or no specific context.
  3153. *
  3154. * @since 2.8.0
  3155. *
  3156. * @param string|false $is_email The email address if successfully passed the is_email() checks, false otherwise.
  3157. * @param string $email The email address being checked.
  3158. * @param string $context Context under which the email was tested.
  3159. */
  3160. return apply_filters( 'is_email', false, $email, 'email_too_short' );
  3161. }
  3162. // Test for an @ character after the first position.
  3163. if ( strpos( $email, '@', 1 ) === false ) {
  3164. /** This filter is documented in wp-includes/formatting.php */
  3165. return apply_filters( 'is_email', false, $email, 'email_no_at' );
  3166. }
  3167. // Split out the local and domain parts.
  3168. list( $local, $domain ) = explode( '@', $email, 2 );
  3169. // LOCAL PART
  3170. // Test for invalid characters.
  3171. if ( ! preg_match( '/^[a-zA-Z0-9!#$%&\'*+\/=?^_`{|}~\.-]+$/', $local ) ) {
  3172. /** This filter is documented in wp-includes/formatting.php */
  3173. return apply_filters( 'is_email', false, $email, 'local_invalid_chars' );
  3174. }
  3175. // DOMAIN PART
  3176. // Test for sequences of periods.
  3177. if ( preg_match( '/\.{2,}/', $domain ) ) {
  3178. /** This filter is documented in wp-includes/formatting.php */
  3179. return apply_filters( 'is_email', false, $email, 'domain_period_sequence' );
  3180. }
  3181. // Test for leading and trailing periods and whitespace.
  3182. if ( trim( $domain, " \t\n\r\0\x0B." ) !== $domain ) {
  3183. /** This filter is documented in wp-includes/formatting.php */
  3184. return apply_filters( 'is_email', false, $email, 'domain_period_limits' );
  3185. }
  3186. // Split the domain into subs.
  3187. $subs = explode( '.', $domain );
  3188. // Assume the domain will have at least two subs.
  3189. if ( 2 > count( $subs ) ) {
  3190. /** This filter is documented in wp-includes/formatting.php */
  3191. return apply_filters( 'is_email', false, $email, 'domain_no_periods' );
  3192. }
  3193. // Loop through each sub.
  3194. foreach ( $subs as $sub ) {
  3195. // Test for leading and trailing hyphens and whitespace.
  3196. if ( trim( $sub, " \t\n\r\0\x0B-" ) !== $sub ) {
  3197. /** This filter is documented in wp-includes/formatting.php */
  3198. return apply_filters( 'is_email', false, $email, 'sub_hyphen_limits' );
  3199. }
  3200. // Test for invalid characters.
  3201. if ( ! preg_match( '/^[a-z0-9-]+$/i', $sub ) ) {
  3202. /** This filter is documented in wp-includes/formatting.php */
  3203. return apply_filters( 'is_email', false, $email, 'sub_invalid_chars' );
  3204. }
  3205. }
  3206. // Congratulations, your email made it!
  3207. /** This filter is documented in wp-includes/formatting.php */
  3208. return apply_filters( 'is_email', $email, $email, null );
  3209. }
  3210. /**
  3211. * Convert to ASCII from email subjects.
  3212. *
  3213. * @since 1.2.0
  3214. *
  3215. * @param string $string Subject line
  3216. * @return string Converted string to ASCII
  3217. */
  3218. function wp_iso_descrambler( $string ) {
  3219. /* this may only work with iso-8859-1, I'm afraid */
  3220. if ( ! preg_match( '#\=\?(.+)\?Q\?(.+)\?\=#i', $string, $matches ) ) {
  3221. return $string;
  3222. } else {
  3223. $subject = str_replace( '_', ' ', $matches[2] );
  3224. return preg_replace_callback( '#\=([0-9a-f]{2})#i', '_wp_iso_convert', $subject );
  3225. }
  3226. }
  3227. /**
  3228. * Helper function to convert hex encoded chars to ASCII
  3229. *
  3230. * @since 3.1.0
  3231. * @access private
  3232. *
  3233. * @param array $match The preg_replace_callback matches array
  3234. * @return string Converted chars
  3235. */
  3236. function _wp_iso_convert( $match ) {
  3237. return chr( hexdec( strtolower( $match[1] ) ) );
  3238. }
  3239. /**
  3240. * Given a date in the timezone of the site, returns that date in UTC.
  3241. *
  3242. * Requires and returns a date in the Y-m-d H:i:s format.
  3243. * Return format can be overridden using the $format parameter.
  3244. *
  3245. * @since 1.2.0
  3246. *
  3247. * @param string $string The date to be converted, in the timezone of the site.
  3248. * @param string $format The format string for the returned date. Default 'Y-m-d H:i:s'.
  3249. * @return string Formatted version of the date, in UTC.
  3250. */
  3251. function get_gmt_from_date( $string, $format = 'Y-m-d H:i:s' ) {
  3252. $datetime = date_create( $string, wp_timezone() );
  3253. if ( false === $datetime ) {
  3254. return gmdate( $format, 0 );
  3255. }
  3256. return $datetime->setTimezone( new DateTimeZone( 'UTC' ) )->format( $format );
  3257. }
  3258. /**
  3259. * Given a date in UTC or GMT timezone, returns that date in the timezone of the site.
  3260. *
  3261. * Requires a date in the Y-m-d H:i:s format.
  3262. * Default return format of 'Y-m-d H:i:s' can be overridden using the `$format` parameter.
  3263. *
  3264. * @since 1.2.0
  3265. *
  3266. * @param string $string The date to be converted, in UTC or GMT timezone.
  3267. * @param string $format The format string for the returned date. Default 'Y-m-d H:i:s'.
  3268. * @return string Formatted version of the date, in the site's timezone.
  3269. */
  3270. function get_date_from_gmt( $string, $format = 'Y-m-d H:i:s' ) {
  3271. $datetime = date_create( $string, new DateTimeZone( 'UTC' ) );
  3272. if ( false === $datetime ) {
  3273. return gmdate( $format, 0 );
  3274. }
  3275. return $datetime->setTimezone( wp_timezone() )->format( $format );
  3276. }
  3277. /**
  3278. * Given an ISO 8601 timezone, returns its UTC offset in seconds.
  3279. *
  3280. * @since 1.5.0
  3281. *
  3282. * @param string $timezone Either 'Z' for 0 offset or '±hhmm'.
  3283. * @return int|float The offset in seconds.
  3284. */
  3285. function iso8601_timezone_to_offset( $timezone ) {
  3286. // $timezone is either 'Z' or '[+|-]hhmm'.
  3287. if ( 'Z' === $timezone ) {
  3288. $offset = 0;
  3289. } else {
  3290. $sign = ( '+' === substr( $timezone, 0, 1 ) ) ? 1 : -1;
  3291. $hours = (int) substr( $timezone, 1, 2 );
  3292. $minutes = (int) substr( $timezone, 3, 4 ) / 60;
  3293. $offset = $sign * HOUR_IN_SECONDS * ( $hours + $minutes );
  3294. }
  3295. return $offset;
  3296. }
  3297. /**
  3298. * Given an ISO 8601 (Ymd\TH:i:sO) date, returns a MySQL DateTime (Y-m-d H:i:s) format used by post_date[_gmt].
  3299. *
  3300. * @since 1.5.0
  3301. *
  3302. * @param string $date_string Date and time in ISO 8601 format {@link https://en.wikipedia.org/wiki/ISO_8601}.
  3303. * @param string $timezone Optional. If set to 'gmt' returns the result in UTC. Default 'user'.
  3304. * @return string|false The date and time in MySQL DateTime format - Y-m-d H:i:s, or false on failure.
  3305. */
  3306. function iso8601_to_datetime( $date_string, $timezone = 'user' ) {
  3307. $timezone = strtolower( $timezone );
  3308. $wp_timezone = wp_timezone();
  3309. $datetime = date_create( $date_string, $wp_timezone ); // Timezone is ignored if input has one.
  3310. if ( false === $datetime ) {
  3311. return false;
  3312. }
  3313. if ( 'gmt' === $timezone ) {
  3314. return $datetime->setTimezone( new DateTimeZone( 'UTC' ) )->format( 'Y-m-d H:i:s' );
  3315. }
  3316. if ( 'user' === $timezone ) {
  3317. return $datetime->setTimezone( $wp_timezone )->format( 'Y-m-d H:i:s' );
  3318. }
  3319. return false;
  3320. }
  3321. /**
  3322. * Strips out all characters that are not allowable in an email.
  3323. *
  3324. * @since 1.5.0
  3325. *
  3326. * @param string $email Email address to filter.
  3327. * @return string Filtered email address.
  3328. */
  3329. function sanitize_email( $email ) {
  3330. // Test for the minimum length the email can be.
  3331. if ( strlen( $email ) < 6 ) {
  3332. /**
  3333. * Filters a sanitized email address.
  3334. *
  3335. * This filter is evaluated under several contexts, including 'email_too_short',
  3336. * 'email_no_at', 'local_invalid_chars', 'domain_period_sequence', 'domain_period_limits',
  3337. * 'domain_no_periods', 'domain_no_valid_subs', or no context.
  3338. *
  3339. * @since 2.8.0
  3340. *
  3341. * @param string $sanitized_email The sanitized email address.
  3342. * @param string $email The email address, as provided to sanitize_email().
  3343. * @param string|null $message A message to pass to the user. null if email is sanitized.
  3344. */
  3345. return apply_filters( 'sanitize_email', '', $email, 'email_too_short' );
  3346. }
  3347. // Test for an @ character after the first position.
  3348. if ( strpos( $email, '@', 1 ) === false ) {
  3349. /** This filter is documented in wp-includes/formatting.php */
  3350. return apply_filters( 'sanitize_email', '', $email, 'email_no_at' );
  3351. }
  3352. // Split out the local and domain parts.
  3353. list( $local, $domain ) = explode( '@', $email, 2 );
  3354. // LOCAL PART
  3355. // Test for invalid characters.
  3356. $local = preg_replace( '/[^a-zA-Z0-9!#$%&\'*+\/=?^_`{|}~\.-]/', '', $local );
  3357. if ( '' === $local ) {
  3358. /** This filter is documented in wp-includes/formatting.php */
  3359. return apply_filters( 'sanitize_email', '', $email, 'local_invalid_chars' );
  3360. }
  3361. // DOMAIN PART
  3362. // Test for sequences of periods.
  3363. $domain = preg_replace( '/\.{2,}/', '', $domain );
  3364. if ( '' === $domain ) {
  3365. /** This filter is documented in wp-includes/formatting.php */
  3366. return apply_filters( 'sanitize_email', '', $email, 'domain_period_sequence' );
  3367. }
  3368. // Test for leading and trailing periods and whitespace.
  3369. $domain = trim( $domain, " \t\n\r\0\x0B." );
  3370. if ( '' === $domain ) {
  3371. /** This filter is documented in wp-includes/formatting.php */
  3372. return apply_filters( 'sanitize_email', '', $email, 'domain_period_limits' );
  3373. }
  3374. // Split the domain into subs.
  3375. $subs = explode( '.', $domain );
  3376. // Assume the domain will have at least two subs.
  3377. if ( 2 > count( $subs ) ) {
  3378. /** This filter is documented in wp-includes/formatting.php */
  3379. return apply_filters( 'sanitize_email', '', $email, 'domain_no_periods' );
  3380. }
  3381. // Create an array that will contain valid subs.
  3382. $new_subs = array();
  3383. // Loop through each sub.
  3384. foreach ( $subs as $sub ) {
  3385. // Test for leading and trailing hyphens.
  3386. $sub = trim( $sub, " \t\n\r\0\x0B-" );
  3387. // Test for invalid characters.
  3388. $sub = preg_replace( '/[^a-z0-9-]+/i', '', $sub );
  3389. // If there's anything left, add it to the valid subs.
  3390. if ( '' !== $sub ) {
  3391. $new_subs[] = $sub;
  3392. }
  3393. }
  3394. // If there aren't 2 or more valid subs.
  3395. if ( 2 > count( $new_subs ) ) {
  3396. /** This filter is documented in wp-includes/formatting.php */
  3397. return apply_filters( 'sanitize_email', '', $email, 'domain_no_valid_subs' );
  3398. }
  3399. // Join valid subs into the new domain.
  3400. $domain = implode( '.', $new_subs );
  3401. // Put the email back together.
  3402. $sanitized_email = $local . '@' . $domain;
  3403. // Congratulations, your email made it!
  3404. /** This filter is documented in wp-includes/formatting.php */
  3405. return apply_filters( 'sanitize_email', $sanitized_email, $email, null );
  3406. }
  3407. /**
  3408. * Determines the difference between two timestamps.
  3409. *
  3410. * The difference is returned in a human readable format such as "1 hour",
  3411. * "5 mins", "2 days".
  3412. *
  3413. * @since 1.5.0
  3414. * @since 5.3.0 Added support for showing a difference in seconds.
  3415. *
  3416. * @param int $from Unix timestamp from which the difference begins.
  3417. * @param int $to Optional. Unix timestamp to end the time difference. Default becomes time() if not set.
  3418. * @return string Human readable time difference.
  3419. */
  3420. function human_time_diff( $from, $to = 0 ) {
  3421. if ( empty( $to ) ) {
  3422. $to = time();
  3423. }
  3424. $diff = (int) abs( $to - $from );
  3425. if ( $diff < MINUTE_IN_SECONDS ) {
  3426. $secs = $diff;
  3427. if ( $secs <= 1 ) {
  3428. $secs = 1;
  3429. }
  3430. /* translators: Time difference between two dates, in seconds. %s: Number of seconds. */
  3431. $since = sprintf( _n( '%s second', '%s seconds', $secs ), $secs );
  3432. } elseif ( $diff < HOUR_IN_SECONDS && $diff >= MINUTE_IN_SECONDS ) {
  3433. $mins = round( $diff / MINUTE_IN_SECONDS );
  3434. if ( $mins <= 1 ) {
  3435. $mins = 1;
  3436. }
  3437. /* translators: Time difference between two dates, in minutes (min=minute). %s: Number of minutes. */
  3438. $since = sprintf( _n( '%s min', '%s mins', $mins ), $mins );
  3439. } elseif ( $diff < DAY_IN_SECONDS && $diff >= HOUR_IN_SECONDS ) {
  3440. $hours = round( $diff / HOUR_IN_SECONDS );
  3441. if ( $hours <= 1 ) {
  3442. $hours = 1;
  3443. }
  3444. /* translators: Time difference between two dates, in hours. %s: Number of hours. */
  3445. $since = sprintf( _n( '%s hour', '%s hours', $hours ), $hours );
  3446. } elseif ( $diff < WEEK_IN_SECONDS && $diff >= DAY_IN_SECONDS ) {
  3447. $days = round( $diff / DAY_IN_SECONDS );
  3448. if ( $days <= 1 ) {
  3449. $days = 1;
  3450. }
  3451. /* translators: Time difference between two dates, in days. %s: Number of days. */
  3452. $since = sprintf( _n( '%s day', '%s days', $days ), $days );
  3453. } elseif ( $diff < MONTH_IN_SECONDS && $diff >= WEEK_IN_SECONDS ) {
  3454. $weeks = round( $diff / WEEK_IN_SECONDS );
  3455. if ( $weeks <= 1 ) {
  3456. $weeks = 1;
  3457. }
  3458. /* translators: Time difference between two dates, in weeks. %s: Number of weeks. */
  3459. $since = sprintf( _n( '%s week', '%s weeks', $weeks ), $weeks );
  3460. } elseif ( $diff < YEAR_IN_SECONDS && $diff >= MONTH_IN_SECONDS ) {
  3461. $months = round( $diff / MONTH_IN_SECONDS );
  3462. if ( $months <= 1 ) {
  3463. $months = 1;
  3464. }
  3465. /* translators: Time difference between two dates, in months. %s: Number of months. */
  3466. $since = sprintf( _n( '%s month', '%s months', $months ), $months );
  3467. } elseif ( $diff >= YEAR_IN_SECONDS ) {
  3468. $years = round( $diff / YEAR_IN_SECONDS );
  3469. if ( $years <= 1 ) {
  3470. $years = 1;
  3471. }
  3472. /* translators: Time difference between two dates, in years. %s: Number of years. */
  3473. $since = sprintf( _n( '%s year', '%s years', $years ), $years );
  3474. }
  3475. /**
  3476. * Filters the human readable difference between two timestamps.
  3477. *
  3478. * @since 4.0.0
  3479. *
  3480. * @param string $since The difference in human readable text.
  3481. * @param int $diff The difference in seconds.
  3482. * @param int $from Unix timestamp from which the difference begins.
  3483. * @param int $to Unix timestamp to end the time difference.
  3484. */
  3485. return apply_filters( 'human_time_diff', $since, $diff, $from, $to );
  3486. }
  3487. /**
  3488. * Generates an excerpt from the content, if needed.
  3489. *
  3490. * Returns a maximum of 55 words with an ellipsis appended if necessary.
  3491. *
  3492. * The 55 word limit can be modified by plugins/themes using the {@see 'excerpt_length'} filter
  3493. * The ' [&hellip;]' string can be modified by plugins/themes using the {@see 'excerpt_more'} filter
  3494. *
  3495. * @since 1.5.0
  3496. * @since 5.2.0 Added the `$post` parameter.
  3497. *
  3498. * @param string $text Optional. The excerpt. If set to empty, an excerpt is generated.
  3499. * @param WP_Post|object|int $post Optional. WP_Post instance or Post ID/object. Default null.
  3500. * @return string The excerpt.
  3501. */
  3502. function wp_trim_excerpt( $text = '', $post = null ) {
  3503. $raw_excerpt = $text;
  3504. if ( '' === trim( $text ) ) {
  3505. $post = get_post( $post );
  3506. $text = get_the_content( '', false, $post );
  3507. $text = strip_shortcodes( $text );
  3508. $text = excerpt_remove_blocks( $text );
  3509. /** This filter is documented in wp-includes/post-template.php */
  3510. $text = apply_filters( 'the_content', $text );
  3511. $text = str_replace( ']]>', ']]&gt;', $text );
  3512. /* translators: Maximum number of words used in a post excerpt. */
  3513. $excerpt_length = (int) _x( '55', 'excerpt_length' );
  3514. /**
  3515. * Filters the maximum number of words in a post excerpt.
  3516. *
  3517. * @since 2.7.0
  3518. *
  3519. * @param int $number The maximum number of words. Default 55.
  3520. */
  3521. $excerpt_length = (int) apply_filters( 'excerpt_length', $excerpt_length );
  3522. /**
  3523. * Filters the string in the "more" link displayed after a trimmed excerpt.
  3524. *
  3525. * @since 2.9.0
  3526. *
  3527. * @param string $more_string The string shown within the more link.
  3528. */
  3529. $excerpt_more = apply_filters( 'excerpt_more', ' ' . '[&hellip;]' );
  3530. $text = wp_trim_words( $text, $excerpt_length, $excerpt_more );
  3531. }
  3532. /**
  3533. * Filters the trimmed excerpt string.
  3534. *
  3535. * @since 2.8.0
  3536. *
  3537. * @param string $text The trimmed text.
  3538. * @param string $raw_excerpt The text prior to trimming.
  3539. */
  3540. return apply_filters( 'wp_trim_excerpt', $text, $raw_excerpt );
  3541. }
  3542. /**
  3543. * Trims text to a certain number of words.
  3544. *
  3545. * This function is localized. For languages that count 'words' by the individual
  3546. * character (such as East Asian languages), the $num_words argument will apply
  3547. * to the number of individual characters.
  3548. *
  3549. * @since 3.3.0
  3550. *
  3551. * @param string $text Text to trim.
  3552. * @param int $num_words Number of words. Default 55.
  3553. * @param string $more Optional. What to append if $text needs to be trimmed. Default '&hellip;'.
  3554. * @return string Trimmed text.
  3555. */
  3556. function wp_trim_words( $text, $num_words = 55, $more = null ) {
  3557. if ( null === $more ) {
  3558. $more = __( '&hellip;' );
  3559. }
  3560. $original_text = $text;
  3561. $text = wp_strip_all_tags( $text );
  3562. $num_words = (int) $num_words;
  3563. /*
  3564. * translators: If your word count is based on single characters (e.g. East Asian characters),
  3565. * enter 'characters_excluding_spaces' or 'characters_including_spaces'. Otherwise, enter 'words'.
  3566. * Do not translate into your own language.
  3567. */
  3568. if ( strpos( _x( 'words', 'Word count type. Do not translate!' ), 'characters' ) === 0 && preg_match( '/^utf\-?8$/i', get_option( 'blog_charset' ) ) ) {
  3569. $text = trim( preg_replace( "/[\n\r\t ]+/", ' ', $text ), ' ' );
  3570. preg_match_all( '/./u', $text, $words_array );
  3571. $words_array = array_slice( $words_array[0], 0, $num_words + 1 );
  3572. $sep = '';
  3573. } else {
  3574. $words_array = preg_split( "/[\n\r\t ]+/", $text, $num_words + 1, PREG_SPLIT_NO_EMPTY );
  3575. $sep = ' ';
  3576. }
  3577. if ( count( $words_array ) > $num_words ) {
  3578. array_pop( $words_array );
  3579. $text = implode( $sep, $words_array );
  3580. $text = $text . $more;
  3581. } else {
  3582. $text = implode( $sep, $words_array );
  3583. }
  3584. /**
  3585. * Filters the text content after words have been trimmed.
  3586. *
  3587. * @since 3.3.0
  3588. *
  3589. * @param string $text The trimmed text.
  3590. * @param int $num_words The number of words to trim the text to. Default 55.
  3591. * @param string $more An optional string to append to the end of the trimmed text, e.g. &hellip;.
  3592. * @param string $original_text The text before it was trimmed.
  3593. */
  3594. return apply_filters( 'wp_trim_words', $text, $num_words, $more, $original_text );
  3595. }
  3596. /**
  3597. * Converts named entities into numbered entities.
  3598. *
  3599. * @since 1.5.1
  3600. *
  3601. * @param string $text The text within which entities will be converted.
  3602. * @return string Text with converted entities.
  3603. */
  3604. function ent2ncr( $text ) {
  3605. /**
  3606. * Filters text before named entities are converted into numbered entities.
  3607. *
  3608. * A non-null string must be returned for the filter to be evaluated.
  3609. *
  3610. * @since 3.3.0
  3611. *
  3612. * @param string|null $converted_text The text to be converted. Default null.
  3613. * @param string $text The text prior to entity conversion.
  3614. */
  3615. $filtered = apply_filters( 'pre_ent2ncr', null, $text );
  3616. if ( null !== $filtered ) {
  3617. return $filtered;
  3618. }
  3619. $to_ncr = array(
  3620. '&quot;' => '&#34;',
  3621. '&amp;' => '&#38;',
  3622. '&lt;' => '&#60;',
  3623. '&gt;' => '&#62;',
  3624. '|' => '&#124;',
  3625. '&nbsp;' => '&#160;',
  3626. '&iexcl;' => '&#161;',
  3627. '&cent;' => '&#162;',
  3628. '&pound;' => '&#163;',
  3629. '&curren;' => '&#164;',
  3630. '&yen;' => '&#165;',
  3631. '&brvbar;' => '&#166;',
  3632. '&brkbar;' => '&#166;',
  3633. '&sect;' => '&#167;',
  3634. '&uml;' => '&#168;',
  3635. '&die;' => '&#168;',
  3636. '&copy;' => '&#169;',
  3637. '&ordf;' => '&#170;',
  3638. '&laquo;' => '&#171;',
  3639. '&not;' => '&#172;',
  3640. '&shy;' => '&#173;',
  3641. '&reg;' => '&#174;',
  3642. '&macr;' => '&#175;',
  3643. '&hibar;' => '&#175;',
  3644. '&deg;' => '&#176;',
  3645. '&plusmn;' => '&#177;',
  3646. '&sup2;' => '&#178;',
  3647. '&sup3;' => '&#179;',
  3648. '&acute;' => '&#180;',
  3649. '&micro;' => '&#181;',
  3650. '&para;' => '&#182;',
  3651. '&middot;' => '&#183;',
  3652. '&cedil;' => '&#184;',
  3653. '&sup1;' => '&#185;',
  3654. '&ordm;' => '&#186;',
  3655. '&raquo;' => '&#187;',
  3656. '&frac14;' => '&#188;',
  3657. '&frac12;' => '&#189;',
  3658. '&frac34;' => '&#190;',
  3659. '&iquest;' => '&#191;',
  3660. '&Agrave;' => '&#192;',
  3661. '&Aacute;' => '&#193;',
  3662. '&Acirc;' => '&#194;',
  3663. '&Atilde;' => '&#195;',
  3664. '&Auml;' => '&#196;',
  3665. '&Aring;' => '&#197;',
  3666. '&AElig;' => '&#198;',
  3667. '&Ccedil;' => '&#199;',
  3668. '&Egrave;' => '&#200;',
  3669. '&Eacute;' => '&#201;',
  3670. '&Ecirc;' => '&#202;',
  3671. '&Euml;' => '&#203;',
  3672. '&Igrave;' => '&#204;',
  3673. '&Iacute;' => '&#205;',
  3674. '&Icirc;' => '&#206;',
  3675. '&Iuml;' => '&#207;',
  3676. '&ETH;' => '&#208;',
  3677. '&Ntilde;' => '&#209;',
  3678. '&Ograve;' => '&#210;',
  3679. '&Oacute;' => '&#211;',
  3680. '&Ocirc;' => '&#212;',
  3681. '&Otilde;' => '&#213;',
  3682. '&Ouml;' => '&#214;',
  3683. '&times;' => '&#215;',
  3684. '&Oslash;' => '&#216;',
  3685. '&Ugrave;' => '&#217;',
  3686. '&Uacute;' => '&#218;',
  3687. '&Ucirc;' => '&#219;',
  3688. '&Uuml;' => '&#220;',
  3689. '&Yacute;' => '&#221;',
  3690. '&THORN;' => '&#222;',
  3691. '&szlig;' => '&#223;',
  3692. '&agrave;' => '&#224;',
  3693. '&aacute;' => '&#225;',
  3694. '&acirc;' => '&#226;',
  3695. '&atilde;' => '&#227;',
  3696. '&auml;' => '&#228;',
  3697. '&aring;' => '&#229;',
  3698. '&aelig;' => '&#230;',
  3699. '&ccedil;' => '&#231;',
  3700. '&egrave;' => '&#232;',
  3701. '&eacute;' => '&#233;',
  3702. '&ecirc;' => '&#234;',
  3703. '&euml;' => '&#235;',
  3704. '&igrave;' => '&#236;',
  3705. '&iacute;' => '&#237;',
  3706. '&icirc;' => '&#238;',
  3707. '&iuml;' => '&#239;',
  3708. '&eth;' => '&#240;',
  3709. '&ntilde;' => '&#241;',
  3710. '&ograve;' => '&#242;',
  3711. '&oacute;' => '&#243;',
  3712. '&ocirc;' => '&#244;',
  3713. '&otilde;' => '&#245;',
  3714. '&ouml;' => '&#246;',
  3715. '&divide;' => '&#247;',
  3716. '&oslash;' => '&#248;',
  3717. '&ugrave;' => '&#249;',
  3718. '&uacute;' => '&#250;',
  3719. '&ucirc;' => '&#251;',
  3720. '&uuml;' => '&#252;',
  3721. '&yacute;' => '&#253;',
  3722. '&thorn;' => '&#254;',
  3723. '&yuml;' => '&#255;',
  3724. '&OElig;' => '&#338;',
  3725. '&oelig;' => '&#339;',
  3726. '&Scaron;' => '&#352;',
  3727. '&scaron;' => '&#353;',
  3728. '&Yuml;' => '&#376;',
  3729. '&fnof;' => '&#402;',
  3730. '&circ;' => '&#710;',
  3731. '&tilde;' => '&#732;',
  3732. '&Alpha;' => '&#913;',
  3733. '&Beta;' => '&#914;',
  3734. '&Gamma;' => '&#915;',
  3735. '&Delta;' => '&#916;',
  3736. '&Epsilon;' => '&#917;',
  3737. '&Zeta;' => '&#918;',
  3738. '&Eta;' => '&#919;',
  3739. '&Theta;' => '&#920;',
  3740. '&Iota;' => '&#921;',
  3741. '&Kappa;' => '&#922;',
  3742. '&Lambda;' => '&#923;',
  3743. '&Mu;' => '&#924;',
  3744. '&Nu;' => '&#925;',
  3745. '&Xi;' => '&#926;',
  3746. '&Omicron;' => '&#927;',
  3747. '&Pi;' => '&#928;',
  3748. '&Rho;' => '&#929;',
  3749. '&Sigma;' => '&#931;',
  3750. '&Tau;' => '&#932;',
  3751. '&Upsilon;' => '&#933;',
  3752. '&Phi;' => '&#934;',
  3753. '&Chi;' => '&#935;',
  3754. '&Psi;' => '&#936;',
  3755. '&Omega;' => '&#937;',
  3756. '&alpha;' => '&#945;',
  3757. '&beta;' => '&#946;',
  3758. '&gamma;' => '&#947;',
  3759. '&delta;' => '&#948;',
  3760. '&epsilon;' => '&#949;',
  3761. '&zeta;' => '&#950;',
  3762. '&eta;' => '&#951;',
  3763. '&theta;' => '&#952;',
  3764. '&iota;' => '&#953;',
  3765. '&kappa;' => '&#954;',
  3766. '&lambda;' => '&#955;',
  3767. '&mu;' => '&#956;',
  3768. '&nu;' => '&#957;',
  3769. '&xi;' => '&#958;',
  3770. '&omicron;' => '&#959;',
  3771. '&pi;' => '&#960;',
  3772. '&rho;' => '&#961;',
  3773. '&sigmaf;' => '&#962;',
  3774. '&sigma;' => '&#963;',
  3775. '&tau;' => '&#964;',
  3776. '&upsilon;' => '&#965;',
  3777. '&phi;' => '&#966;',
  3778. '&chi;' => '&#967;',
  3779. '&psi;' => '&#968;',
  3780. '&omega;' => '&#969;',
  3781. '&thetasym;' => '&#977;',
  3782. '&upsih;' => '&#978;',
  3783. '&piv;' => '&#982;',
  3784. '&ensp;' => '&#8194;',
  3785. '&emsp;' => '&#8195;',
  3786. '&thinsp;' => '&#8201;',
  3787. '&zwnj;' => '&#8204;',
  3788. '&zwj;' => '&#8205;',
  3789. '&lrm;' => '&#8206;',
  3790. '&rlm;' => '&#8207;',
  3791. '&ndash;' => '&#8211;',
  3792. '&mdash;' => '&#8212;',
  3793. '&lsquo;' => '&#8216;',
  3794. '&rsquo;' => '&#8217;',
  3795. '&sbquo;' => '&#8218;',
  3796. '&ldquo;' => '&#8220;',
  3797. '&rdquo;' => '&#8221;',
  3798. '&bdquo;' => '&#8222;',
  3799. '&dagger;' => '&#8224;',
  3800. '&Dagger;' => '&#8225;',
  3801. '&bull;' => '&#8226;',
  3802. '&hellip;' => '&#8230;',
  3803. '&permil;' => '&#8240;',
  3804. '&prime;' => '&#8242;',
  3805. '&Prime;' => '&#8243;',
  3806. '&lsaquo;' => '&#8249;',
  3807. '&rsaquo;' => '&#8250;',
  3808. '&oline;' => '&#8254;',
  3809. '&frasl;' => '&#8260;',
  3810. '&euro;' => '&#8364;',
  3811. '&image;' => '&#8465;',
  3812. '&weierp;' => '&#8472;',
  3813. '&real;' => '&#8476;',
  3814. '&trade;' => '&#8482;',
  3815. '&alefsym;' => '&#8501;',
  3816. '&crarr;' => '&#8629;',
  3817. '&lArr;' => '&#8656;',
  3818. '&uArr;' => '&#8657;',
  3819. '&rArr;' => '&#8658;',
  3820. '&dArr;' => '&#8659;',
  3821. '&hArr;' => '&#8660;',
  3822. '&forall;' => '&#8704;',
  3823. '&part;' => '&#8706;',
  3824. '&exist;' => '&#8707;',
  3825. '&empty;' => '&#8709;',
  3826. '&nabla;' => '&#8711;',
  3827. '&isin;' => '&#8712;',
  3828. '&notin;' => '&#8713;',
  3829. '&ni;' => '&#8715;',
  3830. '&prod;' => '&#8719;',
  3831. '&sum;' => '&#8721;',
  3832. '&minus;' => '&#8722;',
  3833. '&lowast;' => '&#8727;',
  3834. '&radic;' => '&#8730;',
  3835. '&prop;' => '&#8733;',
  3836. '&infin;' => '&#8734;',
  3837. '&ang;' => '&#8736;',
  3838. '&and;' => '&#8743;',
  3839. '&or;' => '&#8744;',
  3840. '&cap;' => '&#8745;',
  3841. '&cup;' => '&#8746;',
  3842. '&int;' => '&#8747;',
  3843. '&there4;' => '&#8756;',
  3844. '&sim;' => '&#8764;',
  3845. '&cong;' => '&#8773;',
  3846. '&asymp;' => '&#8776;',
  3847. '&ne;' => '&#8800;',
  3848. '&equiv;' => '&#8801;',
  3849. '&le;' => '&#8804;',
  3850. '&ge;' => '&#8805;',
  3851. '&sub;' => '&#8834;',
  3852. '&sup;' => '&#8835;',
  3853. '&nsub;' => '&#8836;',
  3854. '&sube;' => '&#8838;',
  3855. '&supe;' => '&#8839;',
  3856. '&oplus;' => '&#8853;',
  3857. '&otimes;' => '&#8855;',
  3858. '&perp;' => '&#8869;',
  3859. '&sdot;' => '&#8901;',
  3860. '&lceil;' => '&#8968;',
  3861. '&rceil;' => '&#8969;',
  3862. '&lfloor;' => '&#8970;',
  3863. '&rfloor;' => '&#8971;',
  3864. '&lang;' => '&#9001;',
  3865. '&rang;' => '&#9002;',
  3866. '&larr;' => '&#8592;',
  3867. '&uarr;' => '&#8593;',
  3868. '&rarr;' => '&#8594;',
  3869. '&darr;' => '&#8595;',
  3870. '&harr;' => '&#8596;',
  3871. '&loz;' => '&#9674;',
  3872. '&spades;' => '&#9824;',
  3873. '&clubs;' => '&#9827;',
  3874. '&hearts;' => '&#9829;',
  3875. '&diams;' => '&#9830;',
  3876. );
  3877. return str_replace( array_keys( $to_ncr ), array_values( $to_ncr ), $text );
  3878. }
  3879. /**
  3880. * Formats text for the editor.
  3881. *
  3882. * Generally the browsers treat everything inside a textarea as text, but
  3883. * it is still a good idea to HTML entity encode `<`, `>` and `&` in the content.
  3884. *
  3885. * The filter {@see 'format_for_editor'} is applied here. If `$text` is empty the
  3886. * filter will be applied to an empty string.
  3887. *
  3888. * @since 4.3.0
  3889. *
  3890. * @see _WP_Editors::editor()
  3891. *
  3892. * @param string $text The text to be formatted.
  3893. * @param string $default_editor The default editor for the current user.
  3894. * It is usually either 'html' or 'tinymce'.
  3895. * @return string The formatted text after filter is applied.
  3896. */
  3897. function format_for_editor( $text, $default_editor = null ) {
  3898. if ( $text ) {
  3899. $text = htmlspecialchars( $text, ENT_NOQUOTES, get_option( 'blog_charset' ) );
  3900. }
  3901. /**
  3902. * Filters the text after it is formatted for the editor.
  3903. *
  3904. * @since 4.3.0
  3905. *
  3906. * @param string $text The formatted text.
  3907. * @param string $default_editor The default editor for the current user.
  3908. * It is usually either 'html' or 'tinymce'.
  3909. */
  3910. return apply_filters( 'format_for_editor', $text, $default_editor );
  3911. }
  3912. /**
  3913. * Perform a deep string replace operation to ensure the values in $search are no longer present
  3914. *
  3915. * Repeats the replacement operation until it no longer replaces anything so as to remove "nested" values
  3916. * e.g. $subject = '%0%0%0DDD', $search ='%0D', $result ='' rather than the '%0%0DD' that
  3917. * str_replace would return
  3918. *
  3919. * @since 2.8.1
  3920. * @access private
  3921. *
  3922. * @param string|array $search The value being searched for, otherwise known as the needle.
  3923. * An array may be used to designate multiple needles.
  3924. * @param string $subject The string being searched and replaced on, otherwise known as the haystack.
  3925. * @return string The string with the replaced values.
  3926. */
  3927. function _deep_replace( $search, $subject ) {
  3928. $subject = (string) $subject;
  3929. $count = 1;
  3930. while ( $count ) {
  3931. $subject = str_replace( $search, '', $subject, $count );
  3932. }
  3933. return $subject;
  3934. }
  3935. /**
  3936. * Escapes data for use in a MySQL query.
  3937. *
  3938. * Usually you should prepare queries using wpdb::prepare().
  3939. * Sometimes, spot-escaping is required or useful. One example
  3940. * is preparing an array for use in an IN clause.
  3941. *
  3942. * NOTE: Since 4.8.3, '%' characters will be replaced with a placeholder string,
  3943. * this prevents certain SQLi attacks from taking place. This change in behaviour
  3944. * may cause issues for code that expects the return value of esc_sql() to be useable
  3945. * for other purposes.
  3946. *
  3947. * @since 2.8.0
  3948. *
  3949. * @global wpdb $wpdb WordPress database abstraction object.
  3950. *
  3951. * @param string|array $data Unescaped data
  3952. * @return string|array Escaped data
  3953. */
  3954. function esc_sql( $data ) {
  3955. global $wpdb;
  3956. return $wpdb->_escape( $data );
  3957. }
  3958. /**
  3959. * Checks and cleans a URL.
  3960. *
  3961. * A number of characters are removed from the URL. If the URL is for displaying
  3962. * (the default behaviour) ampersands are also replaced. The {@see 'clean_url'} filter
  3963. * is applied to the returned cleaned URL.
  3964. *
  3965. * @since 2.8.0
  3966. *
  3967. * @param string $url The URL to be cleaned.
  3968. * @param string[] $protocols Optional. An array of acceptable protocols.
  3969. * Defaults to return value of wp_allowed_protocols().
  3970. * @param string $_context Private. Use esc_url_raw() for database usage.
  3971. * @return string The cleaned URL after the {@see 'clean_url'} filter is applied.
  3972. * An empty string is returned if `$url` specifies a protocol other than
  3973. * those in `$protocols`, or if `$url` contains an empty string.
  3974. */
  3975. function esc_url( $url, $protocols = null, $_context = 'display' ) {
  3976. $original_url = $url;
  3977. if ( '' === $url ) {
  3978. return $url;
  3979. }
  3980. $url = str_replace( ' ', '%20', ltrim( $url ) );
  3981. $url = preg_replace( '|[^a-z0-9-~+_.?#=!&;,/:%@$\|*\'()\[\]\\x80-\\xff]|i', '', $url );
  3982. if ( '' === $url ) {
  3983. return $url;
  3984. }
  3985. if ( 0 !== stripos( $url, 'mailto:' ) ) {
  3986. $strip = array( '%0d', '%0a', '%0D', '%0A' );
  3987. $url = _deep_replace( $strip, $url );
  3988. }
  3989. $url = str_replace( ';//', '://', $url );
  3990. /*
  3991. * If the URL doesn't appear to contain a scheme, we presume
  3992. * it needs http:// prepended (unless it's a relative link
  3993. * starting with /, # or ?, or a PHP file).
  3994. */
  3995. if ( strpos( $url, ':' ) === false && ! in_array( $url[0], array( '/', '#', '?' ), true ) &&
  3996. ! preg_match( '/^[a-z0-9-]+?\.php/i', $url ) ) {
  3997. $url = 'http://' . $url;
  3998. }
  3999. // Replace ampersands and single quotes only when displaying.
  4000. if ( 'display' === $_context ) {
  4001. $url = wp_kses_normalize_entities( $url );
  4002. $url = str_replace( '&amp;', '&#038;', $url );
  4003. $url = str_replace( "'", '&#039;', $url );
  4004. }
  4005. if ( ( false !== strpos( $url, '[' ) ) || ( false !== strpos( $url, ']' ) ) ) {
  4006. $parsed = wp_parse_url( $url );
  4007. $front = '';
  4008. if ( isset( $parsed['scheme'] ) ) {
  4009. $front .= $parsed['scheme'] . '://';
  4010. } elseif ( '/' === $url[0] ) {
  4011. $front .= '//';
  4012. }
  4013. if ( isset( $parsed['user'] ) ) {
  4014. $front .= $parsed['user'];
  4015. }
  4016. if ( isset( $parsed['pass'] ) ) {
  4017. $front .= ':' . $parsed['pass'];
  4018. }
  4019. if ( isset( $parsed['user'] ) || isset( $parsed['pass'] ) ) {
  4020. $front .= '@';
  4021. }
  4022. if ( isset( $parsed['host'] ) ) {
  4023. $front .= $parsed['host'];
  4024. }
  4025. if ( isset( $parsed['port'] ) ) {
  4026. $front .= ':' . $parsed['port'];
  4027. }
  4028. $end_dirty = str_replace( $front, '', $url );
  4029. $end_clean = str_replace( array( '[', ']' ), array( '%5B', '%5D' ), $end_dirty );
  4030. $url = str_replace( $end_dirty, $end_clean, $url );
  4031. }
  4032. if ( '/' === $url[0] ) {
  4033. $good_protocol_url = $url;
  4034. } else {
  4035. if ( ! is_array( $protocols ) ) {
  4036. $protocols = wp_allowed_protocols();
  4037. }
  4038. $good_protocol_url = wp_kses_bad_protocol( $url, $protocols );
  4039. if ( strtolower( $good_protocol_url ) != strtolower( $url ) ) {
  4040. return '';
  4041. }
  4042. }
  4043. /**
  4044. * Filters a string cleaned and escaped for output as a URL.
  4045. *
  4046. * @since 2.3.0
  4047. *
  4048. * @param string $good_protocol_url The cleaned URL to be returned.
  4049. * @param string $original_url The URL prior to cleaning.
  4050. * @param string $_context If 'display', replace ampersands and single quotes only.
  4051. */
  4052. return apply_filters( 'clean_url', $good_protocol_url, $original_url, $_context );
  4053. }
  4054. /**
  4055. * Performs esc_url() for database or redirect usage.
  4056. *
  4057. * @since 2.8.0
  4058. *
  4059. * @see esc_url()
  4060. *
  4061. * @param string $url The URL to be cleaned.
  4062. * @param string[] $protocols Optional. An array of acceptable protocols.
  4063. * Defaults to return value of wp_allowed_protocols().
  4064. * @return string The cleaned URL after esc_url() is run with the 'db' context.
  4065. */
  4066. function esc_url_raw( $url, $protocols = null ) {
  4067. return esc_url( $url, $protocols, 'db' );
  4068. }
  4069. /**
  4070. * Performs esc_url() for database or redirect usage.
  4071. *
  4072. * This function is an alias for esc_url_raw().
  4073. *
  4074. * @since 2.3.1
  4075. * @since 2.8.0 Deprecated in favor of esc_url_raw().
  4076. * @since 5.9.0 Restored (un-deprecated).
  4077. *
  4078. * @see esc_url_raw()
  4079. *
  4080. * @param string $url The URL to be cleaned.
  4081. * @param string[] $protocols Optional. An array of acceptable protocols.
  4082. * Defaults to return value of wp_allowed_protocols().
  4083. * @return string The cleaned URL after esc_url() is run with the 'db' context.
  4084. */
  4085. function sanitize_url( $url, $protocols = null ) {
  4086. return esc_url_raw( $url, $protocols );
  4087. }
  4088. /**
  4089. * Convert entities, while preserving already-encoded entities.
  4090. *
  4091. * @link https://www.php.net/htmlentities Borrowed from the PHP Manual user notes.
  4092. *
  4093. * @since 1.2.2
  4094. *
  4095. * @param string $myHTML The text to be converted.
  4096. * @return string Converted text.
  4097. */
  4098. function htmlentities2( $myHTML ) {
  4099. $translation_table = get_html_translation_table( HTML_ENTITIES, ENT_QUOTES );
  4100. $translation_table[ chr( 38 ) ] = '&';
  4101. return preg_replace( '/&(?![A-Za-z]{0,4}\w{2,3};|#[0-9]{2,3};)/', '&amp;', strtr( $myHTML, $translation_table ) );
  4102. }
  4103. /**
  4104. * Escape single quotes, htmlspecialchar " < > &, and fix line endings.
  4105. *
  4106. * Escapes text strings for echoing in JS. It is intended to be used for inline JS
  4107. * (in a tag attribute, for example onclick="..."). Note that the strings have to
  4108. * be in single quotes. The {@see 'js_escape'} filter is also applied here.
  4109. *
  4110. * @since 2.8.0
  4111. *
  4112. * @param string $text The text to be escaped.
  4113. * @return string Escaped text.
  4114. */
  4115. function esc_js( $text ) {
  4116. $safe_text = wp_check_invalid_utf8( $text );
  4117. $safe_text = _wp_specialchars( $safe_text, ENT_COMPAT );
  4118. $safe_text = preg_replace( '/&#(x)?0*(?(1)27|39);?/i', "'", stripslashes( $safe_text ) );
  4119. $safe_text = str_replace( "\r", '', $safe_text );
  4120. $safe_text = str_replace( "\n", '\\n', addslashes( $safe_text ) );
  4121. /**
  4122. * Filters a string cleaned and escaped for output in JavaScript.
  4123. *
  4124. * Text passed to esc_js() is stripped of invalid or special characters,
  4125. * and properly slashed for output.
  4126. *
  4127. * @since 2.0.6
  4128. *
  4129. * @param string $safe_text The text after it has been escaped.
  4130. * @param string $text The text prior to being escaped.
  4131. */
  4132. return apply_filters( 'js_escape', $safe_text, $text );
  4133. }
  4134. /**
  4135. * Escaping for HTML blocks.
  4136. *
  4137. * @since 2.8.0
  4138. *
  4139. * @param string $text
  4140. * @return string
  4141. */
  4142. function esc_html( $text ) {
  4143. $safe_text = wp_check_invalid_utf8( $text );
  4144. $safe_text = _wp_specialchars( $safe_text, ENT_QUOTES );
  4145. /**
  4146. * Filters a string cleaned and escaped for output in HTML.
  4147. *
  4148. * Text passed to esc_html() is stripped of invalid or special characters
  4149. * before output.
  4150. *
  4151. * @since 2.8.0
  4152. *
  4153. * @param string $safe_text The text after it has been escaped.
  4154. * @param string $text The text prior to being escaped.
  4155. */
  4156. return apply_filters( 'esc_html', $safe_text, $text );
  4157. }
  4158. /**
  4159. * Escaping for HTML attributes.
  4160. *
  4161. * @since 2.8.0
  4162. *
  4163. * @param string $text
  4164. * @return string
  4165. */
  4166. function esc_attr( $text ) {
  4167. $safe_text = wp_check_invalid_utf8( $text );
  4168. $safe_text = _wp_specialchars( $safe_text, ENT_QUOTES );
  4169. /**
  4170. * Filters a string cleaned and escaped for output in an HTML attribute.
  4171. *
  4172. * Text passed to esc_attr() is stripped of invalid or special characters
  4173. * before output.
  4174. *
  4175. * @since 2.0.6
  4176. *
  4177. * @param string $safe_text The text after it has been escaped.
  4178. * @param string $text The text prior to being escaped.
  4179. */
  4180. return apply_filters( 'attribute_escape', $safe_text, $text );
  4181. }
  4182. /**
  4183. * Escaping for textarea values.
  4184. *
  4185. * @since 3.1.0
  4186. *
  4187. * @param string $text
  4188. * @return string
  4189. */
  4190. function esc_textarea( $text ) {
  4191. $safe_text = htmlspecialchars( $text, ENT_QUOTES, get_option( 'blog_charset' ) );
  4192. /**
  4193. * Filters a string cleaned and escaped for output in a textarea element.
  4194. *
  4195. * @since 3.1.0
  4196. *
  4197. * @param string $safe_text The text after it has been escaped.
  4198. * @param string $text The text prior to being escaped.
  4199. */
  4200. return apply_filters( 'esc_textarea', $safe_text, $text );
  4201. }
  4202. /**
  4203. * Escaping for XML blocks.
  4204. *
  4205. * @since 5.5.0
  4206. *
  4207. * @param string $text Text to escape.
  4208. * @return string Escaped text.
  4209. */
  4210. function esc_xml( $text ) {
  4211. $safe_text = wp_check_invalid_utf8( $text );
  4212. $cdata_regex = '\<\!\[CDATA\[.*?\]\]\>';
  4213. $regex = <<<EOF
  4214. /
  4215. (?=.*?{$cdata_regex}) # lookahead that will match anything followed by a CDATA Section
  4216. (?<non_cdata_followed_by_cdata>(.*?)) # the "anything" matched by the lookahead
  4217. (?<cdata>({$cdata_regex})) # the CDATA Section matched by the lookahead
  4218. | # alternative
  4219. (?<non_cdata>(.*)) # non-CDATA Section
  4220. /sx
  4221. EOF;
  4222. $safe_text = (string) preg_replace_callback(
  4223. $regex,
  4224. static function( $matches ) {
  4225. if ( ! $matches[0] ) {
  4226. return '';
  4227. }
  4228. if ( ! empty( $matches['non_cdata'] ) ) {
  4229. // escape HTML entities in the non-CDATA Section.
  4230. return _wp_specialchars( $matches['non_cdata'], ENT_XML1 );
  4231. }
  4232. // Return the CDATA Section unchanged, escape HTML entities in the rest.
  4233. return _wp_specialchars( $matches['non_cdata_followed_by_cdata'], ENT_XML1 ) . $matches['cdata'];
  4234. },
  4235. $safe_text
  4236. );
  4237. /**
  4238. * Filters a string cleaned and escaped for output in XML.
  4239. *
  4240. * Text passed to esc_xml() is stripped of invalid or special characters
  4241. * before output. HTML named character references are converted to their
  4242. * equivalent code points.
  4243. *
  4244. * @since 5.5.0
  4245. *
  4246. * @param string $safe_text The text after it has been escaped.
  4247. * @param string $text The text prior to being escaped.
  4248. */
  4249. return apply_filters( 'esc_xml', $safe_text, $text );
  4250. }
  4251. /**
  4252. * Escape an HTML tag name.
  4253. *
  4254. * @since 2.5.0
  4255. *
  4256. * @param string $tag_name
  4257. * @return string
  4258. */
  4259. function tag_escape( $tag_name ) {
  4260. $safe_tag = strtolower( preg_replace( '/[^a-zA-Z0-9_:]/', '', $tag_name ) );
  4261. /**
  4262. * Filters a string cleaned and escaped for output as an HTML tag.
  4263. *
  4264. * @since 2.8.0
  4265. *
  4266. * @param string $safe_tag The tag name after it has been escaped.
  4267. * @param string $tag_name The text before it was escaped.
  4268. */
  4269. return apply_filters( 'tag_escape', $safe_tag, $tag_name );
  4270. }
  4271. /**
  4272. * Convert full URL paths to absolute paths.
  4273. *
  4274. * Removes the http or https protocols and the domain. Keeps the path '/' at the
  4275. * beginning, so it isn't a true relative link, but from the web root base.
  4276. *
  4277. * @since 2.1.0
  4278. * @since 4.1.0 Support was added for relative URLs.
  4279. *
  4280. * @param string $link Full URL path.
  4281. * @return string Absolute path.
  4282. */
  4283. function wp_make_link_relative( $link ) {
  4284. return preg_replace( '|^(https?:)?//[^/]+(/?.*)|i', '$2', $link );
  4285. }
  4286. /**
  4287. * Sanitizes various option values based on the nature of the option.
  4288. *
  4289. * This is basically a switch statement which will pass $value through a number
  4290. * of functions depending on the $option.
  4291. *
  4292. * @since 2.0.5
  4293. *
  4294. * @global wpdb $wpdb WordPress database abstraction object.
  4295. *
  4296. * @param string $option The name of the option.
  4297. * @param string $value The unsanitised value.
  4298. * @return string Sanitized value.
  4299. */
  4300. function sanitize_option( $option, $value ) {
  4301. global $wpdb;
  4302. $original_value = $value;
  4303. $error = null;
  4304. switch ( $option ) {
  4305. case 'admin_email':
  4306. case 'new_admin_email':
  4307. $value = $wpdb->strip_invalid_text_for_column( $wpdb->options, 'option_value', $value );
  4308. if ( is_wp_error( $value ) ) {
  4309. $error = $value->get_error_message();
  4310. } else {
  4311. $value = sanitize_email( $value );
  4312. if ( ! is_email( $value ) ) {
  4313. $error = __( 'The email address entered did not appear to be a valid email address. Please enter a valid email address.' );
  4314. }
  4315. }
  4316. break;
  4317. case 'thumbnail_size_w':
  4318. case 'thumbnail_size_h':
  4319. case 'medium_size_w':
  4320. case 'medium_size_h':
  4321. case 'medium_large_size_w':
  4322. case 'medium_large_size_h':
  4323. case 'large_size_w':
  4324. case 'large_size_h':
  4325. case 'mailserver_port':
  4326. case 'comment_max_links':
  4327. case 'page_on_front':
  4328. case 'page_for_posts':
  4329. case 'rss_excerpt_length':
  4330. case 'default_category':
  4331. case 'default_email_category':
  4332. case 'default_link_category':
  4333. case 'close_comments_days_old':
  4334. case 'comments_per_page':
  4335. case 'thread_comments_depth':
  4336. case 'users_can_register':
  4337. case 'start_of_week':
  4338. case 'site_icon':
  4339. $value = absint( $value );
  4340. break;
  4341. case 'posts_per_page':
  4342. case 'posts_per_rss':
  4343. $value = (int) $value;
  4344. if ( empty( $value ) ) {
  4345. $value = 1;
  4346. }
  4347. if ( $value < -1 ) {
  4348. $value = abs( $value );
  4349. }
  4350. break;
  4351. case 'default_ping_status':
  4352. case 'default_comment_status':
  4353. // Options that if not there have 0 value but need to be something like "closed".
  4354. if ( '0' == $value || '' === $value ) {
  4355. $value = 'closed';
  4356. }
  4357. break;
  4358. case 'blogdescription':
  4359. case 'blogname':
  4360. $value = $wpdb->strip_invalid_text_for_column( $wpdb->options, 'option_value', $value );
  4361. if ( $value !== $original_value ) {
  4362. $value = $wpdb->strip_invalid_text_for_column( $wpdb->options, 'option_value', wp_encode_emoji( $original_value ) );
  4363. }
  4364. if ( is_wp_error( $value ) ) {
  4365. $error = $value->get_error_message();
  4366. } else {
  4367. $value = esc_html( $value );
  4368. }
  4369. break;
  4370. case 'blog_charset':
  4371. $value = preg_replace( '/[^a-zA-Z0-9_-]/', '', $value ); // Strips slashes.
  4372. break;
  4373. case 'blog_public':
  4374. // This is the value if the settings checkbox is not checked on POST. Don't rely on this.
  4375. if ( null === $value ) {
  4376. $value = 1;
  4377. } else {
  4378. $value = (int) $value;
  4379. }
  4380. break;
  4381. case 'date_format':
  4382. case 'time_format':
  4383. case 'mailserver_url':
  4384. case 'mailserver_login':
  4385. case 'mailserver_pass':
  4386. case 'upload_path':
  4387. $value = $wpdb->strip_invalid_text_for_column( $wpdb->options, 'option_value', $value );
  4388. if ( is_wp_error( $value ) ) {
  4389. $error = $value->get_error_message();
  4390. } else {
  4391. $value = strip_tags( $value );
  4392. $value = wp_kses_data( $value );
  4393. }
  4394. break;
  4395. case 'ping_sites':
  4396. $value = explode( "\n", $value );
  4397. $value = array_filter( array_map( 'trim', $value ) );
  4398. $value = array_filter( array_map( 'esc_url_raw', $value ) );
  4399. $value = implode( "\n", $value );
  4400. break;
  4401. case 'gmt_offset':
  4402. $value = preg_replace( '/[^0-9:.-]/', '', $value ); // Strips slashes.
  4403. break;
  4404. case 'siteurl':
  4405. $value = $wpdb->strip_invalid_text_for_column( $wpdb->options, 'option_value', $value );
  4406. if ( is_wp_error( $value ) ) {
  4407. $error = $value->get_error_message();
  4408. } else {
  4409. if ( preg_match( '#http(s?)://(.+)#i', $value ) ) {
  4410. $value = esc_url_raw( $value );
  4411. } else {
  4412. $error = __( 'The WordPress address you entered did not appear to be a valid URL. Please enter a valid URL.' );
  4413. }
  4414. }
  4415. break;
  4416. case 'home':
  4417. $value = $wpdb->strip_invalid_text_for_column( $wpdb->options, 'option_value', $value );
  4418. if ( is_wp_error( $value ) ) {
  4419. $error = $value->get_error_message();
  4420. } else {
  4421. if ( preg_match( '#http(s?)://(.+)#i', $value ) ) {
  4422. $value = esc_url_raw( $value );
  4423. } else {
  4424. $error = __( 'The Site address you entered did not appear to be a valid URL. Please enter a valid URL.' );
  4425. }
  4426. }
  4427. break;
  4428. case 'WPLANG':
  4429. $allowed = get_available_languages();
  4430. if ( ! is_multisite() && defined( 'WPLANG' ) && '' !== WPLANG && 'en_US' !== WPLANG ) {
  4431. $allowed[] = WPLANG;
  4432. }
  4433. if ( ! in_array( $value, $allowed, true ) && ! empty( $value ) ) {
  4434. $value = get_option( $option );
  4435. }
  4436. break;
  4437. case 'illegal_names':
  4438. $value = $wpdb->strip_invalid_text_for_column( $wpdb->options, 'option_value', $value );
  4439. if ( is_wp_error( $value ) ) {
  4440. $error = $value->get_error_message();
  4441. } else {
  4442. if ( ! is_array( $value ) ) {
  4443. $value = explode( ' ', $value );
  4444. }
  4445. $value = array_values( array_filter( array_map( 'trim', $value ) ) );
  4446. if ( ! $value ) {
  4447. $value = '';
  4448. }
  4449. }
  4450. break;
  4451. case 'limited_email_domains':
  4452. case 'banned_email_domains':
  4453. $value = $wpdb->strip_invalid_text_for_column( $wpdb->options, 'option_value', $value );
  4454. if ( is_wp_error( $value ) ) {
  4455. $error = $value->get_error_message();
  4456. } else {
  4457. if ( ! is_array( $value ) ) {
  4458. $value = explode( "\n", $value );
  4459. }
  4460. $domains = array_values( array_filter( array_map( 'trim', $value ) ) );
  4461. $value = array();
  4462. foreach ( $domains as $domain ) {
  4463. if ( ! preg_match( '/(--|\.\.)/', $domain ) && preg_match( '|^([a-zA-Z0-9-\.])+$|', $domain ) ) {
  4464. $value[] = $domain;
  4465. }
  4466. }
  4467. if ( ! $value ) {
  4468. $value = '';
  4469. }
  4470. }
  4471. break;
  4472. case 'timezone_string':
  4473. $allowed_zones = timezone_identifiers_list();
  4474. if ( ! in_array( $value, $allowed_zones, true ) && ! empty( $value ) ) {
  4475. $error = __( 'The timezone you have entered is not valid. Please select a valid timezone.' );
  4476. }
  4477. break;
  4478. case 'permalink_structure':
  4479. case 'category_base':
  4480. case 'tag_base':
  4481. $value = $wpdb->strip_invalid_text_for_column( $wpdb->options, 'option_value', $value );
  4482. if ( is_wp_error( $value ) ) {
  4483. $error = $value->get_error_message();
  4484. } else {
  4485. $value = esc_url_raw( $value );
  4486. $value = str_replace( 'http://', '', $value );
  4487. }
  4488. if ( 'permalink_structure' === $option && null === $error
  4489. && '' !== $value && ! preg_match( '/%[^\/%]+%/', $value )
  4490. ) {
  4491. $error = sprintf(
  4492. /* translators: %s: Documentation URL. */
  4493. __( 'A structure tag is required when using custom permalinks. <a href="%s">Learn more</a>' ),
  4494. __( 'https://wordpress.org/support/article/using-permalinks/#choosing-your-permalink-structure' )
  4495. );
  4496. }
  4497. break;
  4498. case 'default_role':
  4499. if ( ! get_role( $value ) && get_role( 'subscriber' ) ) {
  4500. $value = 'subscriber';
  4501. }
  4502. break;
  4503. case 'moderation_keys':
  4504. case 'disallowed_keys':
  4505. $value = $wpdb->strip_invalid_text_for_column( $wpdb->options, 'option_value', $value );
  4506. if ( is_wp_error( $value ) ) {
  4507. $error = $value->get_error_message();
  4508. } else {
  4509. $value = explode( "\n", $value );
  4510. $value = array_filter( array_map( 'trim', $value ) );
  4511. $value = array_unique( $value );
  4512. $value = implode( "\n", $value );
  4513. }
  4514. break;
  4515. }
  4516. if ( null !== $error ) {
  4517. if ( '' === $error && is_wp_error( $value ) ) {
  4518. /* translators: 1: Option name, 2: Error code. */
  4519. $error = sprintf( __( 'Could not sanitize the %1$s option. Error code: %2$s' ), $option, $value->get_error_code() );
  4520. }
  4521. $value = get_option( $option );
  4522. if ( function_exists( 'add_settings_error' ) ) {
  4523. add_settings_error( $option, "invalid_{$option}", $error );
  4524. }
  4525. }
  4526. /**
  4527. * Filters an option value following sanitization.
  4528. *
  4529. * @since 2.3.0
  4530. * @since 4.3.0 Added the `$original_value` parameter.
  4531. *
  4532. * @param string $value The sanitized option value.
  4533. * @param string $option The option name.
  4534. * @param string $original_value The original value passed to the function.
  4535. */
  4536. return apply_filters( "sanitize_option_{$option}", $value, $option, $original_value );
  4537. }
  4538. /**
  4539. * Maps a function to all non-iterable elements of an array or an object.
  4540. *
  4541. * This is similar to `array_walk_recursive()` but acts upon objects too.
  4542. *
  4543. * @since 4.4.0
  4544. *
  4545. * @param mixed $value The array, object, or scalar.
  4546. * @param callable $callback The function to map onto $value.
  4547. * @return mixed The value with the callback applied to all non-arrays and non-objects inside it.
  4548. */
  4549. function map_deep( $value, $callback ) {
  4550. if ( is_array( $value ) ) {
  4551. foreach ( $value as $index => $item ) {
  4552. $value[ $index ] = map_deep( $item, $callback );
  4553. }
  4554. } elseif ( is_object( $value ) ) {
  4555. $object_vars = get_object_vars( $value );
  4556. foreach ( $object_vars as $property_name => $property_value ) {
  4557. $value->$property_name = map_deep( $property_value, $callback );
  4558. }
  4559. } else {
  4560. $value = call_user_func( $callback, $value );
  4561. }
  4562. return $value;
  4563. }
  4564. /**
  4565. * Parses a string into variables to be stored in an array.
  4566. *
  4567. * @since 2.2.1
  4568. *
  4569. * @param string $string The string to be parsed.
  4570. * @param array $array Variables will be stored in this array.
  4571. */
  4572. function wp_parse_str( $string, &$array ) {
  4573. parse_str( (string) $string, $array );
  4574. /**
  4575. * Filters the array of variables derived from a parsed string.
  4576. *
  4577. * @since 2.2.1
  4578. *
  4579. * @param array $array The array populated with variables.
  4580. */
  4581. $array = apply_filters( 'wp_parse_str', $array );
  4582. }
  4583. /**
  4584. * Convert lone less than signs.
  4585. *
  4586. * KSES already converts lone greater than signs.
  4587. *
  4588. * @since 2.3.0
  4589. *
  4590. * @param string $text Text to be converted.
  4591. * @return string Converted text.
  4592. */
  4593. function wp_pre_kses_less_than( $text ) {
  4594. return preg_replace_callback( '%<[^>]*?((?=<)|>|$)%', 'wp_pre_kses_less_than_callback', $text );
  4595. }
  4596. /**
  4597. * Callback function used by preg_replace.
  4598. *
  4599. * @since 2.3.0
  4600. *
  4601. * @param string[] $matches Populated by matches to preg_replace.
  4602. * @return string The text returned after esc_html if needed.
  4603. */
  4604. function wp_pre_kses_less_than_callback( $matches ) {
  4605. if ( false === strpos( $matches[0], '>' ) ) {
  4606. return esc_html( $matches[0] );
  4607. }
  4608. return $matches[0];
  4609. }
  4610. /**
  4611. * Remove non-allowable HTML from parsed block attribute values when filtering
  4612. * in the post context.
  4613. *
  4614. * @since 5.3.1
  4615. *
  4616. * @param string $string Content to be run through KSES.
  4617. * @param array[]|string $allowed_html An array of allowed HTML elements
  4618. * and attributes, or a context name
  4619. * such as 'post'.
  4620. * @param string[] $allowed_protocols Array of allowed URL protocols.
  4621. * @return string Filtered text to run through KSES.
  4622. */
  4623. function wp_pre_kses_block_attributes( $string, $allowed_html, $allowed_protocols ) {
  4624. /*
  4625. * `filter_block_content` is expected to call `wp_kses`. Temporarily remove
  4626. * the filter to avoid recursion.
  4627. */
  4628. remove_filter( 'pre_kses', 'wp_pre_kses_block_attributes', 10 );
  4629. $string = filter_block_content( $string, $allowed_html, $allowed_protocols );
  4630. add_filter( 'pre_kses', 'wp_pre_kses_block_attributes', 10, 3 );
  4631. return $string;
  4632. }
  4633. /**
  4634. * WordPress implementation of PHP sprintf() with filters.
  4635. *
  4636. * @since 2.5.0
  4637. * @since 5.3.0 Formalized the existing and already documented `...$args` parameter
  4638. * by adding it to the function signature.
  4639. *
  4640. * @link https://www.php.net/sprintf
  4641. *
  4642. * @param string $pattern The string which formatted args are inserted.
  4643. * @param mixed ...$args Arguments to be formatted into the $pattern string.
  4644. * @return string The formatted string.
  4645. */
  4646. function wp_sprintf( $pattern, ...$args ) {
  4647. $len = strlen( $pattern );
  4648. $start = 0;
  4649. $result = '';
  4650. $arg_index = 0;
  4651. while ( $len > $start ) {
  4652. // Last character: append and break.
  4653. if ( strlen( $pattern ) - 1 == $start ) {
  4654. $result .= substr( $pattern, -1 );
  4655. break;
  4656. }
  4657. // Literal %: append and continue.
  4658. if ( '%%' === substr( $pattern, $start, 2 ) ) {
  4659. $start += 2;
  4660. $result .= '%';
  4661. continue;
  4662. }
  4663. // Get fragment before next %.
  4664. $end = strpos( $pattern, '%', $start + 1 );
  4665. if ( false === $end ) {
  4666. $end = $len;
  4667. }
  4668. $fragment = substr( $pattern, $start, $end - $start );
  4669. // Fragment has a specifier.
  4670. if ( '%' === $pattern[ $start ] ) {
  4671. // Find numbered arguments or take the next one in order.
  4672. if ( preg_match( '/^%(\d+)\$/', $fragment, $matches ) ) {
  4673. $index = $matches[1] - 1; // 0-based array vs 1-based sprintf() arguments.
  4674. $arg = isset( $args[ $index ] ) ? $args[ $index ] : '';
  4675. $fragment = str_replace( "%{$matches[1]}$", '%', $fragment );
  4676. } else {
  4677. $arg = isset( $args[ $arg_index ] ) ? $args[ $arg_index ] : '';
  4678. ++$arg_index;
  4679. }
  4680. /**
  4681. * Filters a fragment from the pattern passed to wp_sprintf().
  4682. *
  4683. * If the fragment is unchanged, then sprintf() will be run on the fragment.
  4684. *
  4685. * @since 2.5.0
  4686. *
  4687. * @param string $fragment A fragment from the pattern.
  4688. * @param string $arg The argument.
  4689. */
  4690. $_fragment = apply_filters( 'wp_sprintf', $fragment, $arg );
  4691. if ( $_fragment != $fragment ) {
  4692. $fragment = $_fragment;
  4693. } else {
  4694. $fragment = sprintf( $fragment, (string) $arg );
  4695. }
  4696. }
  4697. // Append to result and move to next fragment.
  4698. $result .= $fragment;
  4699. $start = $end;
  4700. }
  4701. return $result;
  4702. }
  4703. /**
  4704. * Localize list items before the rest of the content.
  4705. *
  4706. * The '%l' must be at the first characters can then contain the rest of the
  4707. * content. The list items will have ', ', ', and', and ' and ' added depending
  4708. * on the amount of list items in the $args parameter.
  4709. *
  4710. * @since 2.5.0
  4711. *
  4712. * @param string $pattern Content containing '%l' at the beginning.
  4713. * @param array $args List items to prepend to the content and replace '%l'.
  4714. * @return string Localized list items and rest of the content.
  4715. */
  4716. function wp_sprintf_l( $pattern, $args ) {
  4717. // Not a match.
  4718. if ( '%l' !== substr( $pattern, 0, 2 ) ) {
  4719. return $pattern;
  4720. }
  4721. // Nothing to work with.
  4722. if ( empty( $args ) ) {
  4723. return '';
  4724. }
  4725. /**
  4726. * Filters the translated delimiters used by wp_sprintf_l().
  4727. * Placeholders (%s) are included to assist translators and then
  4728. * removed before the array of strings reaches the filter.
  4729. *
  4730. * Please note: Ampersands and entities should be avoided here.
  4731. *
  4732. * @since 2.5.0
  4733. *
  4734. * @param array $delimiters An array of translated delimiters.
  4735. */
  4736. $l = apply_filters(
  4737. 'wp_sprintf_l',
  4738. array(
  4739. /* translators: Used to join items in a list with more than 2 items. */
  4740. 'between' => sprintf( __( '%1$s, %2$s' ), '', '' ),
  4741. /* translators: Used to join last two items in a list with more than 2 times. */
  4742. 'between_last_two' => sprintf( __( '%1$s, and %2$s' ), '', '' ),
  4743. /* translators: Used to join items in a list with only 2 items. */
  4744. 'between_only_two' => sprintf( __( '%1$s and %2$s' ), '', '' ),
  4745. )
  4746. );
  4747. $args = (array) $args;
  4748. $result = array_shift( $args );
  4749. if ( count( $args ) == 1 ) {
  4750. $result .= $l['between_only_two'] . array_shift( $args );
  4751. }
  4752. // Loop when more than two args.
  4753. $i = count( $args );
  4754. while ( $i ) {
  4755. $arg = array_shift( $args );
  4756. $i--;
  4757. if ( 0 == $i ) {
  4758. $result .= $l['between_last_two'] . $arg;
  4759. } else {
  4760. $result .= $l['between'] . $arg;
  4761. }
  4762. }
  4763. return $result . substr( $pattern, 2 );
  4764. }
  4765. /**
  4766. * Safely extracts not more than the first $count characters from HTML string.
  4767. *
  4768. * UTF-8, tags and entities safe prefix extraction. Entities inside will *NOT*
  4769. * be counted as one character. For example &amp; will be counted as 4, &lt; as
  4770. * 3, etc.
  4771. *
  4772. * @since 2.5.0
  4773. *
  4774. * @param string $str String to get the excerpt from.
  4775. * @param int $count Maximum number of characters to take.
  4776. * @param string $more Optional. What to append if $str needs to be trimmed. Defaults to empty string.
  4777. * @return string The excerpt.
  4778. */
  4779. function wp_html_excerpt( $str, $count, $more = null ) {
  4780. if ( null === $more ) {
  4781. $more = '';
  4782. }
  4783. $str = wp_strip_all_tags( $str, true );
  4784. $excerpt = mb_substr( $str, 0, $count );
  4785. // Remove part of an entity at the end.
  4786. $excerpt = preg_replace( '/&[^;\s]{0,6}$/', '', $excerpt );
  4787. if ( $str != $excerpt ) {
  4788. $excerpt = trim( $excerpt ) . $more;
  4789. }
  4790. return $excerpt;
  4791. }
  4792. /**
  4793. * Add a Base url to relative links in passed content.
  4794. *
  4795. * By default it supports the 'src' and 'href' attributes. However this can be
  4796. * changed via the 3rd param.
  4797. *
  4798. * @since 2.7.0
  4799. *
  4800. * @global string $_links_add_base
  4801. *
  4802. * @param string $content String to search for links in.
  4803. * @param string $base The base URL to prefix to links.
  4804. * @param array $attrs The attributes which should be processed.
  4805. * @return string The processed content.
  4806. */
  4807. function links_add_base_url( $content, $base, $attrs = array( 'src', 'href' ) ) {
  4808. global $_links_add_base;
  4809. $_links_add_base = $base;
  4810. $attrs = implode( '|', (array) $attrs );
  4811. return preg_replace_callback( "!($attrs)=(['\"])(.+?)\\2!i", '_links_add_base', $content );
  4812. }
  4813. /**
  4814. * Callback to add a base url to relative links in passed content.
  4815. *
  4816. * @since 2.7.0
  4817. * @access private
  4818. *
  4819. * @global string $_links_add_base
  4820. *
  4821. * @param string $m The matched link.
  4822. * @return string The processed link.
  4823. */
  4824. function _links_add_base( $m ) {
  4825. global $_links_add_base;
  4826. // 1 = attribute name 2 = quotation mark 3 = URL.
  4827. return $m[1] . '=' . $m[2] .
  4828. ( preg_match( '#^(\w{1,20}):#', $m[3], $protocol ) && in_array( $protocol[1], wp_allowed_protocols(), true ) ?
  4829. $m[3] :
  4830. WP_Http::make_absolute_url( $m[3], $_links_add_base )
  4831. )
  4832. . $m[2];
  4833. }
  4834. /**
  4835. * Adds a Target attribute to all links in passed content.
  4836. *
  4837. * This function by default only applies to `<a>` tags, however this can be
  4838. * modified by the 3rd param.
  4839. *
  4840. * *NOTE:* Any current target attributed will be stripped and replaced.
  4841. *
  4842. * @since 2.7.0
  4843. *
  4844. * @global string $_links_add_target
  4845. *
  4846. * @param string $content String to search for links in.
  4847. * @param string $target The Target to add to the links.
  4848. * @param string[] $tags An array of tags to apply to.
  4849. * @return string The processed content.
  4850. */
  4851. function links_add_target( $content, $target = '_blank', $tags = array( 'a' ) ) {
  4852. global $_links_add_target;
  4853. $_links_add_target = $target;
  4854. $tags = implode( '|', (array) $tags );
  4855. return preg_replace_callback( "!<($tags)((\s[^>]*)?)>!i", '_links_add_target', $content );
  4856. }
  4857. /**
  4858. * Callback to add a target attribute to all links in passed content.
  4859. *
  4860. * @since 2.7.0
  4861. * @access private
  4862. *
  4863. * @global string $_links_add_target
  4864. *
  4865. * @param string $m The matched link.
  4866. * @return string The processed link.
  4867. */
  4868. function _links_add_target( $m ) {
  4869. global $_links_add_target;
  4870. $tag = $m[1];
  4871. $link = preg_replace( '|( target=([\'"])(.*?)\2)|i', '', $m[2] );
  4872. return '<' . $tag . $link . ' target="' . esc_attr( $_links_add_target ) . '">';
  4873. }
  4874. /**
  4875. * Normalize EOL characters and strip duplicate whitespace.
  4876. *
  4877. * @since 2.7.0
  4878. *
  4879. * @param string $str The string to normalize.
  4880. * @return string The normalized string.
  4881. */
  4882. function normalize_whitespace( $str ) {
  4883. $str = trim( $str );
  4884. $str = str_replace( "\r", "\n", $str );
  4885. $str = preg_replace( array( '/\n+/', '/[ \t]+/' ), array( "\n", ' ' ), $str );
  4886. return $str;
  4887. }
  4888. /**
  4889. * Properly strip all HTML tags including script and style
  4890. *
  4891. * This differs from strip_tags() because it removes the contents of
  4892. * the `<script>` and `<style>` tags. E.g. `strip_tags( '<script>something</script>' )`
  4893. * will return 'something'. wp_strip_all_tags will return ''
  4894. *
  4895. * @since 2.9.0
  4896. *
  4897. * @param string $string String containing HTML tags
  4898. * @param bool $remove_breaks Optional. Whether to remove left over line breaks and white space chars
  4899. * @return string The processed string.
  4900. */
  4901. function wp_strip_all_tags( $string, $remove_breaks = false ) {
  4902. $string = preg_replace( '@<(script|style)[^>]*?>.*?</\\1>@si', '', $string );
  4903. $string = strip_tags( $string );
  4904. if ( $remove_breaks ) {
  4905. $string = preg_replace( '/[\r\n\t ]+/', ' ', $string );
  4906. }
  4907. return trim( $string );
  4908. }
  4909. /**
  4910. * Sanitizes a string from user input or from the database.
  4911. *
  4912. * - Checks for invalid UTF-8,
  4913. * - Converts single `<` characters to entities
  4914. * - Strips all tags
  4915. * - Removes line breaks, tabs, and extra whitespace
  4916. * - Strips octets
  4917. *
  4918. * @since 2.9.0
  4919. *
  4920. * @see sanitize_textarea_field()
  4921. * @see wp_check_invalid_utf8()
  4922. * @see wp_strip_all_tags()
  4923. *
  4924. * @param string $str String to sanitize.
  4925. * @return string Sanitized string.
  4926. */
  4927. function sanitize_text_field( $str ) {
  4928. $filtered = _sanitize_text_fields( $str, false );
  4929. /**
  4930. * Filters a sanitized text field string.
  4931. *
  4932. * @since 2.9.0
  4933. *
  4934. * @param string $filtered The sanitized string.
  4935. * @param string $str The string prior to being sanitized.
  4936. */
  4937. return apply_filters( 'sanitize_text_field', $filtered, $str );
  4938. }
  4939. /**
  4940. * Sanitizes a multiline string from user input or from the database.
  4941. *
  4942. * The function is like sanitize_text_field(), but preserves
  4943. * new lines (\n) and other whitespace, which are legitimate
  4944. * input in textarea elements.
  4945. *
  4946. * @see sanitize_text_field()
  4947. *
  4948. * @since 4.7.0
  4949. *
  4950. * @param string $str String to sanitize.
  4951. * @return string Sanitized string.
  4952. */
  4953. function sanitize_textarea_field( $str ) {
  4954. $filtered = _sanitize_text_fields( $str, true );
  4955. /**
  4956. * Filters a sanitized textarea field string.
  4957. *
  4958. * @since 4.7.0
  4959. *
  4960. * @param string $filtered The sanitized string.
  4961. * @param string $str The string prior to being sanitized.
  4962. */
  4963. return apply_filters( 'sanitize_textarea_field', $filtered, $str );
  4964. }
  4965. /**
  4966. * Internal helper function to sanitize a string from user input or from the db
  4967. *
  4968. * @since 4.7.0
  4969. * @access private
  4970. *
  4971. * @param string $str String to sanitize.
  4972. * @param bool $keep_newlines Optional. Whether to keep newlines. Default: false.
  4973. * @return string Sanitized string.
  4974. */
  4975. function _sanitize_text_fields( $str, $keep_newlines = false ) {
  4976. if ( is_object( $str ) || is_array( $str ) ) {
  4977. return '';
  4978. }
  4979. $str = (string) $str;
  4980. $filtered = wp_check_invalid_utf8( $str );
  4981. if ( strpos( $filtered, '<' ) !== false ) {
  4982. $filtered = wp_pre_kses_less_than( $filtered );
  4983. // This will strip extra whitespace for us.
  4984. $filtered = wp_strip_all_tags( $filtered, false );
  4985. // Use HTML entities in a special case to make sure no later
  4986. // newline stripping stage could lead to a functional tag.
  4987. $filtered = str_replace( "<\n", "&lt;\n", $filtered );
  4988. }
  4989. if ( ! $keep_newlines ) {
  4990. $filtered = preg_replace( '/[\r\n\t ]+/', ' ', $filtered );
  4991. }
  4992. $filtered = trim( $filtered );
  4993. $found = false;
  4994. while ( preg_match( '/%[a-f0-9]{2}/i', $filtered, $match ) ) {
  4995. $filtered = str_replace( $match[0], '', $filtered );
  4996. $found = true;
  4997. }
  4998. if ( $found ) {
  4999. // Strip out the whitespace that may now exist after removing the octets.
  5000. $filtered = trim( preg_replace( '/ +/', ' ', $filtered ) );
  5001. }
  5002. return $filtered;
  5003. }
  5004. /**
  5005. * i18n friendly version of basename()
  5006. *
  5007. * @since 3.1.0
  5008. *
  5009. * @param string $path A path.
  5010. * @param string $suffix If the filename ends in suffix this will also be cut off.
  5011. * @return string
  5012. */
  5013. function wp_basename( $path, $suffix = '' ) {
  5014. return urldecode( basename( str_replace( array( '%2F', '%5C' ), '/', urlencode( $path ) ), $suffix ) );
  5015. }
  5016. // phpcs:disable WordPress.WP.CapitalPDangit.Misspelled, WordPress.NamingConventions.ValidFunctionName.FunctionNameInvalid -- 8-)
  5017. /**
  5018. * Forever eliminate "Wordpress" from the planet (or at least the little bit we can influence).
  5019. *
  5020. * Violating our coding standards for a good function name.
  5021. *
  5022. * @since 3.0.0
  5023. *
  5024. * @param string $text The text to be modified.
  5025. * @return string The modified text.
  5026. */
  5027. function capital_P_dangit( $text ) {
  5028. // Simple replacement for titles.
  5029. $current_filter = current_filter();
  5030. if ( 'the_title' === $current_filter || 'wp_title' === $current_filter ) {
  5031. return str_replace( 'Wordpress', 'WordPress', $text );
  5032. }
  5033. // Still here? Use the more judicious replacement.
  5034. static $dblq = false;
  5035. if ( false === $dblq ) {
  5036. $dblq = _x( '&#8220;', 'opening curly double quote' );
  5037. }
  5038. return str_replace(
  5039. array( ' Wordpress', '&#8216;Wordpress', $dblq . 'Wordpress', '>Wordpress', '(Wordpress' ),
  5040. array( ' WordPress', '&#8216;WordPress', $dblq . 'WordPress', '>WordPress', '(WordPress' ),
  5041. $text
  5042. );
  5043. }
  5044. // phpcs:enable
  5045. /**
  5046. * Sanitize a mime type
  5047. *
  5048. * @since 3.1.3
  5049. *
  5050. * @param string $mime_type Mime type
  5051. * @return string Sanitized mime type
  5052. */
  5053. function sanitize_mime_type( $mime_type ) {
  5054. $sani_mime_type = preg_replace( '/[^-+*.a-zA-Z0-9\/]/', '', $mime_type );
  5055. /**
  5056. * Filters a mime type following sanitization.
  5057. *
  5058. * @since 3.1.3
  5059. *
  5060. * @param string $sani_mime_type The sanitized mime type.
  5061. * @param string $mime_type The mime type prior to sanitization.
  5062. */
  5063. return apply_filters( 'sanitize_mime_type', $sani_mime_type, $mime_type );
  5064. }
  5065. /**
  5066. * Sanitize space or carriage return separated URLs that are used to send trackbacks.
  5067. *
  5068. * @since 3.4.0
  5069. *
  5070. * @param string $to_ping Space or carriage return separated URLs
  5071. * @return string URLs starting with the http or https protocol, separated by a carriage return.
  5072. */
  5073. function sanitize_trackback_urls( $to_ping ) {
  5074. $urls_to_ping = preg_split( '/[\r\n\t ]/', trim( $to_ping ), -1, PREG_SPLIT_NO_EMPTY );
  5075. foreach ( $urls_to_ping as $k => $url ) {
  5076. if ( ! preg_match( '#^https?://.#i', $url ) ) {
  5077. unset( $urls_to_ping[ $k ] );
  5078. }
  5079. }
  5080. $urls_to_ping = array_map( 'esc_url_raw', $urls_to_ping );
  5081. $urls_to_ping = implode( "\n", $urls_to_ping );
  5082. /**
  5083. * Filters a list of trackback URLs following sanitization.
  5084. *
  5085. * The string returned here consists of a space or carriage return-delimited list
  5086. * of trackback URLs.
  5087. *
  5088. * @since 3.4.0
  5089. *
  5090. * @param string $urls_to_ping Sanitized space or carriage return separated URLs.
  5091. * @param string $to_ping Space or carriage return separated URLs before sanitization.
  5092. */
  5093. return apply_filters( 'sanitize_trackback_urls', $urls_to_ping, $to_ping );
  5094. }
  5095. /**
  5096. * Adds slashes to a string or recursively adds slashes to strings within an array.
  5097. *
  5098. * This should be used when preparing data for core API that expects slashed data.
  5099. * This should not be used to escape data going directly into an SQL query.
  5100. *
  5101. * @since 3.6.0
  5102. * @since 5.5.0 Non-string values are left untouched.
  5103. *
  5104. * @param string|array $value String or array of data to slash.
  5105. * @return string|array Slashed `$value`.
  5106. */
  5107. function wp_slash( $value ) {
  5108. if ( is_array( $value ) ) {
  5109. $value = array_map( 'wp_slash', $value );
  5110. }
  5111. if ( is_string( $value ) ) {
  5112. return addslashes( $value );
  5113. }
  5114. return $value;
  5115. }
  5116. /**
  5117. * Removes slashes from a string or recursively removes slashes from strings within an array.
  5118. *
  5119. * This should be used to remove slashes from data passed to core API that
  5120. * expects data to be unslashed.
  5121. *
  5122. * @since 3.6.0
  5123. *
  5124. * @param string|array $value String or array of data to unslash.
  5125. * @return string|array Unslashed `$value`.
  5126. */
  5127. function wp_unslash( $value ) {
  5128. return stripslashes_deep( $value );
  5129. }
  5130. /**
  5131. * Extract and return the first URL from passed content.
  5132. *
  5133. * @since 3.6.0
  5134. *
  5135. * @param string $content A string which might contain a URL.
  5136. * @return string|false The found URL.
  5137. */
  5138. function get_url_in_content( $content ) {
  5139. if ( empty( $content ) ) {
  5140. return false;
  5141. }
  5142. if ( preg_match( '/<a\s[^>]*?href=([\'"])(.+?)\1/is', $content, $matches ) ) {
  5143. return esc_url_raw( $matches[2] );
  5144. }
  5145. return false;
  5146. }
  5147. /**
  5148. * Returns the regexp for common whitespace characters.
  5149. *
  5150. * By default, spaces include new lines, tabs, nbsp entities, and the UTF-8 nbsp.
  5151. * This is designed to replace the PCRE \s sequence. In ticket #22692, that
  5152. * sequence was found to be unreliable due to random inclusion of the A0 byte.
  5153. *
  5154. * @since 4.0.0
  5155. *
  5156. * @return string The spaces regexp.
  5157. */
  5158. function wp_spaces_regexp() {
  5159. static $spaces = '';
  5160. if ( empty( $spaces ) ) {
  5161. /**
  5162. * Filters the regexp for common whitespace characters.
  5163. *
  5164. * This string is substituted for the \s sequence as needed in regular
  5165. * expressions. For websites not written in English, different characters
  5166. * may represent whitespace. For websites not encoded in UTF-8, the 0xC2 0xA0
  5167. * sequence may not be in use.
  5168. *
  5169. * @since 4.0.0
  5170. *
  5171. * @param string $spaces Regexp pattern for matching common whitespace characters.
  5172. */
  5173. $spaces = apply_filters( 'wp_spaces_regexp', '[\r\n\t ]|\xC2\xA0|&nbsp;' );
  5174. }
  5175. return $spaces;
  5176. }
  5177. /**
  5178. * Print the important emoji-related styles.
  5179. *
  5180. * @since 4.2.0
  5181. */
  5182. function print_emoji_styles() {
  5183. static $printed = false;
  5184. if ( $printed ) {
  5185. return;
  5186. }
  5187. $printed = true;
  5188. $type_attr = current_theme_supports( 'html5', 'style' ) ? '' : ' type="text/css"';
  5189. ?>
  5190. <style<?php echo $type_attr; ?>>
  5191. img.wp-smiley,
  5192. img.emoji {
  5193. display: inline !important;
  5194. border: none !important;
  5195. box-shadow: none !important;
  5196. height: 1em !important;
  5197. width: 1em !important;
  5198. margin: 0 0.07em !important;
  5199. vertical-align: -0.1em !important;
  5200. background: none !important;
  5201. padding: 0 !important;
  5202. }
  5203. </style>
  5204. <?php
  5205. }
  5206. /**
  5207. * Print the inline Emoji detection script if it is not already printed.
  5208. *
  5209. * @since 4.2.0
  5210. */
  5211. function print_emoji_detection_script() {
  5212. static $printed = false;
  5213. if ( $printed ) {
  5214. return;
  5215. }
  5216. $printed = true;
  5217. _print_emoji_detection_script();
  5218. }
  5219. /**
  5220. * Prints inline Emoji detection script.
  5221. *
  5222. * @ignore
  5223. * @since 4.6.0
  5224. * @access private
  5225. */
  5226. function _print_emoji_detection_script() {
  5227. $settings = array(
  5228. /**
  5229. * Filters the URL where emoji png images are hosted.
  5230. *
  5231. * @since 4.2.0
  5232. *
  5233. * @param string $url The emoji base URL for png images.
  5234. */
  5235. 'baseUrl' => apply_filters( 'emoji_url', 'https://s.w.org/images/core/emoji/13.1.0/72x72/' ),
  5236. /**
  5237. * Filters the extension of the emoji png files.
  5238. *
  5239. * @since 4.2.0
  5240. *
  5241. * @param string $extension The emoji extension for png files. Default .png.
  5242. */
  5243. 'ext' => apply_filters( 'emoji_ext', '.png' ),
  5244. /**
  5245. * Filters the URL where emoji SVG images are hosted.
  5246. *
  5247. * @since 4.6.0
  5248. *
  5249. * @param string $url The emoji base URL for svg images.
  5250. */
  5251. 'svgUrl' => apply_filters( 'emoji_svg_url', 'https://s.w.org/images/core/emoji/13.1.0/svg/' ),
  5252. /**
  5253. * Filters the extension of the emoji SVG files.
  5254. *
  5255. * @since 4.6.0
  5256. *
  5257. * @param string $extension The emoji extension for svg files. Default .svg.
  5258. */
  5259. 'svgExt' => apply_filters( 'emoji_svg_ext', '.svg' ),
  5260. );
  5261. $version = 'ver=' . get_bloginfo( 'version' );
  5262. if ( SCRIPT_DEBUG ) {
  5263. $settings['source'] = array(
  5264. /** This filter is documented in wp-includes/class.wp-scripts.php */
  5265. 'wpemoji' => apply_filters( 'script_loader_src', includes_url( "js/wp-emoji.js?$version" ), 'wpemoji' ),
  5266. /** This filter is documented in wp-includes/class.wp-scripts.php */
  5267. 'twemoji' => apply_filters( 'script_loader_src', includes_url( "js/twemoji.js?$version" ), 'twemoji' ),
  5268. );
  5269. } else {
  5270. $settings['source'] = array(
  5271. /** This filter is documented in wp-includes/class.wp-scripts.php */
  5272. 'concatemoji' => apply_filters( 'script_loader_src', includes_url( "js/wp-emoji-release.min.js?$version" ), 'concatemoji' ),
  5273. );
  5274. }
  5275. wp_print_inline_script_tag(
  5276. sprintf( 'window._wpemojiSettings = %s;', wp_json_encode( $settings ) ) . "\n" .
  5277. file_get_contents( sprintf( ABSPATH . WPINC . '/js/wp-emoji-loader' . wp_scripts_get_suffix() . '.js' ) )
  5278. );
  5279. }
  5280. /**
  5281. * Convert emoji characters to their equivalent HTML entity.
  5282. *
  5283. * This allows us to store emoji in a DB using the utf8 character set.
  5284. *
  5285. * @since 4.2.0
  5286. *
  5287. * @param string $content The content to encode.
  5288. * @return string The encoded content.
  5289. */
  5290. function wp_encode_emoji( $content ) {
  5291. $emoji = _wp_emoji_list( 'partials' );
  5292. foreach ( $emoji as $emojum ) {
  5293. $emoji_char = html_entity_decode( $emojum );
  5294. if ( false !== strpos( $content, $emoji_char ) ) {
  5295. $content = preg_replace( "/$emoji_char/", $emojum, $content );
  5296. }
  5297. }
  5298. return $content;
  5299. }
  5300. /**
  5301. * Convert emoji to a static img element.
  5302. *
  5303. * @since 4.2.0
  5304. *
  5305. * @param string $text The content to encode.
  5306. * @return string The encoded content.
  5307. */
  5308. function wp_staticize_emoji( $text ) {
  5309. if ( false === strpos( $text, '&#x' ) ) {
  5310. if ( ( function_exists( 'mb_check_encoding' ) && mb_check_encoding( $text, 'ASCII' ) ) || ! preg_match( '/[^\x00-\x7F]/', $text ) ) {
  5311. // The text doesn't contain anything that might be emoji, so we can return early.
  5312. return $text;
  5313. } else {
  5314. $encoded_text = wp_encode_emoji( $text );
  5315. if ( $encoded_text === $text ) {
  5316. return $encoded_text;
  5317. }
  5318. $text = $encoded_text;
  5319. }
  5320. }
  5321. $emoji = _wp_emoji_list( 'entities' );
  5322. // Quickly narrow down the list of emoji that might be in the text and need replacing.
  5323. $possible_emoji = array();
  5324. foreach ( $emoji as $emojum ) {
  5325. if ( false !== strpos( $text, $emojum ) ) {
  5326. $possible_emoji[ $emojum ] = html_entity_decode( $emojum );
  5327. }
  5328. }
  5329. if ( ! $possible_emoji ) {
  5330. return $text;
  5331. }
  5332. /** This filter is documented in wp-includes/formatting.php */
  5333. $cdn_url = apply_filters( 'emoji_url', 'https://s.w.org/images/core/emoji/13.1.0/72x72/' );
  5334. /** This filter is documented in wp-includes/formatting.php */
  5335. $ext = apply_filters( 'emoji_ext', '.png' );
  5336. $output = '';
  5337. /*
  5338. * HTML loop taken from smiley function, which was taken from texturize function.
  5339. * It'll never be consolidated.
  5340. *
  5341. * First, capture the tags as well as in between.
  5342. */
  5343. $textarr = preg_split( '/(<.*>)/U', $text, -1, PREG_SPLIT_DELIM_CAPTURE );
  5344. $stop = count( $textarr );
  5345. // Ignore processing of specific tags.
  5346. $tags_to_ignore = 'code|pre|style|script|textarea';
  5347. $ignore_block_element = '';
  5348. for ( $i = 0; $i < $stop; $i++ ) {
  5349. $content = $textarr[ $i ];
  5350. // If we're in an ignore block, wait until we find its closing tag.
  5351. if ( '' === $ignore_block_element && preg_match( '/^<(' . $tags_to_ignore . ')>/', $content, $matches ) ) {
  5352. $ignore_block_element = $matches[1];
  5353. }
  5354. // If it's not a tag and not in ignore block.
  5355. if ( '' === $ignore_block_element && strlen( $content ) > 0 && '<' !== $content[0] && false !== strpos( $content, '&#x' ) ) {
  5356. foreach ( $possible_emoji as $emojum => $emoji_char ) {
  5357. if ( false === strpos( $content, $emojum ) ) {
  5358. continue;
  5359. }
  5360. $file = str_replace( ';&#x', '-', $emojum );
  5361. $file = str_replace( array( '&#x', ';' ), '', $file );
  5362. $entity = sprintf( '<img src="%s" alt="%s" class="wp-smiley" style="height: 1em; max-height: 1em;" />', $cdn_url . $file . $ext, $emoji_char );
  5363. $content = str_replace( $emojum, $entity, $content );
  5364. }
  5365. }
  5366. // Did we exit ignore block?
  5367. if ( '' !== $ignore_block_element && '</' . $ignore_block_element . '>' === $content ) {
  5368. $ignore_block_element = '';
  5369. }
  5370. $output .= $content;
  5371. }
  5372. // Finally, remove any stray U+FE0F characters.
  5373. $output = str_replace( '&#xfe0f;', '', $output );
  5374. return $output;
  5375. }
  5376. /**
  5377. * Convert emoji in emails into static images.
  5378. *
  5379. * @since 4.2.0
  5380. *
  5381. * @param array $mail The email data array.
  5382. * @return array The email data array, with emoji in the message staticized.
  5383. */
  5384. function wp_staticize_emoji_for_email( $mail ) {
  5385. if ( ! isset( $mail['message'] ) ) {
  5386. return $mail;
  5387. }
  5388. /*
  5389. * We can only transform the emoji into images if it's a `text/html` email.
  5390. * To do that, here's a cut down version of the same process that happens
  5391. * in wp_mail() - get the `Content-Type` from the headers, if there is one,
  5392. * then pass it through the {@see 'wp_mail_content_type'} filter, in case
  5393. * a plugin is handling changing the `Content-Type`.
  5394. */
  5395. $headers = array();
  5396. if ( isset( $mail['headers'] ) ) {
  5397. if ( is_array( $mail['headers'] ) ) {
  5398. $headers = $mail['headers'];
  5399. } else {
  5400. $headers = explode( "\n", str_replace( "\r\n", "\n", $mail['headers'] ) );
  5401. }
  5402. }
  5403. foreach ( $headers as $header ) {
  5404. if ( strpos( $header, ':' ) === false ) {
  5405. continue;
  5406. }
  5407. // Explode them out.
  5408. list( $name, $content ) = explode( ':', trim( $header ), 2 );
  5409. // Cleanup crew.
  5410. $name = trim( $name );
  5411. $content = trim( $content );
  5412. if ( 'content-type' === strtolower( $name ) ) {
  5413. if ( strpos( $content, ';' ) !== false ) {
  5414. list( $type, $charset ) = explode( ';', $content );
  5415. $content_type = trim( $type );
  5416. } else {
  5417. $content_type = trim( $content );
  5418. }
  5419. break;
  5420. }
  5421. }
  5422. // Set Content-Type if we don't have a content-type from the input headers.
  5423. if ( ! isset( $content_type ) ) {
  5424. $content_type = 'text/plain';
  5425. }
  5426. /** This filter is documented in wp-includes/pluggable.php */
  5427. $content_type = apply_filters( 'wp_mail_content_type', $content_type );
  5428. if ( 'text/html' === $content_type ) {
  5429. $mail['message'] = wp_staticize_emoji( $mail['message'] );
  5430. }
  5431. return $mail;
  5432. }
  5433. /**
  5434. * Returns arrays of emoji data.
  5435. *
  5436. * These arrays are automatically built from the regex in twemoji.js - if they need to be updated,
  5437. * you should update the regex there, then run the `npm run grunt precommit:emoji` job.
  5438. *
  5439. * @since 4.9.0
  5440. * @access private
  5441. *
  5442. * @param string $type Optional. Which array type to return. Accepts 'partials' or 'entities', default 'entities'.
  5443. * @return array An array to match all emoji that WordPress recognises.
  5444. */
  5445. function _wp_emoji_list( $type = 'entities' ) {
  5446. // Do not remove the START/END comments - they're used to find where to insert the arrays.
  5447. // START: emoji arrays
  5448. $entities = array( '&#x1f468;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f468;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f468;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f468;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f468;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f468;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f468;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f468;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f468;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f468;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f468;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f468;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f468;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f468;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f468;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f468;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f468;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f468;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f468;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f468;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f468;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f468;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f468;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f468;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f468;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f469;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f469;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f469;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f469;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f469;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f469;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3fb;', '&#x1f469;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3fc;', '&#x1f469;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3fd;', '&#x1f469;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3fe;', '&#x1f469;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3ff;', '&#x1f469;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f469;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f469;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f469;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f469;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f469;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3fb;', '&#x1f469;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3fc;', '&#x1f469;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3fd;', '&#x1f469;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3fe;', '&#x1f469;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3ff;', '&#x1f469;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f469;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f469;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f469;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f469;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f469;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3fb;', '&#x1f469;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3fc;', '&#x1f469;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3fd;', '&#x1f469;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3fe;', '&#x1f469;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3ff;', '&#x1f469;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f469;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f469;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f469;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f469;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f469;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3fb;', '&#x1f469;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3fc;', '&#x1f469;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3fd;', '&#x1f469;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3fe;', '&#x1f469;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3ff;', '&#x1f469;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f469;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f469;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f469;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f469;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f469;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3fb;', '&#x1f469;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3fc;', '&#x1f469;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3fd;', '&#x1f469;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3fe;', '&#x1f469;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;&#x1f3ff;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f9d1;&#x1f3fc;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f9d1;&#x1f3fd;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f9d1;&#x1f3fe;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f9d1;&#x1f3ff;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f9d1;&#x1f3fb;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f9d1;&#x1f3fd;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f9d1;&#x1f3fe;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f9d1;&#x1f3ff;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f9d1;&#x1f3fb;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f9d1;&#x1f3fc;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f9d1;&#x1f3fe;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f9d1;&#x1f3ff;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f9d1;&#x1f3fb;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f9d1;&#x1f3fc;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f9d1;&#x1f3fd;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f9d1;&#x1f3ff;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f9d1;&#x1f3fb;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f9d1;&#x1f3fc;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f9d1;&#x1f3fd;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f9d1;&#x1f3fe;', '&#x1f468;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f468;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f468;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f468;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f468;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f468;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f468;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f468;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f468;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f468;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f468;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f468;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f468;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f468;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f468;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f468;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f468;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f468;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f468;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f468;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f468;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f468;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f468;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f468;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f468;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f469;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f469;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f469;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f469;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f469;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f469;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3fb;', '&#x1f469;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3fc;', '&#x1f469;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3fd;', '&#x1f469;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3fe;', '&#x1f469;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3ff;', '&#x1f469;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f469;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f469;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f469;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f469;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f469;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3fb;', '&#x1f469;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3fc;', '&#x1f469;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3fd;', '&#x1f469;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3fe;', '&#x1f469;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3ff;', '&#x1f469;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f469;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f469;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f469;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f469;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f469;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3fb;', '&#x1f469;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3fc;', '&#x1f469;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3fd;', '&#x1f469;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3fe;', '&#x1f469;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3ff;', '&#x1f469;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f469;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f469;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f469;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f469;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f469;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3fb;', '&#x1f469;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3fc;', '&#x1f469;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3fd;', '&#x1f469;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3fe;', '&#x1f469;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3ff;', '&#x1f469;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f469;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f469;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f469;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f469;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f469;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3fb;', '&#x1f469;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3fc;', '&#x1f469;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3fd;', '&#x1f469;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3fe;', '&#x1f469;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;&#x1f3ff;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f9d1;&#x1f3fc;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f9d1;&#x1f3fd;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f9d1;&#x1f3fe;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f9d1;&#x1f3ff;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f9d1;&#x1f3fb;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f9d1;&#x1f3fd;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f9d1;&#x1f3fe;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f9d1;&#x1f3ff;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f9d1;&#x1f3fb;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f9d1;&#x1f3fc;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f9d1;&#x1f3fe;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f9d1;&#x1f3ff;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f9d1;&#x1f3fb;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f9d1;&#x1f3fc;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f9d1;&#x1f3fd;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f9d1;&#x1f3ff;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f9d1;&#x1f3fb;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f9d1;&#x1f3fc;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f9d1;&#x1f3fd;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f9d1;&#x1f3fe;', '&#x1f468;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;', '&#x1f469;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f468;', '&#x1f469;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f48b;&#x200d;&#x1f469;', '&#x1f3f4;&#xe0067;&#xe0062;&#xe0065;&#xe006e;&#xe0067;&#xe007f;', '&#x1f3f4;&#xe0067;&#xe0062;&#xe0073;&#xe0063;&#xe0074;&#xe007f;', '&#x1f3f4;&#xe0067;&#xe0062;&#xe0077;&#xe006c;&#xe0073;&#xe007f;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f91d;&#x200d;&#x1f469;&#x1f3fc;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f91d;&#x200d;&#x1f469;&#x1f3fd;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f91d;&#x200d;&#x1f469;&#x1f3fe;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f91d;&#x200d;&#x1f469;&#x1f3ff;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f91d;&#x200d;&#x1f469;&#x1f3fb;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f91d;&#x200d;&#x1f469;&#x1f3fd;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f91d;&#x200d;&#x1f469;&#x1f3fe;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f91d;&#x200d;&#x1f469;&#x1f3ff;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f91d;&#x200d;&#x1f469;&#x1f3fb;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f91d;&#x200d;&#x1f469;&#x1f3fc;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f91d;&#x200d;&#x1f469;&#x1f3fe;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f91d;&#x200d;&#x1f469;&#x1f3ff;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3ff;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f91d;&#x200d;&#x1f469;&#x1f3fb;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f91d;&#x200d;&#x1f469;&#x1f3fc;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f91d;&#x200d;&#x1f469;&#x1f3fd;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f91d;&#x200d;&#x1f469;&#x1f3ff;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fb;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fc;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fd;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f91d;&#x200d;&#x1f468;&#x1f3fe;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f91d;&#x200d;&#x1f469;&#x1f3fb;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f91d;&#x200d;&#x1f469;&#x1f3fc;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f91d;&#x200d;&#x1f469;&#x1f3fd;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f91d;&#x200d;&#x1f469;&#x1f3fe;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3fb;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3fc;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3fd;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3fe;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3ff;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3fb;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3fc;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3fd;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3fe;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3ff;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3fb;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3fc;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3fd;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3fe;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3ff;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3fb;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3fc;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3fd;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3fe;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3ff;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3fb;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3fc;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3fd;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3fe;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;&#x1f3ff;', '&#x1f468;&#x200d;&#x1f468;&#x200d;&#x1f466;&#x200d;&#x1f466;', '&#x1f468;&#x200d;&#x1f468;&#x200d;&#x1f467;&#x200d;&#x1f466;', '&#x1f468;&#x200d;&#x1f468;&#x200d;&#x1f467;&#x200d;&#x1f467;', '&#x1f468;&#x200d;&#x1f469;&#x200d;&#x1f466;&#x200d;&#x1f466;', '&#x1f468;&#x200d;&#x1f469;&#x200d;&#x1f467;&#x200d;&#x1f466;', '&#x1f468;&#x200d;&#x1f469;&#x200d;&#x1f467;&#x200d;&#x1f467;', '&#x1f469;&#x200d;&#x1f469;&#x200d;&#x1f466;&#x200d;&#x1f466;', '&#x1f469;&#x200d;&#x1f469;&#x200d;&#x1f467;&#x200d;&#x1f466;', '&#x1f469;&#x200d;&#x1f469;&#x200d;&#x1f467;&#x200d;&#x1f467;', '&#x1f468;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;', '&#x1f469;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f468;', '&#x1f469;&#x200d;&#x2764;&#xfe0f;&#x200d;&#x1f469;', '&#x1f468;&#x200d;&#x1f466;&#x200d;&#x1f466;', '&#x1f468;&#x200d;&#x1f467;&#x200d;&#x1f466;', '&#x1f468;&#x200d;&#x1f467;&#x200d;&#x1f467;', '&#x1f468;&#x200d;&#x1f468;&#x200d;&#x1f466;', '&#x1f468;&#x200d;&#x1f468;&#x200d;&#x1f467;', '&#x1f468;&#x200d;&#x1f469;&#x200d;&#x1f466;', '&#x1f468;&#x200d;&#x1f469;&#x200d;&#x1f467;', '&#x1f469;&#x200d;&#x1f466;&#x200d;&#x1f466;', '&#x1f469;&#x200d;&#x1f467;&#x200d;&#x1f466;', '&#x1f469;&#x200d;&#x1f467;&#x200d;&#x1f467;', '&#x1f469;&#x200d;&#x1f469;&#x200d;&#x1f466;', '&#x1f469;&#x200d;&#x1f469;&#x200d;&#x1f467;', '&#x1f9d1;&#x200d;&#x1f91d;&#x200d;&#x1f9d1;', '&#x1f3c3;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f3c3;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f3c3;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f3c3;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f3c3;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f3c3;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f3c3;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f3c3;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f3c3;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f3c3;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f3c4;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f3c4;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f3c4;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f3c4;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f3c4;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f3c4;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f3c4;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f3c4;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f3c4;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f3c4;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f3ca;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f3ca;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f3ca;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f3ca;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f3ca;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f3ca;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f3ca;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f3ca;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f3ca;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f3ca;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f3cb;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f3cb;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f3cb;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f3cb;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f3cb;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f3cb;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f3cb;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f3cb;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f3cb;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f3cb;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f3cc;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f3cc;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f3cc;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f3cc;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f3cc;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f3cc;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f3cc;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f3cc;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f3cc;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f3cc;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f468;&#x1f3fb;&#x200d;&#x2695;&#xfe0f;', '&#x1f468;&#x1f3fb;&#x200d;&#x2696;&#xfe0f;', '&#x1f468;&#x1f3fb;&#x200d;&#x2708;&#xfe0f;', '&#x1f468;&#x1f3fc;&#x200d;&#x2695;&#xfe0f;', '&#x1f468;&#x1f3fc;&#x200d;&#x2696;&#xfe0f;', '&#x1f468;&#x1f3fc;&#x200d;&#x2708;&#xfe0f;', '&#x1f468;&#x1f3fd;&#x200d;&#x2695;&#xfe0f;', '&#x1f468;&#x1f3fd;&#x200d;&#x2696;&#xfe0f;', '&#x1f468;&#x1f3fd;&#x200d;&#x2708;&#xfe0f;', '&#x1f468;&#x1f3fe;&#x200d;&#x2695;&#xfe0f;', '&#x1f468;&#x1f3fe;&#x200d;&#x2696;&#xfe0f;', '&#x1f468;&#x1f3fe;&#x200d;&#x2708;&#xfe0f;', '&#x1f468;&#x1f3ff;&#x200d;&#x2695;&#xfe0f;', '&#x1f468;&#x1f3ff;&#x200d;&#x2696;&#xfe0f;', '&#x1f468;&#x1f3ff;&#x200d;&#x2708;&#xfe0f;', '&#x1f469;&#x1f3fb;&#x200d;&#x2695;&#xfe0f;', '&#x1f469;&#x1f3fb;&#x200d;&#x2696;&#xfe0f;', '&#x1f469;&#x1f3fb;&#x200d;&#x2708;&#xfe0f;', '&#x1f469;&#x1f3fc;&#x200d;&#x2695;&#xfe0f;', '&#x1f469;&#x1f3fc;&#x200d;&#x2696;&#xfe0f;', '&#x1f469;&#x1f3fc;&#x200d;&#x2708;&#xfe0f;', '&#x1f469;&#x1f3fd;&#x200d;&#x2695;&#xfe0f;', '&#x1f469;&#x1f3fd;&#x200d;&#x2696;&#xfe0f;', '&#x1f469;&#x1f3fd;&#x200d;&#x2708;&#xfe0f;', '&#x1f469;&#x1f3fe;&#x200d;&#x2695;&#xfe0f;', '&#x1f469;&#x1f3fe;&#x200d;&#x2696;&#xfe0f;', '&#x1f469;&#x1f3fe;&#x200d;&#x2708;&#xfe0f;', '&#x1f469;&#x1f3ff;&#x200d;&#x2695;&#xfe0f;', '&#x1f469;&#x1f3ff;&#x200d;&#x2696;&#xfe0f;', '&#x1f469;&#x1f3ff;&#x200d;&#x2708;&#xfe0f;', '&#x1f46e;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f46e;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f46e;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f46e;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f46e;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f46e;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f46e;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f46e;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f46e;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f46e;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f470;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f470;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f470;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f470;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f470;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f470;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f470;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f470;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f470;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f470;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f471;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f471;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f471;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f471;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f471;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f471;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f471;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f471;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f471;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f471;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f473;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f473;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f473;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f473;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f473;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f473;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f473;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f473;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f473;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f473;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f477;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f477;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f477;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f477;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f477;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f477;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f477;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f477;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f477;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f477;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f481;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f481;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f481;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f481;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f481;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f481;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f481;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f481;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f481;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f481;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f482;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f482;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f482;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f482;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f482;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f482;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f482;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f482;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f482;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f482;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f486;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f486;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f486;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f486;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f486;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f486;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f486;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f486;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f486;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f486;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f487;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f487;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f487;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f487;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f487;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f487;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f487;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f487;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f487;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f487;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f574;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f574;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f574;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f574;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f574;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f574;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f574;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f574;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f574;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f574;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f575;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f575;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f575;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f575;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f575;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f575;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f575;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f575;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f575;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f575;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f645;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f645;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f645;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f645;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f645;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f645;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f645;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f645;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f645;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f645;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f646;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f646;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f646;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f646;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f646;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f646;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f646;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f646;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f646;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f646;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f647;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f647;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f647;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f647;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f647;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f647;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f647;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f647;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f647;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f647;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f64b;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f64b;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f64b;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f64b;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f64b;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f64b;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f64b;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f64b;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f64b;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f64b;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f64d;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f64d;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f64d;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f64d;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f64d;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f64d;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f64d;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f64d;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f64d;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f64d;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f64e;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f64e;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f64e;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f64e;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f64e;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f64e;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f64e;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f64e;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f64e;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f64e;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f6a3;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f6a3;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f6a3;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f6a3;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f6a3;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f6a3;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f6a3;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f6a3;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f6a3;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f6a3;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f6b4;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f6b4;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f6b4;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f6b4;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f6b4;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f6b4;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f6b4;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f6b4;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f6b4;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f6b4;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f6b5;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f6b5;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f6b5;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f6b5;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f6b5;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f6b5;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f6b5;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f6b5;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f6b5;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f6b5;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f6b6;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f6b6;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f6b6;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f6b6;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f6b6;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f6b6;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f6b6;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f6b6;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f6b6;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f6b6;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f926;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f926;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f926;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f926;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f926;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f926;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f926;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f926;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f926;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f926;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f935;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f935;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f935;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f935;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f935;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f935;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f935;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f935;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f935;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f935;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f937;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f937;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f937;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f937;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f937;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f937;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f937;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f937;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f937;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f937;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f938;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f938;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f938;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f938;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f938;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f938;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f938;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f938;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f938;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f938;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f939;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f939;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f939;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f939;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f939;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f939;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f939;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f939;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f939;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f939;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f93d;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f93d;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f93d;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f93d;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f93d;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f93d;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f93d;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f93d;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f93d;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f93d;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f93e;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f93e;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f93e;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f93e;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f93e;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f93e;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f93e;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f93e;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f93e;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f93e;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f9b8;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f9b8;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f9b8;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f9b8;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f9b8;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f9b8;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f9b8;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f9b8;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f9b8;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f9b8;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f9b9;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f9b9;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f9b9;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f9b9;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f9b9;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f9b9;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f9b9;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f9b9;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f9b9;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f9b9;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f9cd;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f9cd;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f9cd;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f9cd;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f9cd;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f9cd;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f9cd;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f9cd;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f9cd;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f9cd;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f9ce;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f9ce;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f9ce;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f9ce;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f9ce;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f9ce;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f9ce;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f9ce;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f9ce;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f9ce;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f9cf;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f9cf;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f9cf;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f9cf;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f9cf;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f9cf;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f9cf;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f9cf;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f9cf;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f9cf;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x2695;&#xfe0f;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x2696;&#xfe0f;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x2708;&#xfe0f;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x2695;&#xfe0f;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x2696;&#xfe0f;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x2708;&#xfe0f;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x2695;&#xfe0f;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x2696;&#xfe0f;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x2708;&#xfe0f;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x2695;&#xfe0f;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x2696;&#xfe0f;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x2708;&#xfe0f;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x2695;&#xfe0f;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x2696;&#xfe0f;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x2708;&#xfe0f;', '&#x1f9d4;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d4;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d4;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d4;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d4;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d4;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d4;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d4;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d4;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d4;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d6;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d6;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d6;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d6;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d6;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d6;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d6;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d6;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d6;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d6;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d7;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d7;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d7;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d7;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d7;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d7;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d7;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d7;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d7;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d7;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d8;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d8;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d8;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d8;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d8;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d8;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d8;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d8;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d8;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d8;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d9;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d9;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d9;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d9;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d9;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d9;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d9;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d9;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d9;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d9;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f9da;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f9da;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f9da;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f9da;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f9da;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f9da;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f9da;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f9da;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f9da;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f9da;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f9db;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f9db;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f9db;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f9db;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f9db;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f9db;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f9db;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f9db;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f9db;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f9db;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f9dc;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f9dc;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f9dc;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f9dc;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f9dc;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f9dc;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f9dc;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f9dc;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f9dc;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f9dc;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f9dd;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x1f9dd;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x1f9dd;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x1f9dd;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x1f9dd;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x1f9dd;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x1f9dd;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x1f9dd;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x1f9dd;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x1f9dd;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x1f3cb;&#xfe0f;&#x200d;&#x2640;&#xfe0f;', '&#x1f3cb;&#xfe0f;&#x200d;&#x2642;&#xfe0f;', '&#x1f3cc;&#xfe0f;&#x200d;&#x2640;&#xfe0f;', '&#x1f3cc;&#xfe0f;&#x200d;&#x2642;&#xfe0f;', '&#x1f3f3;&#xfe0f;&#x200d;&#x26a7;&#xfe0f;', '&#x1f574;&#xfe0f;&#x200d;&#x2640;&#xfe0f;', '&#x1f574;&#xfe0f;&#x200d;&#x2642;&#xfe0f;', '&#x1f575;&#xfe0f;&#x200d;&#x2640;&#xfe0f;', '&#x1f575;&#xfe0f;&#x200d;&#x2642;&#xfe0f;', '&#x26f9;&#x1f3fb;&#x200d;&#x2640;&#xfe0f;', '&#x26f9;&#x1f3fb;&#x200d;&#x2642;&#xfe0f;', '&#x26f9;&#x1f3fc;&#x200d;&#x2640;&#xfe0f;', '&#x26f9;&#x1f3fc;&#x200d;&#x2642;&#xfe0f;', '&#x26f9;&#x1f3fd;&#x200d;&#x2640;&#xfe0f;', '&#x26f9;&#x1f3fd;&#x200d;&#x2642;&#xfe0f;', '&#x26f9;&#x1f3fe;&#x200d;&#x2640;&#xfe0f;', '&#x26f9;&#x1f3fe;&#x200d;&#x2642;&#xfe0f;', '&#x26f9;&#x1f3ff;&#x200d;&#x2640;&#xfe0f;', '&#x26f9;&#x1f3ff;&#x200d;&#x2642;&#xfe0f;', '&#x26f9;&#xfe0f;&#x200d;&#x2640;&#xfe0f;', '&#x26f9;&#xfe0f;&#x200d;&#x2642;&#xfe0f;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f33e;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f373;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f37c;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f384;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f393;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f3a4;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f3a8;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f3eb;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f3ed;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f4bb;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f4bc;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f527;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f52c;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f680;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f692;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f9af;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f9b0;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f9b1;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f9b2;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f9b3;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f9bc;', '&#x1f468;&#x1f3fb;&#x200d;&#x1f9bd;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f33e;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f373;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f37c;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f384;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f393;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f3a4;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f3a8;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f3eb;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f3ed;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f4bb;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f4bc;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f527;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f52c;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f680;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f692;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f9af;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f9b0;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f9b1;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f9b2;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f9b3;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f9bc;', '&#x1f468;&#x1f3fc;&#x200d;&#x1f9bd;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f33e;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f373;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f37c;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f384;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f393;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f3a4;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f3a8;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f3eb;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f3ed;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f4bb;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f4bc;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f527;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f52c;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f680;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f692;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f9af;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f9b0;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f9b1;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f9b2;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f9b3;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f9bc;', '&#x1f468;&#x1f3fd;&#x200d;&#x1f9bd;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f33e;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f373;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f37c;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f384;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f393;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f3a4;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f3a8;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f3eb;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f3ed;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f4bb;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f4bc;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f527;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f52c;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f680;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f692;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f9af;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f9b0;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f9b1;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f9b2;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f9b3;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f9bc;', '&#x1f468;&#x1f3fe;&#x200d;&#x1f9bd;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f33e;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f373;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f37c;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f384;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f393;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f3a4;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f3a8;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f3eb;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f3ed;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f4bb;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f4bc;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f527;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f52c;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f680;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f692;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f9af;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f9b0;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f9b1;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f9b2;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f9b3;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f9bc;', '&#x1f468;&#x1f3ff;&#x200d;&#x1f9bd;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f33e;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f373;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f37c;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f384;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f393;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f3a4;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f3a8;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f3eb;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f3ed;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f4bb;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f4bc;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f527;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f52c;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f680;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f692;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f9af;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f9b0;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f9b1;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f9b2;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f9b3;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f9bc;', '&#x1f469;&#x1f3fb;&#x200d;&#x1f9bd;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f33e;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f373;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f37c;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f384;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f393;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f3a4;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f3a8;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f3eb;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f3ed;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f4bb;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f4bc;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f527;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f52c;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f680;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f692;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f9af;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f9b0;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f9b1;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f9b2;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f9b3;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f9bc;', '&#x1f469;&#x1f3fc;&#x200d;&#x1f9bd;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f33e;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f373;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f37c;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f384;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f393;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f3a4;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f3a8;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f3eb;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f3ed;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f4bb;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f4bc;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f527;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f52c;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f680;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f692;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f9af;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f9b0;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f9b1;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f9b2;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f9b3;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f9bc;', '&#x1f469;&#x1f3fd;&#x200d;&#x1f9bd;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f33e;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f373;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f37c;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f384;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f393;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f3a4;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f3a8;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f3eb;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f3ed;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f4bb;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f4bc;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f527;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f52c;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f680;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f692;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f9af;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f9b0;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f9b1;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f9b2;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f9b3;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f9bc;', '&#x1f469;&#x1f3fe;&#x200d;&#x1f9bd;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f33e;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f373;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f37c;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f384;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f393;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f3a4;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f3a8;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f3eb;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f3ed;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f4bb;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f4bc;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f527;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f52c;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f680;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f692;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f9af;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f9b0;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f9b1;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f9b2;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f9b3;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f9bc;', '&#x1f469;&#x1f3ff;&#x200d;&#x1f9bd;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f33e;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f373;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f37c;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f384;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f393;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f3a4;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f3a8;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f3eb;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f3ed;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f4bb;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f4bc;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f527;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f52c;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f680;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f692;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f9af;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f9b0;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f9b1;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f9b2;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f9b3;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f9bc;', '&#x1f9d1;&#x1f3fb;&#x200d;&#x1f9bd;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f33e;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f373;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f37c;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f384;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f393;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f3a4;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f3a8;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f3eb;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f3ed;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f4bb;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f4bc;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f527;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f52c;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f680;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f692;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f9af;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f9b0;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f9b1;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f9b2;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f9b3;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f9bc;', '&#x1f9d1;&#x1f3fc;&#x200d;&#x1f9bd;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f33e;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f373;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f37c;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f384;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f393;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f3a4;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f3a8;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f3eb;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f3ed;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f4bb;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f4bc;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f527;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f52c;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f680;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f692;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f9af;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f9b0;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f9b1;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f9b2;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f9b3;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f9bc;', '&#x1f9d1;&#x1f3fd;&#x200d;&#x1f9bd;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f33e;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f373;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f37c;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f384;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f393;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f3a4;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f3a8;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f3eb;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f3ed;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f4bb;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f4bc;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f527;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f52c;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f680;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f692;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f9af;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f9b0;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f9b1;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f9b2;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f9b3;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f9bc;', '&#x1f9d1;&#x1f3fe;&#x200d;&#x1f9bd;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f33e;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f373;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f37c;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f384;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f393;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f3a4;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f3a8;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f3eb;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f3ed;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f4bb;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f4bc;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f527;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f52c;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f680;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f692;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f9af;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f9b0;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f9b1;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f9b2;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f9b3;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f9bc;', '&#x1f9d1;&#x1f3ff;&#x200d;&#x1f9bd;', '&#x1f3f3;&#xfe0f;&#x200d;&#x1f308;', '&#x1f636;&#x200d;&#x1f32b;&#xfe0f;', '&#x1f3c3;&#x200d;&#x2640;&#xfe0f;', '&#x1f3c3;&#x200d;&#x2642;&#xfe0f;', '&#x1f3c4;&#x200d;&#x2640;&#xfe0f;', '&#x1f3c4;&#x200d;&#x2642;&#xfe0f;', '&#x1f3ca;&#x200d;&#x2640;&#xfe0f;', '&#x1f3ca;&#x200d;&#x2642;&#xfe0f;', '&#x1f3f4;&#x200d;&#x2620;&#xfe0f;', '&#x1f43b;&#x200d;&#x2744;&#xfe0f;', '&#x1f468;&#x200d;&#x2695;&#xfe0f;', '&#x1f468;&#x200d;&#x2696;&#xfe0f;', '&#x1f468;&#x200d;&#x2708;&#xfe0f;', '&#x1f469;&#x200d;&#x2695;&#xfe0f;', '&#x1f469;&#x200d;&#x2696;&#xfe0f;', '&#x1f469;&#x200d;&#x2708;&#xfe0f;', '&#x1f46e;&#x200d;&#x2640;&#xfe0f;', '&#x1f46e;&#x200d;&#x2642;&#xfe0f;', '&#x1f46f;&#x200d;&#x2640;&#xfe0f;', '&#x1f46f;&#x200d;&#x2642;&#xfe0f;', '&#x1f470;&#x200d;&#x2640;&#xfe0f;', '&#x1f470;&#x200d;&#x2642;&#xfe0f;', '&#x1f471;&#x200d;&#x2640;&#xfe0f;', '&#x1f471;&#x200d;&#x2642;&#xfe0f;', '&#x1f473;&#x200d;&#x2640;&#xfe0f;', '&#x1f473;&#x200d;&#x2642;&#xfe0f;', '&#x1f477;&#x200d;&#x2640;&#xfe0f;', '&#x1f477;&#x200d;&#x2642;&#xfe0f;', '&#x1f481;&#x200d;&#x2640;&#xfe0f;', '&#x1f481;&#x200d;&#x2642;&#xfe0f;', '&#x1f482;&#x200d;&#x2640;&#xfe0f;', '&#x1f482;&#x200d;&#x2642;&#xfe0f;', '&#x1f486;&#x200d;&#x2640;&#xfe0f;', '&#x1f486;&#x200d;&#x2642;&#xfe0f;', '&#x1f487;&#x200d;&#x2640;&#xfe0f;', '&#x1f487;&#x200d;&#x2642;&#xfe0f;', '&#x1f645;&#x200d;&#x2640;&#xfe0f;', '&#x1f645;&#x200d;&#x2642;&#xfe0f;', '&#x1f646;&#x200d;&#x2640;&#xfe0f;', '&#x1f646;&#x200d;&#x2642;&#xfe0f;', '&#x1f647;&#x200d;&#x2640;&#xfe0f;', '&#x1f647;&#x200d;&#x2642;&#xfe0f;', '&#x1f64b;&#x200d;&#x2640;&#xfe0f;', '&#x1f64b;&#x200d;&#x2642;&#xfe0f;', '&#x1f64d;&#x200d;&#x2640;&#xfe0f;', '&#x1f64d;&#x200d;&#x2642;&#xfe0f;', '&#x1f64e;&#x200d;&#x2640;&#xfe0f;', '&#x1f64e;&#x200d;&#x2642;&#xfe0f;', '&#x1f6a3;&#x200d;&#x2640;&#xfe0f;', '&#x1f6a3;&#x200d;&#x2642;&#xfe0f;', '&#x1f6b4;&#x200d;&#x2640;&#xfe0f;', '&#x1f6b4;&#x200d;&#x2642;&#xfe0f;', '&#x1f6b5;&#x200d;&#x2640;&#xfe0f;', '&#x1f6b5;&#x200d;&#x2642;&#xfe0f;', '&#x1f6b6;&#x200d;&#x2640;&#xfe0f;', '&#x1f6b6;&#x200d;&#x2642;&#xfe0f;', '&#x1f926;&#x200d;&#x2640;&#xfe0f;', '&#x1f926;&#x200d;&#x2642;&#xfe0f;', '&#x1f935;&#x200d;&#x2640;&#xfe0f;', '&#x1f935;&#x200d;&#x2642;&#xfe0f;', '&#x1f937;&#x200d;&#x2640;&#xfe0f;', '&#x1f937;&#x200d;&#x2642;&#xfe0f;', '&#x1f938;&#x200d;&#x2640;&#xfe0f;', '&#x1f938;&#x200d;&#x2642;&#xfe0f;', '&#x1f939;&#x200d;&#x2640;&#xfe0f;', '&#x1f939;&#x200d;&#x2642;&#xfe0f;', '&#x1f93c;&#x200d;&#x2640;&#xfe0f;', '&#x1f93c;&#x200d;&#x2642;&#xfe0f;', '&#x1f93d;&#x200d;&#x2640;&#xfe0f;', '&#x1f93d;&#x200d;&#x2642;&#xfe0f;', '&#x1f93e;&#x200d;&#x2640;&#xfe0f;', '&#x1f93e;&#x200d;&#x2642;&#xfe0f;', '&#x1f9b8;&#x200d;&#x2640;&#xfe0f;', '&#x1f9b8;&#x200d;&#x2642;&#xfe0f;', '&#x1f9b9;&#x200d;&#x2640;&#xfe0f;', '&#x1f9b9;&#x200d;&#x2642;&#xfe0f;', '&#x1f9cd;&#x200d;&#x2640;&#xfe0f;', '&#x1f9cd;&#x200d;&#x2642;&#xfe0f;', '&#x1f9ce;&#x200d;&#x2640;&#xfe0f;', '&#x1f9ce;&#x200d;&#x2642;&#xfe0f;', '&#x1f9cf;&#x200d;&#x2640;&#xfe0f;', '&#x1f9cf;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d1;&#x200d;&#x2695;&#xfe0f;', '&#x1f9d1;&#x200d;&#x2696;&#xfe0f;', '&#x1f9d1;&#x200d;&#x2708;&#xfe0f;', '&#x1f9d4;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d4;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d6;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d6;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d7;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d7;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d8;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d8;&#x200d;&#x2642;&#xfe0f;', '&#x1f9d9;&#x200d;&#x2640;&#xfe0f;', '&#x1f9d9;&#x200d;&#x2642;&#xfe0f;', '&#x1f9da;&#x200d;&#x2640;&#xfe0f;', '&#x1f9da;&#x200d;&#x2642;&#xfe0f;', '&#x1f9db;&#x200d;&#x2640;&#xfe0f;', '&#x1f9db;&#x200d;&#x2642;&#xfe0f;', '&#x1f9dc;&#x200d;&#x2640;&#xfe0f;', '&#x1f9dc;&#x200d;&#x2642;&#xfe0f;', '&#x1f9dd;&#x200d;&#x2640;&#xfe0f;', '&#x1f9dd;&#x200d;&#x2642;&#xfe0f;', '&#x1f9de;&#x200d;&#x2640;&#xfe0f;', '&#x1f9de;&#x200d;&#x2642;&#xfe0f;', '&#x1f9df;&#x200d;&#x2640;&#xfe0f;', '&#x1f9df;&#x200d;&#x2642;&#xfe0f;', '&#x2764;&#xfe0f;&#x200d;&#x1f525;', '&#x2764;&#xfe0f;&#x200d;&#x1fa79;', '&#x1f415;&#x200d;&#x1f9ba;', '&#x1f441;&#x200d;&#x1f5e8;', '&#x1f468;&#x200d;&#x1f33e;', '&#x1f468;&#x200d;&#x1f373;', '&#x1f468;&#x200d;&#x1f37c;', '&#x1f468;&#x200d;&#x1f384;', '&#x1f468;&#x200d;&#x1f393;', '&#x1f468;&#x200d;&#x1f3a4;', '&#x1f468;&#x200d;&#x1f3a8;', '&#x1f468;&#x200d;&#x1f3eb;', '&#x1f468;&#x200d;&#x1f3ed;', '&#x1f468;&#x200d;&#x1f466;', '&#x1f468;&#x200d;&#x1f467;', '&#x1f468;&#x200d;&#x1f4bb;', '&#x1f468;&#x200d;&#x1f4bc;', '&#x1f468;&#x200d;&#x1f527;', '&#x1f468;&#x200d;&#x1f52c;', '&#x1f468;&#x200d;&#x1f680;', '&#x1f468;&#x200d;&#x1f692;', '&#x1f468;&#x200d;&#x1f9af;', '&#x1f468;&#x200d;&#x1f9b0;', '&#x1f468;&#x200d;&#x1f9b1;', '&#x1f468;&#x200d;&#x1f9b2;', '&#x1f468;&#x200d;&#x1f9b3;', '&#x1f468;&#x200d;&#x1f9bc;', '&#x1f468;&#x200d;&#x1f9bd;', '&#x1f469;&#x200d;&#x1f33e;', '&#x1f469;&#x200d;&#x1f373;', '&#x1f469;&#x200d;&#x1f37c;', '&#x1f469;&#x200d;&#x1f384;', '&#x1f469;&#x200d;&#x1f393;', '&#x1f469;&#x200d;&#x1f3a4;', '&#x1f469;&#x200d;&#x1f3a8;', '&#x1f469;&#x200d;&#x1f3eb;', '&#x1f469;&#x200d;&#x1f3ed;', '&#x1f469;&#x200d;&#x1f466;', '&#x1f469;&#x200d;&#x1f467;', '&#x1f469;&#x200d;&#x1f4bb;', '&#x1f469;&#x200d;&#x1f4bc;', '&#x1f469;&#x200d;&#x1f527;', '&#x1f469;&#x200d;&#x1f52c;', '&#x1f469;&#x200d;&#x1f680;', '&#x1f469;&#x200d;&#x1f692;', '&#x1f469;&#x200d;&#x1f9af;', '&#x1f469;&#x200d;&#x1f9b0;', '&#x1f469;&#x200d;&#x1f9b1;', '&#x1f469;&#x200d;&#x1f9b2;', '&#x1f469;&#x200d;&#x1f9b3;', '&#x1f469;&#x200d;&#x1f9bc;', '&#x1f469;&#x200d;&#x1f9bd;', '&#x1f62e;&#x200d;&#x1f4a8;', '&#x1f635;&#x200d;&#x1f4ab;', '&#x1f9d1;&#x200d;&#x1f33e;', '&#x1f9d1;&#x200d;&#x1f373;', '&#x1f9d1;&#x200d;&#x1f37c;', '&#x1f9d1;&#x200d;&#x1f384;', '&#x1f9d1;&#x200d;&#x1f393;', '&#x1f9d1;&#x200d;&#x1f3a4;', '&#x1f9d1;&#x200d;&#x1f3a8;', '&#x1f9d1;&#x200d;&#x1f3eb;', '&#x1f9d1;&#x200d;&#x1f3ed;', '&#x1f9d1;&#x200d;&#x1f4bb;', '&#x1f9d1;&#x200d;&#x1f4bc;', '&#x1f9d1;&#x200d;&#x1f527;', '&#x1f9d1;&#x200d;&#x1f52c;', '&#x1f9d1;&#x200d;&#x1f680;', '&#x1f9d1;&#x200d;&#x1f692;', '&#x1f9d1;&#x200d;&#x1f9af;', '&#x1f9d1;&#x200d;&#x1f9b0;', '&#x1f9d1;&#x200d;&#x1f9b1;', '&#x1f9d1;&#x200d;&#x1f9b2;', '&#x1f9d1;&#x200d;&#x1f9b3;', '&#x1f9d1;&#x200d;&#x1f9bc;', '&#x1f9d1;&#x200d;&#x1f9bd;', '&#x1f408;&#x200d;&#x2b1b;', '&#x1f1e6;&#x1f1e8;', '&#x1f1e6;&#x1f1e9;', '&#x1f1e6;&#x1f1ea;', '&#x1f1e6;&#x1f1eb;', '&#x1f1e6;&#x1f1ec;', '&#x1f1e6;&#x1f1ee;', '&#x1f1e6;&#x1f1f1;', '&#x1f1e6;&#x1f1f2;', '&#x1f1e6;&#x1f1f4;', '&#x1f1e6;&#x1f1f6;', '&#x1f1e6;&#x1f1f7;', '&#x1f1e6;&#x1f1f8;', '&#x1f1e6;&#x1f1f9;', '&#x1f1e6;&#x1f1fa;', '&#x1f1e6;&#x1f1fc;', '&#x1f1e6;&#x1f1fd;', '&#x1f1e6;&#x1f1ff;', '&#x1f1e7;&#x1f1e6;', '&#x1f1e7;&#x1f1e7;', '&#x1f1e7;&#x1f1e9;', '&#x1f1e7;&#x1f1ea;', '&#x1f1e7;&#x1f1eb;', '&#x1f1e7;&#x1f1ec;', '&#x1f1e7;&#x1f1ed;', '&#x1f1e7;&#x1f1ee;', '&#x1f1e7;&#x1f1ef;', '&#x1f1e7;&#x1f1f1;', '&#x1f1e7;&#x1f1f2;', '&#x1f1e7;&#x1f1f3;', '&#x1f1e7;&#x1f1f4;', '&#x1f1e7;&#x1f1f6;', '&#x1f1e7;&#x1f1f7;', '&#x1f1e7;&#x1f1f8;', '&#x1f1e7;&#x1f1f9;', '&#x1f1e7;&#x1f1fb;', '&#x1f1e7;&#x1f1fc;', '&#x1f1e7;&#x1f1fe;', '&#x1f1e7;&#x1f1ff;', '&#x1f1e8;&#x1f1e6;', '&#x1f1e8;&#x1f1e8;', '&#x1f1e8;&#x1f1e9;', '&#x1f1e8;&#x1f1eb;', '&#x1f1e8;&#x1f1ec;', '&#x1f1e8;&#x1f1ed;', '&#x1f1e8;&#x1f1ee;', '&#x1f1e8;&#x1f1f0;', '&#x1f1e8;&#x1f1f1;', '&#x1f1e8;&#x1f1f2;', '&#x1f1e8;&#x1f1f3;', '&#x1f1e8;&#x1f1f4;', '&#x1f1e8;&#x1f1f5;', '&#x1f1e8;&#x1f1f7;', '&#x1f1e8;&#x1f1fa;', '&#x1f1e8;&#x1f1fb;', '&#x1f1e8;&#x1f1fc;', '&#x1f1e8;&#x1f1fd;', '&#x1f1e8;&#x1f1fe;', '&#x1f1e8;&#x1f1ff;', '&#x1f1e9;&#x1f1ea;', '&#x1f1e9;&#x1f1ec;', '&#x1f1e9;&#x1f1ef;', '&#x1f1e9;&#x1f1f0;', '&#x1f1e9;&#x1f1f2;', '&#x1f1e9;&#x1f1f4;', '&#x1f1e9;&#x1f1ff;', '&#x1f1ea;&#x1f1e6;', '&#x1f1ea;&#x1f1e8;', '&#x1f1ea;&#x1f1ea;', '&#x1f1ea;&#x1f1ec;', '&#x1f1ea;&#x1f1ed;', '&#x1f1ea;&#x1f1f7;', '&#x1f1ea;&#x1f1f8;', '&#x1f1ea;&#x1f1f9;', '&#x1f1ea;&#x1f1fa;', '&#x1f1eb;&#x1f1ee;', '&#x1f1eb;&#x1f1ef;', '&#x1f1eb;&#x1f1f0;', '&#x1f1eb;&#x1f1f2;', '&#x1f1eb;&#x1f1f4;', '&#x1f1eb;&#x1f1f7;', '&#x1f1ec;&#x1f1e6;', '&#x1f1ec;&#x1f1e7;', '&#x1f1ec;&#x1f1e9;', '&#x1f1ec;&#x1f1ea;', '&#x1f1ec;&#x1f1eb;', '&#x1f1ec;&#x1f1ec;', '&#x1f1ec;&#x1f1ed;', '&#x1f1ec;&#x1f1ee;', '&#x1f1ec;&#x1f1f1;', '&#x1f1ec;&#x1f1f2;', '&#x1f1ec;&#x1f1f3;', '&#x1f1ec;&#x1f1f5;', '&#x1f1ec;&#x1f1f6;', '&#x1f1ec;&#x1f1f7;', '&#x1f1ec;&#x1f1f8;', '&#x1f1ec;&#x1f1f9;', '&#x1f1ec;&#x1f1fa;', '&#x1f1ec;&#x1f1fc;', '&#x1f1ec;&#x1f1fe;', '&#x1f1ed;&#x1f1f0;', '&#x1f1ed;&#x1f1f2;', '&#x1f1ed;&#x1f1f3;', '&#x1f1ed;&#x1f1f7;', '&#x1f1ed;&#x1f1f9;', '&#x1f1ed;&#x1f1fa;', '&#x1f1ee;&#x1f1e8;', '&#x1f1ee;&#x1f1e9;', '&#x1f1ee;&#x1f1ea;', '&#x1f1ee;&#x1f1f1;', '&#x1f1ee;&#x1f1f2;', '&#x1f1ee;&#x1f1f3;', '&#x1f1ee;&#x1f1f4;', '&#x1f1ee;&#x1f1f6;', '&#x1f1ee;&#x1f1f7;', '&#x1f1ee;&#x1f1f8;', '&#x1f1ee;&#x1f1f9;', '&#x1f1ef;&#x1f1ea;', '&#x1f1ef;&#x1f1f2;', '&#x1f1ef;&#x1f1f4;', '&#x1f1ef;&#x1f1f5;', '&#x1f1f0;&#x1f1ea;', '&#x1f1f0;&#x1f1ec;', '&#x1f1f0;&#x1f1ed;', '&#x1f1f0;&#x1f1ee;', '&#x1f1f0;&#x1f1f2;', '&#x1f1f0;&#x1f1f3;', '&#x1f1f0;&#x1f1f5;', '&#x1f1f0;&#x1f1f7;', '&#x1f1f0;&#x1f1fc;', '&#x1f1f0;&#x1f1fe;', '&#x1f1f0;&#x1f1ff;', '&#x1f1f1;&#x1f1e6;', '&#x1f1f1;&#x1f1e7;', '&#x1f1f1;&#x1f1e8;', '&#x1f1f1;&#x1f1ee;', '&#x1f1f1;&#x1f1f0;', '&#x1f1f1;&#x1f1f7;', '&#x1f1f1;&#x1f1f8;', '&#x1f1f1;&#x1f1f9;', '&#x1f1f1;&#x1f1fa;', '&#x1f1f1;&#x1f1fb;', '&#x1f1f1;&#x1f1fe;', '&#x1f1f2;&#x1f1e6;', '&#x1f1f2;&#x1f1e8;', '&#x1f1f2;&#x1f1e9;', '&#x1f1f2;&#x1f1ea;', '&#x1f1f2;&#x1f1eb;', '&#x1f1f2;&#x1f1ec;', '&#x1f1f2;&#x1f1ed;', '&#x1f1f2;&#x1f1f0;', '&#x1f1f2;&#x1f1f1;', '&#x1f1f2;&#x1f1f2;', '&#x1f1f2;&#x1f1f3;', '&#x1f1f2;&#x1f1f4;', '&#x1f1f2;&#x1f1f5;', '&#x1f1f2;&#x1f1f6;', '&#x1f1f2;&#x1f1f7;', '&#x1f1f2;&#x1f1f8;', '&#x1f1f2;&#x1f1f9;', '&#x1f1f2;&#x1f1fa;', '&#x1f1f2;&#x1f1fb;', '&#x1f1f2;&#x1f1fc;', '&#x1f1f2;&#x1f1fd;', '&#x1f1f2;&#x1f1fe;', '&#x1f1f2;&#x1f1ff;', '&#x1f1f3;&#x1f1e6;', '&#x1f1f3;&#x1f1e8;', '&#x1f1f3;&#x1f1ea;', '&#x1f1f3;&#x1f1eb;', '&#x1f1f3;&#x1f1ec;', '&#x1f1f3;&#x1f1ee;', '&#x1f1f3;&#x1f1f1;', '&#x1f1f3;&#x1f1f4;', '&#x1f1f3;&#x1f1f5;', '&#x1f1f3;&#x1f1f7;', '&#x1f1f3;&#x1f1fa;', '&#x1f1f3;&#x1f1ff;', '&#x1f1f4;&#x1f1f2;', '&#x1f1f5;&#x1f1e6;', '&#x1f1f5;&#x1f1ea;', '&#x1f1f5;&#x1f1eb;', '&#x1f1f5;&#x1f1ec;', '&#x1f1f5;&#x1f1ed;', '&#x1f1f5;&#x1f1f0;', '&#x1f1f5;&#x1f1f1;', '&#x1f1f5;&#x1f1f2;', '&#x1f1f5;&#x1f1f3;', '&#x1f1f5;&#x1f1f7;', '&#x1f1f5;&#x1f1f8;', '&#x1f1f5;&#x1f1f9;', '&#x1f1f5;&#x1f1fc;', '&#x1f1f5;&#x1f1fe;', '&#x1f1f6;&#x1f1e6;', '&#x1f1f7;&#x1f1ea;', '&#x1f1f7;&#x1f1f4;', '&#x1f1f7;&#x1f1f8;', '&#x1f1f7;&#x1f1fa;', '&#x1f1f7;&#x1f1fc;', '&#x1f1f8;&#x1f1e6;', '&#x1f1f8;&#x1f1e7;', '&#x1f1f8;&#x1f1e8;', '&#x1f1f8;&#x1f1e9;', '&#x1f1f8;&#x1f1ea;', '&#x1f1f8;&#x1f1ec;', '&#x1f1f8;&#x1f1ed;', '&#x1f1f8;&#x1f1ee;', '&#x1f1f8;&#x1f1ef;', '&#x1f1f8;&#x1f1f0;', '&#x1f1f8;&#x1f1f1;', '&#x1f1f8;&#x1f1f2;', '&#x1f1f8;&#x1f1f3;', '&#x1f1f8;&#x1f1f4;', '&#x1f1f8;&#x1f1f7;', '&#x1f1f8;&#x1f1f8;', '&#x1f1f8;&#x1f1f9;', '&#x1f1f8;&#x1f1fb;', '&#x1f1f8;&#x1f1fd;', '&#x1f1f8;&#x1f1fe;', '&#x1f1f8;&#x1f1ff;', '&#x1f1f9;&#x1f1e6;', '&#x1f1f9;&#x1f1e8;', '&#x1f1f9;&#x1f1e9;', '&#x1f1f9;&#x1f1eb;', '&#x1f1f9;&#x1f1ec;', '&#x1f1f9;&#x1f1ed;', '&#x1f1f9;&#x1f1ef;', '&#x1f1f9;&#x1f1f0;', '&#x1f1f9;&#x1f1f1;', '&#x1f1f9;&#x1f1f2;', '&#x1f1f9;&#x1f1f3;', '&#x1f1f9;&#x1f1f4;', '&#x1f1f9;&#x1f1f7;', '&#x1f1f9;&#x1f1f9;', '&#x1f1f9;&#x1f1fb;', '&#x1f1f9;&#x1f1fc;', '&#x1f1f9;&#x1f1ff;', '&#x1f1fa;&#x1f1e6;', '&#x1f1fa;&#x1f1ec;', '&#x1f1fa;&#x1f1f2;', '&#x1f1fa;&#x1f1f3;', '&#x1f1fa;&#x1f1f8;', '&#x1f1fa;&#x1f1fe;', '&#x1f1fa;&#x1f1ff;', '&#x1f1fb;&#x1f1e6;', '&#x1f1fb;&#x1f1e8;', '&#x1f1fb;&#x1f1ea;', '&#x1f1fb;&#x1f1ec;', '&#x1f1fb;&#x1f1ee;', '&#x1f1fb;&#x1f1f3;', '&#x1f1fb;&#x1f1fa;', '&#x1f1fc;&#x1f1eb;', '&#x1f1fc;&#x1f1f8;', '&#x1f1fd;&#x1f1f0;', '&#x1f1fe;&#x1f1ea;', '&#x1f1fe;&#x1f1f9;', '&#x1f1ff;&#x1f1e6;', '&#x1f1ff;&#x1f1f2;', '&#x1f1ff;&#x1f1fc;', '&#x1f385;&#x1f3fb;', '&#x1f385;&#x1f3fc;', '&#x1f385;&#x1f3fd;', '&#x1f385;&#x1f3fe;', '&#x1f385;&#x1f3ff;', '&#x1f3c2;&#x1f3fb;', '&#x1f3c2;&#x1f3fc;', '&#x1f3c2;&#x1f3fd;', '&#x1f3c2;&#x1f3fe;', '&#x1f3c2;&#x1f3ff;', '&#x1f3c3;&#x1f3fb;', '&#x1f3c3;&#x1f3fc;', '&#x1f3c3;&#x1f3fd;', '&#x1f3c3;&#x1f3fe;', '&#x1f3c3;&#x1f3ff;', '&#x1f3c4;&#x1f3fb;', '&#x1f3c4;&#x1f3fc;', '&#x1f3c4;&#x1f3fd;', '&#x1f3c4;&#x1f3fe;', '&#x1f3c4;&#x1f3ff;', '&#x1f3c7;&#x1f3fb;', '&#x1f3c7;&#x1f3fc;', '&#x1f3c7;&#x1f3fd;', '&#x1f3c7;&#x1f3fe;', '&#x1f3c7;&#x1f3ff;', '&#x1f3ca;&#x1f3fb;', '&#x1f3ca;&#x1f3fc;', '&#x1f3ca;&#x1f3fd;', '&#x1f3ca;&#x1f3fe;', '&#x1f3ca;&#x1f3ff;', '&#x1f3cb;&#x1f3fb;', '&#x1f3cb;&#x1f3fc;', '&#x1f3cb;&#x1f3fd;', '&#x1f3cb;&#x1f3fe;', '&#x1f3cb;&#x1f3ff;', '&#x1f3cc;&#x1f3fb;', '&#x1f3cc;&#x1f3fc;', '&#x1f3cc;&#x1f3fd;', '&#x1f3cc;&#x1f3fe;', '&#x1f3cc;&#x1f3ff;', '&#x1f442;&#x1f3fb;', '&#x1f442;&#x1f3fc;', '&#x1f442;&#x1f3fd;', '&#x1f442;&#x1f3fe;', '&#x1f442;&#x1f3ff;', '&#x1f443;&#x1f3fb;', '&#x1f443;&#x1f3fc;', '&#x1f443;&#x1f3fd;', '&#x1f443;&#x1f3fe;', '&#x1f443;&#x1f3ff;', '&#x1f446;&#x1f3fb;', '&#x1f446;&#x1f3fc;', '&#x1f446;&#x1f3fd;', '&#x1f446;&#x1f3fe;', '&#x1f446;&#x1f3ff;', '&#x1f447;&#x1f3fb;', '&#x1f447;&#x1f3fc;', '&#x1f447;&#x1f3fd;', '&#x1f447;&#x1f3fe;', '&#x1f447;&#x1f3ff;', '&#x1f448;&#x1f3fb;', '&#x1f448;&#x1f3fc;', '&#x1f448;&#x1f3fd;', '&#x1f448;&#x1f3fe;', '&#x1f448;&#x1f3ff;', '&#x1f449;&#x1f3fb;', '&#x1f449;&#x1f3fc;', '&#x1f449;&#x1f3fd;', '&#x1f449;&#x1f3fe;', '&#x1f449;&#x1f3ff;', '&#x1f44a;&#x1f3fb;', '&#x1f44a;&#x1f3fc;', '&#x1f44a;&#x1f3fd;', '&#x1f44a;&#x1f3fe;', '&#x1f44a;&#x1f3ff;', '&#x1f44b;&#x1f3fb;', '&#x1f44b;&#x1f3fc;', '&#x1f44b;&#x1f3fd;', '&#x1f44b;&#x1f3fe;', '&#x1f44b;&#x1f3ff;', '&#x1f44c;&#x1f3fb;', '&#x1f44c;&#x1f3fc;', '&#x1f44c;&#x1f3fd;', '&#x1f44c;&#x1f3fe;', '&#x1f44c;&#x1f3ff;', '&#x1f44d;&#x1f3fb;', '&#x1f44d;&#x1f3fc;', '&#x1f44d;&#x1f3fd;', '&#x1f44d;&#x1f3fe;', '&#x1f44d;&#x1f3ff;', '&#x1f44e;&#x1f3fb;', '&#x1f44e;&#x1f3fc;', '&#x1f44e;&#x1f3fd;', '&#x1f44e;&#x1f3fe;', '&#x1f44e;&#x1f3ff;', '&#x1f44f;&#x1f3fb;', '&#x1f44f;&#x1f3fc;', '&#x1f44f;&#x1f3fd;', '&#x1f44f;&#x1f3fe;', '&#x1f44f;&#x1f3ff;', '&#x1f450;&#x1f3fb;', '&#x1f450;&#x1f3fc;', '&#x1f450;&#x1f3fd;', '&#x1f450;&#x1f3fe;', '&#x1f450;&#x1f3ff;', '&#x1f466;&#x1f3fb;', '&#x1f466;&#x1f3fc;', '&#x1f466;&#x1f3fd;', '&#x1f466;&#x1f3fe;', '&#x1f466;&#x1f3ff;', '&#x1f467;&#x1f3fb;', '&#x1f467;&#x1f3fc;', '&#x1f467;&#x1f3fd;', '&#x1f467;&#x1f3fe;', '&#x1f467;&#x1f3ff;', '&#x1f468;&#x1f3fb;', '&#x1f468;&#x1f3fc;', '&#x1f468;&#x1f3fd;', '&#x1f468;&#x1f3fe;', '&#x1f468;&#x1f3ff;', '&#x1f469;&#x1f3fb;', '&#x1f469;&#x1f3fc;', '&#x1f469;&#x1f3fd;', '&#x1f469;&#x1f3fe;', '&#x1f469;&#x1f3ff;', '&#x1f46b;&#x1f3fb;', '&#x1f46b;&#x1f3fc;', '&#x1f46b;&#x1f3fd;', '&#x1f46b;&#x1f3fe;', '&#x1f46b;&#x1f3ff;', '&#x1f46c;&#x1f3fb;', '&#x1f46c;&#x1f3fc;', '&#x1f46c;&#x1f3fd;', '&#x1f46c;&#x1f3fe;', '&#x1f46c;&#x1f3ff;', '&#x1f46d;&#x1f3fb;', '&#x1f46d;&#x1f3fc;', '&#x1f46d;&#x1f3fd;', '&#x1f46d;&#x1f3fe;', '&#x1f46d;&#x1f3ff;', '&#x1f46e;&#x1f3fb;', '&#x1f46e;&#x1f3fc;', '&#x1f46e;&#x1f3fd;', '&#x1f46e;&#x1f3fe;', '&#x1f46e;&#x1f3ff;', '&#x1f470;&#x1f3fb;', '&#x1f470;&#x1f3fc;', '&#x1f470;&#x1f3fd;', '&#x1f470;&#x1f3fe;', '&#x1f470;&#x1f3ff;', '&#x1f471;&#x1f3fb;', '&#x1f471;&#x1f3fc;', '&#x1f471;&#x1f3fd;', '&#x1f471;&#x1f3fe;', '&#x1f471;&#x1f3ff;', '&#x1f472;&#x1f3fb;', '&#x1f472;&#x1f3fc;', '&#x1f472;&#x1f3fd;', '&#x1f472;&#x1f3fe;', '&#x1f472;&#x1f3ff;', '&#x1f473;&#x1f3fb;', '&#x1f473;&#x1f3fc;', '&#x1f473;&#x1f3fd;', '&#x1f473;&#x1f3fe;', '&#x1f473;&#x1f3ff;', '&#x1f474;&#x1f3fb;', '&#x1f474;&#x1f3fc;', '&#x1f474;&#x1f3fd;', '&#x1f474;&#x1f3fe;', '&#x1f474;&#x1f3ff;', '&#x1f475;&#x1f3fb;', '&#x1f475;&#x1f3fc;', '&#x1f475;&#x1f3fd;', '&#x1f475;&#x1f3fe;', '&#x1f475;&#x1f3ff;', '&#x1f476;&#x1f3fb;', '&#x1f476;&#x1f3fc;', '&#x1f476;&#x1f3fd;', '&#x1f476;&#x1f3fe;', '&#x1f476;&#x1f3ff;', '&#x1f477;&#x1f3fb;', '&#x1f477;&#x1f3fc;', '&#x1f477;&#x1f3fd;', '&#x1f477;&#x1f3fe;', '&#x1f477;&#x1f3ff;', '&#x1f478;&#x1f3fb;', '&#x1f478;&#x1f3fc;', '&#x1f478;&#x1f3fd;', '&#x1f478;&#x1f3fe;', '&#x1f478;&#x1f3ff;', '&#x1f47c;&#x1f3fb;', '&#x1f47c;&#x1f3fc;', '&#x1f47c;&#x1f3fd;', '&#x1f47c;&#x1f3fe;', '&#x1f47c;&#x1f3ff;', '&#x1f481;&#x1f3fb;', '&#x1f481;&#x1f3fc;', '&#x1f481;&#x1f3fd;', '&#x1f481;&#x1f3fe;', '&#x1f481;&#x1f3ff;', '&#x1f482;&#x1f3fb;', '&#x1f482;&#x1f3fc;', '&#x1f482;&#x1f3fd;', '&#x1f482;&#x1f3fe;', '&#x1f482;&#x1f3ff;', '&#x1f483;&#x1f3fb;', '&#x1f483;&#x1f3fc;', '&#x1f483;&#x1f3fd;', '&#x1f483;&#x1f3fe;', '&#x1f483;&#x1f3ff;', '&#x1f485;&#x1f3fb;', '&#x1f485;&#x1f3fc;', '&#x1f485;&#x1f3fd;', '&#x1f485;&#x1f3fe;', '&#x1f485;&#x1f3ff;', '&#x1f486;&#x1f3fb;', '&#x1f486;&#x1f3fc;', '&#x1f486;&#x1f3fd;', '&#x1f486;&#x1f3fe;', '&#x1f486;&#x1f3ff;', '&#x1f487;&#x1f3fb;', '&#x1f487;&#x1f3fc;', '&#x1f487;&#x1f3fd;', '&#x1f487;&#x1f3fe;', '&#x1f487;&#x1f3ff;', '&#x1f48f;&#x1f3fb;', '&#x1f48f;&#x1f3fc;', '&#x1f48f;&#x1f3fd;', '&#x1f48f;&#x1f3fe;', '&#x1f48f;&#x1f3ff;', '&#x1f491;&#x1f3fb;', '&#x1f491;&#x1f3fc;', '&#x1f491;&#x1f3fd;', '&#x1f491;&#x1f3fe;', '&#x1f491;&#x1f3ff;', '&#x1f4aa;&#x1f3fb;', '&#x1f4aa;&#x1f3fc;', '&#x1f4aa;&#x1f3fd;', '&#x1f4aa;&#x1f3fe;', '&#x1f4aa;&#x1f3ff;', '&#x1f574;&#x1f3fb;', '&#x1f574;&#x1f3fc;', '&#x1f574;&#x1f3fd;', '&#x1f574;&#x1f3fe;', '&#x1f574;&#x1f3ff;', '&#x1f575;&#x1f3fb;', '&#x1f575;&#x1f3fc;', '&#x1f575;&#x1f3fd;', '&#x1f575;&#x1f3fe;', '&#x1f575;&#x1f3ff;', '&#x1f57a;&#x1f3fb;', '&#x1f57a;&#x1f3fc;', '&#x1f57a;&#x1f3fd;', '&#x1f57a;&#x1f3fe;', '&#x1f57a;&#x1f3ff;', '&#x1f590;&#x1f3fb;', '&#x1f590;&#x1f3fc;', '&#x1f590;&#x1f3fd;', '&#x1f590;&#x1f3fe;', '&#x1f590;&#x1f3ff;', '&#x1f595;&#x1f3fb;', '&#x1f595;&#x1f3fc;', '&#x1f595;&#x1f3fd;', '&#x1f595;&#x1f3fe;', '&#x1f595;&#x1f3ff;', '&#x1f596;&#x1f3fb;', '&#x1f596;&#x1f3fc;', '&#x1f596;&#x1f3fd;', '&#x1f596;&#x1f3fe;', '&#x1f596;&#x1f3ff;', '&#x1f645;&#x1f3fb;', '&#x1f645;&#x1f3fc;', '&#x1f645;&#x1f3fd;', '&#x1f645;&#x1f3fe;', '&#x1f645;&#x1f3ff;', '&#x1f646;&#x1f3fb;', '&#x1f646;&#x1f3fc;', '&#x1f646;&#x1f3fd;', '&#x1f646;&#x1f3fe;', '&#x1f646;&#x1f3ff;', '&#x1f647;&#x1f3fb;', '&#x1f647;&#x1f3fc;', '&#x1f647;&#x1f3fd;', '&#x1f647;&#x1f3fe;', '&#x1f647;&#x1f3ff;', '&#x1f64b;&#x1f3fb;', '&#x1f64b;&#x1f3fc;', '&#x1f64b;&#x1f3fd;', '&#x1f64b;&#x1f3fe;', '&#x1f64b;&#x1f3ff;', '&#x1f64c;&#x1f3fb;', '&#x1f64c;&#x1f3fc;', '&#x1f64c;&#x1f3fd;', '&#x1f64c;&#x1f3fe;', '&#x1f64c;&#x1f3ff;', '&#x1f64d;&#x1f3fb;', '&#x1f64d;&#x1f3fc;', '&#x1f64d;&#x1f3fd;', '&#x1f64d;&#x1f3fe;', '&#x1f64d;&#x1f3ff;', '&#x1f64e;&#x1f3fb;', '&#x1f64e;&#x1f3fc;', '&#x1f64e;&#x1f3fd;', '&#x1f64e;&#x1f3fe;', '&#x1f64e;&#x1f3ff;', '&#x1f64f;&#x1f3fb;', '&#x1f64f;&#x1f3fc;', '&#x1f64f;&#x1f3fd;', '&#x1f64f;&#x1f3fe;', '&#x1f64f;&#x1f3ff;', '&#x1f6a3;&#x1f3fb;', '&#x1f6a3;&#x1f3fc;', '&#x1f6a3;&#x1f3fd;', '&#x1f6a3;&#x1f3fe;', '&#x1f6a3;&#x1f3ff;', '&#x1f6b4;&#x1f3fb;', '&#x1f6b4;&#x1f3fc;', '&#x1f6b4;&#x1f3fd;', '&#x1f6b4;&#x1f3fe;', '&#x1f6b4;&#x1f3ff;', '&#x1f6b5;&#x1f3fb;', '&#x1f6b5;&#x1f3fc;', '&#x1f6b5;&#x1f3fd;', '&#x1f6b5;&#x1f3fe;', '&#x1f6b5;&#x1f3ff;', '&#x1f6b6;&#x1f3fb;', '&#x1f6b6;&#x1f3fc;', '&#x1f6b6;&#x1f3fd;', '&#x1f6b6;&#x1f3fe;', '&#x1f6b6;&#x1f3ff;', '&#x1f6c0;&#x1f3fb;', '&#x1f6c0;&#x1f3fc;', '&#x1f6c0;&#x1f3fd;', '&#x1f6c0;&#x1f3fe;', '&#x1f6c0;&#x1f3ff;', '&#x1f6cc;&#x1f3fb;', '&#x1f6cc;&#x1f3fc;', '&#x1f6cc;&#x1f3fd;', '&#x1f6cc;&#x1f3fe;', '&#x1f6cc;&#x1f3ff;', '&#x1f90c;&#x1f3fb;', '&#x1f90c;&#x1f3fc;', '&#x1f90c;&#x1f3fd;', '&#x1f90c;&#x1f3fe;', '&#x1f90c;&#x1f3ff;', '&#x1f90f;&#x1f3fb;', '&#x1f90f;&#x1f3fc;', '&#x1f90f;&#x1f3fd;', '&#x1f90f;&#x1f3fe;', '&#x1f90f;&#x1f3ff;', '&#x1f918;&#x1f3fb;', '&#x1f918;&#x1f3fc;', '&#x1f918;&#x1f3fd;', '&#x1f918;&#x1f3fe;', '&#x1f918;&#x1f3ff;', '&#x1f919;&#x1f3fb;', '&#x1f919;&#x1f3fc;', '&#x1f919;&#x1f3fd;', '&#x1f919;&#x1f3fe;', '&#x1f919;&#x1f3ff;', '&#x1f91a;&#x1f3fb;', '&#x1f91a;&#x1f3fc;', '&#x1f91a;&#x1f3fd;', '&#x1f91a;&#x1f3fe;', '&#x1f91a;&#x1f3ff;', '&#x1f91b;&#x1f3fb;', '&#x1f91b;&#x1f3fc;', '&#x1f91b;&#x1f3fd;', '&#x1f91b;&#x1f3fe;', '&#x1f91b;&#x1f3ff;', '&#x1f91c;&#x1f3fb;', '&#x1f91c;&#x1f3fc;', '&#x1f91c;&#x1f3fd;', '&#x1f91c;&#x1f3fe;', '&#x1f91c;&#x1f3ff;', '&#x1f91e;&#x1f3fb;', '&#x1f91e;&#x1f3fc;', '&#x1f91e;&#x1f3fd;', '&#x1f91e;&#x1f3fe;', '&#x1f91e;&#x1f3ff;', '&#x1f91f;&#x1f3fb;', '&#x1f91f;&#x1f3fc;', '&#x1f91f;&#x1f3fd;', '&#x1f91f;&#x1f3fe;', '&#x1f91f;&#x1f3ff;', '&#x1f926;&#x1f3fb;', '&#x1f926;&#x1f3fc;', '&#x1f926;&#x1f3fd;', '&#x1f926;&#x1f3fe;', '&#x1f926;&#x1f3ff;', '&#x1f930;&#x1f3fb;', '&#x1f930;&#x1f3fc;', '&#x1f930;&#x1f3fd;', '&#x1f930;&#x1f3fe;', '&#x1f930;&#x1f3ff;', '&#x1f931;&#x1f3fb;', '&#x1f931;&#x1f3fc;', '&#x1f931;&#x1f3fd;', '&#x1f931;&#x1f3fe;', '&#x1f931;&#x1f3ff;', '&#x1f932;&#x1f3fb;', '&#x1f932;&#x1f3fc;', '&#x1f932;&#x1f3fd;', '&#x1f932;&#x1f3fe;', '&#x1f932;&#x1f3ff;', '&#x1f933;&#x1f3fb;', '&#x1f933;&#x1f3fc;', '&#x1f933;&#x1f3fd;', '&#x1f933;&#x1f3fe;', '&#x1f933;&#x1f3ff;', '&#x1f934;&#x1f3fb;', '&#x1f934;&#x1f3fc;', '&#x1f934;&#x1f3fd;', '&#x1f934;&#x1f3fe;', '&#x1f934;&#x1f3ff;', '&#x1f935;&#x1f3fb;', '&#x1f935;&#x1f3fc;', '&#x1f935;&#x1f3fd;', '&#x1f935;&#x1f3fe;', '&#x1f935;&#x1f3ff;', '&#x1f936;&#x1f3fb;', '&#x1f936;&#x1f3fc;', '&#x1f936;&#x1f3fd;', '&#x1f936;&#x1f3fe;', '&#x1f936;&#x1f3ff;', '&#x1f937;&#x1f3fb;', '&#x1f937;&#x1f3fc;', '&#x1f937;&#x1f3fd;', '&#x1f937;&#x1f3fe;', '&#x1f937;&#x1f3ff;', '&#x1f938;&#x1f3fb;', '&#x1f938;&#x1f3fc;', '&#x1f938;&#x1f3fd;', '&#x1f938;&#x1f3fe;', '&#x1f938;&#x1f3ff;', '&#x1f939;&#x1f3fb;', '&#x1f939;&#x1f3fc;', '&#x1f939;&#x1f3fd;', '&#x1f939;&#x1f3fe;', '&#x1f939;&#x1f3ff;', '&#x1f93d;&#x1f3fb;', '&#x1f93d;&#x1f3fc;', '&#x1f93d;&#x1f3fd;', '&#x1f93d;&#x1f3fe;', '&#x1f93d;&#x1f3ff;', '&#x1f93e;&#x1f3fb;', '&#x1f93e;&#x1f3fc;', '&#x1f93e;&#x1f3fd;', '&#x1f93e;&#x1f3fe;', '&#x1f93e;&#x1f3ff;', '&#x1f977;&#x1f3fb;', '&#x1f977;&#x1f3fc;', '&#x1f977;&#x1f3fd;', '&#x1f977;&#x1f3fe;', '&#x1f977;&#x1f3ff;', '&#x1f9b5;&#x1f3fb;', '&#x1f9b5;&#x1f3fc;', '&#x1f9b5;&#x1f3fd;', '&#x1f9b5;&#x1f3fe;', '&#x1f9b5;&#x1f3ff;', '&#x1f9b6;&#x1f3fb;', '&#x1f9b6;&#x1f3fc;', '&#x1f9b6;&#x1f3fd;', '&#x1f9b6;&#x1f3fe;', '&#x1f9b6;&#x1f3ff;', '&#x1f9b8;&#x1f3fb;', '&#x1f9b8;&#x1f3fc;', '&#x1f9b8;&#x1f3fd;', '&#x1f9b8;&#x1f3fe;', '&#x1f9b8;&#x1f3ff;', '&#x1f9b9;&#x1f3fb;', '&#x1f9b9;&#x1f3fc;', '&#x1f9b9;&#x1f3fd;', '&#x1f9b9;&#x1f3fe;', '&#x1f9b9;&#x1f3ff;', '&#x1f9bb;&#x1f3fb;', '&#x1f9bb;&#x1f3fc;', '&#x1f9bb;&#x1f3fd;', '&#x1f9bb;&#x1f3fe;', '&#x1f9bb;&#x1f3ff;', '&#x1f9cd;&#x1f3fb;', '&#x1f9cd;&#x1f3fc;', '&#x1f9cd;&#x1f3fd;', '&#x1f9cd;&#x1f3fe;', '&#x1f9cd;&#x1f3ff;', '&#x1f9ce;&#x1f3fb;', '&#x1f9ce;&#x1f3fc;', '&#x1f9ce;&#x1f3fd;', '&#x1f9ce;&#x1f3fe;', '&#x1f9ce;&#x1f3ff;', '&#x1f9cf;&#x1f3fb;', '&#x1f9cf;&#x1f3fc;', '&#x1f9cf;&#x1f3fd;', '&#x1f9cf;&#x1f3fe;', '&#x1f9cf;&#x1f3ff;', '&#x1f9d1;&#x1f3fb;', '&#x1f9d1;&#x1f3fc;', '&#x1f9d1;&#x1f3fd;', '&#x1f9d1;&#x1f3fe;', '&#x1f9d1;&#x1f3ff;', '&#x1f9d2;&#x1f3fb;', '&#x1f9d2;&#x1f3fc;', '&#x1f9d2;&#x1f3fd;', '&#x1f9d2;&#x1f3fe;', '&#x1f9d2;&#x1f3ff;', '&#x1f9d3;&#x1f3fb;', '&#x1f9d3;&#x1f3fc;', '&#x1f9d3;&#x1f3fd;', '&#x1f9d3;&#x1f3fe;', '&#x1f9d3;&#x1f3ff;', '&#x1f9d4;&#x1f3fb;', '&#x1f9d4;&#x1f3fc;', '&#x1f9d4;&#x1f3fd;', '&#x1f9d4;&#x1f3fe;', '&#x1f9d4;&#x1f3ff;', '&#x1f9d5;&#x1f3fb;', '&#x1f9d5;&#x1f3fc;', '&#x1f9d5;&#x1f3fd;', '&#x1f9d5;&#x1f3fe;', '&#x1f9d5;&#x1f3ff;', '&#x1f9d6;&#x1f3fb;', '&#x1f9d6;&#x1f3fc;', '&#x1f9d6;&#x1f3fd;', '&#x1f9d6;&#x1f3fe;', '&#x1f9d6;&#x1f3ff;', '&#x1f9d7;&#x1f3fb;', '&#x1f9d7;&#x1f3fc;', '&#x1f9d7;&#x1f3fd;', '&#x1f9d7;&#x1f3fe;', '&#x1f9d7;&#x1f3ff;', '&#x1f9d8;&#x1f3fb;', '&#x1f9d8;&#x1f3fc;', '&#x1f9d8;&#x1f3fd;', '&#x1f9d8;&#x1f3fe;', '&#x1f9d8;&#x1f3ff;', '&#x1f9d9;&#x1f3fb;', '&#x1f9d9;&#x1f3fc;', '&#x1f9d9;&#x1f3fd;', '&#x1f9d9;&#x1f3fe;', '&#x1f9d9;&#x1f3ff;', '&#x1f9da;&#x1f3fb;', '&#x1f9da;&#x1f3fc;', '&#x1f9da;&#x1f3fd;', '&#x1f9da;&#x1f3fe;', '&#x1f9da;&#x1f3ff;', '&#x1f9db;&#x1f3fb;', '&#x1f9db;&#x1f3fc;', '&#x1f9db;&#x1f3fd;', '&#x1f9db;&#x1f3fe;', '&#x1f9db;&#x1f3ff;', '&#x1f9dc;&#x1f3fb;', '&#x1f9dc;&#x1f3fc;', '&#x1f9dc;&#x1f3fd;', '&#x1f9dc;&#x1f3fe;', '&#x1f9dc;&#x1f3ff;', '&#x1f9dd;&#x1f3fb;', '&#x1f9dd;&#x1f3fc;', '&#x1f9dd;&#x1f3fd;', '&#x1f9dd;&#x1f3fe;', '&#x1f9dd;&#x1f3ff;', '&#x261d;&#x1f3fb;', '&#x261d;&#x1f3fc;', '&#x261d;&#x1f3fd;', '&#x261d;&#x1f3fe;', '&#x261d;&#x1f3ff;', '&#x26f7;&#x1f3fb;', '&#x26f7;&#x1f3fc;', '&#x26f7;&#x1f3fd;', '&#x26f7;&#x1f3fe;', '&#x26f7;&#x1f3ff;', '&#x26f9;&#x1f3fb;', '&#x26f9;&#x1f3fc;', '&#x26f9;&#x1f3fd;', '&#x26f9;&#x1f3fe;', '&#x26f9;&#x1f3ff;', '&#x270a;&#x1f3fb;', '&#x270a;&#x1f3fc;', '&#x270a;&#x1f3fd;', '&#x270a;&#x1f3fe;', '&#x270a;&#x1f3ff;', '&#x270b;&#x1f3fb;', '&#x270b;&#x1f3fc;', '&#x270b;&#x1f3fd;', '&#x270b;&#x1f3fe;', '&#x270b;&#x1f3ff;', '&#x270c;&#x1f3fb;', '&#x270c;&#x1f3fc;', '&#x270c;&#x1f3fd;', '&#x270c;&#x1f3fe;', '&#x270c;&#x1f3ff;', '&#x270d;&#x1f3fb;', '&#x270d;&#x1f3fc;', '&#x270d;&#x1f3fd;', '&#x270d;&#x1f3fe;', '&#x270d;&#x1f3ff;', '&#x23;&#x20e3;', '&#x2a;&#x20e3;', '&#x30;&#x20e3;', '&#x31;&#x20e3;', '&#x32;&#x20e3;', '&#x33;&#x20e3;', '&#x34;&#x20e3;', '&#x35;&#x20e3;', '&#x36;&#x20e3;', '&#x37;&#x20e3;', '&#x38;&#x20e3;', '&#x39;&#x20e3;', '&#x1f004;', '&#x1f0cf;', '&#x1f170;', '&#x1f171;', '&#x1f17e;', '&#x1f17f;', '&#x1f18e;', '&#x1f191;', '&#x1f192;', '&#x1f193;', '&#x1f194;', '&#x1f195;', '&#x1f196;', '&#x1f197;', '&#x1f198;', '&#x1f199;', '&#x1f19a;', '&#x1f1e6;', '&#x1f1e7;', '&#x1f1e8;', '&#x1f1e9;', '&#x1f1ea;', '&#x1f1eb;', '&#x1f1ec;', '&#x1f1ed;', '&#x1f1ee;', '&#x1f1ef;', '&#x1f1f0;', '&#x1f1f1;', '&#x1f1f2;', '&#x1f1f3;', '&#x1f1f4;', '&#x1f1f5;', '&#x1f1f6;', '&#x1f1f7;', '&#x1f1f8;', '&#x1f1f9;', '&#x1f1fa;', '&#x1f1fb;', '&#x1f1fc;', '&#x1f1fd;', '&#x1f1fe;', '&#x1f1ff;', '&#x1f201;', '&#x1f202;', '&#x1f21a;', '&#x1f22f;', '&#x1f232;', '&#x1f233;', '&#x1f234;', '&#x1f235;', '&#x1f236;', '&#x1f237;', '&#x1f238;', '&#x1f239;', '&#x1f23a;', '&#x1f250;', '&#x1f251;', '&#x1f300;', '&#x1f301;', '&#x1f302;', '&#x1f303;', '&#x1f304;', '&#x1f305;', '&#x1f306;', '&#x1f307;', '&#x1f308;', '&#x1f309;', '&#x1f30a;', '&#x1f30b;', '&#x1f30c;', '&#x1f30d;', '&#x1f30e;', '&#x1f30f;', '&#x1f310;', '&#x1f311;', '&#x1f312;', '&#x1f313;', '&#x1f314;', '&#x1f315;', '&#x1f316;', '&#x1f317;', '&#x1f318;', '&#x1f319;', '&#x1f31a;', '&#x1f31b;', '&#x1f31c;', '&#x1f31d;', '&#x1f31e;', '&#x1f31f;', '&#x1f320;', '&#x1f321;', '&#x1f324;', '&#x1f325;', '&#x1f326;', '&#x1f327;', '&#x1f328;', '&#x1f329;', '&#x1f32a;', '&#x1f32b;', '&#x1f32c;', '&#x1f32d;', '&#x1f32e;', '&#x1f32f;', '&#x1f330;', '&#x1f331;', '&#x1f332;', '&#x1f333;', '&#x1f334;', '&#x1f335;', '&#x1f336;', '&#x1f337;', '&#x1f338;', '&#x1f339;', '&#x1f33a;', '&#x1f33b;', '&#x1f33c;', '&#x1f33d;', '&#x1f33e;', '&#x1f33f;', '&#x1f340;', '&#x1f341;', '&#x1f342;', '&#x1f343;', '&#x1f344;', '&#x1f345;', '&#x1f346;', '&#x1f347;', '&#x1f348;', '&#x1f349;', '&#x1f34a;', '&#x1f34b;', '&#x1f34c;', '&#x1f34d;', '&#x1f34e;', '&#x1f34f;', '&#x1f350;', '&#x1f351;', '&#x1f352;', '&#x1f353;', '&#x1f354;', '&#x1f355;', '&#x1f356;', '&#x1f357;', '&#x1f358;', '&#x1f359;', '&#x1f35a;', '&#x1f35b;', '&#x1f35c;', '&#x1f35d;', '&#x1f35e;', '&#x1f35f;', '&#x1f360;', '&#x1f361;', '&#x1f362;', '&#x1f363;', '&#x1f364;', '&#x1f365;', '&#x1f366;', '&#x1f367;', '&#x1f368;', '&#x1f369;', '&#x1f36a;', '&#x1f36b;', '&#x1f36c;', '&#x1f36d;', '&#x1f36e;', '&#x1f36f;', '&#x1f370;', '&#x1f371;', '&#x1f372;', '&#x1f373;', '&#x1f374;', '&#x1f375;', '&#x1f376;', '&#x1f377;', '&#x1f378;', '&#x1f379;', '&#x1f37a;', '&#x1f37b;', '&#x1f37c;', '&#x1f37d;', '&#x1f37e;', '&#x1f37f;', '&#x1f380;', '&#x1f381;', '&#x1f382;', '&#x1f383;', '&#x1f384;', '&#x1f385;', '&#x1f386;', '&#x1f387;', '&#x1f388;', '&#x1f389;', '&#x1f38a;', '&#x1f38b;', '&#x1f38c;', '&#x1f38d;', '&#x1f38e;', '&#x1f38f;', '&#x1f390;', '&#x1f391;', '&#x1f392;', '&#x1f393;', '&#x1f396;', '&#x1f397;', '&#x1f399;', '&#x1f39a;', '&#x1f39b;', '&#x1f39e;', '&#x1f39f;', '&#x1f3a0;', '&#x1f3a1;', '&#x1f3a2;', '&#x1f3a3;', '&#x1f3a4;', '&#x1f3a5;', '&#x1f3a6;', '&#x1f3a7;', '&#x1f3a8;', '&#x1f3a9;', '&#x1f3aa;', '&#x1f3ab;', '&#x1f3ac;', '&#x1f3ad;', '&#x1f3ae;', '&#x1f3af;', '&#x1f3b0;', '&#x1f3b1;', '&#x1f3b2;', '&#x1f3b3;', '&#x1f3b4;', '&#x1f3b5;', '&#x1f3b6;', '&#x1f3b7;', '&#x1f3b8;', '&#x1f3b9;', '&#x1f3ba;', '&#x1f3bb;', '&#x1f3bc;', '&#x1f3bd;', '&#x1f3be;', '&#x1f3bf;', '&#x1f3c0;', '&#x1f3c1;', '&#x1f3c2;', '&#x1f3c3;', '&#x1f3c4;', '&#x1f3c5;', '&#x1f3c6;', '&#x1f3c7;', '&#x1f3c8;', '&#x1f3c9;', '&#x1f3ca;', '&#x1f3cb;', '&#x1f3cc;', '&#x1f3cd;', '&#x1f3ce;', '&#x1f3cf;', '&#x1f3d0;', '&#x1f3d1;', '&#x1f3d2;', '&#x1f3d3;', '&#x1f3d4;', '&#x1f3d5;', '&#x1f3d6;', '&#x1f3d7;', '&#x1f3d8;', '&#x1f3d9;', '&#x1f3da;', '&#x1f3db;', '&#x1f3dc;', '&#x1f3dd;', '&#x1f3de;', '&#x1f3df;', '&#x1f3e0;', '&#x1f3e1;', '&#x1f3e2;', '&#x1f3e3;', '&#x1f3e4;', '&#x1f3e5;', '&#x1f3e6;', '&#x1f3e7;', '&#x1f3e8;', '&#x1f3e9;', '&#x1f3ea;', '&#x1f3eb;', '&#x1f3ec;', '&#x1f3ed;', '&#x1f3ee;', '&#x1f3ef;', '&#x1f3f0;', '&#x1f3f3;', '&#x1f3f4;', '&#x1f3f5;', '&#x1f3f7;', '&#x1f3f8;', '&#x1f3f9;', '&#x1f3fa;', '&#x1f3fb;', '&#x1f3fc;', '&#x1f3fd;', '&#x1f3fe;', '&#x1f3ff;', '&#x1f400;', '&#x1f401;', '&#x1f402;', '&#x1f403;', '&#x1f404;', '&#x1f405;', '&#x1f406;', '&#x1f407;', '&#x1f408;', '&#x1f409;', '&#x1f40a;', '&#x1f40b;', '&#x1f40c;', '&#x1f40d;', '&#x1f40e;', '&#x1f40f;', '&#x1f410;', '&#x1f411;', '&#x1f412;', '&#x1f413;', '&#x1f414;', '&#x1f415;', '&#x1f416;', '&#x1f417;', '&#x1f418;', '&#x1f419;', '&#x1f41a;', '&#x1f41b;', '&#x1f41c;', '&#x1f41d;', '&#x1f41e;', '&#x1f41f;', '&#x1f420;', '&#x1f421;', '&#x1f422;', '&#x1f423;', '&#x1f424;', '&#x1f425;', '&#x1f426;', '&#x1f427;', '&#x1f428;', '&#x1f429;', '&#x1f42a;', '&#x1f42b;', '&#x1f42c;', '&#x1f42d;', '&#x1f42e;', '&#x1f42f;', '&#x1f430;', '&#x1f431;', '&#x1f432;', '&#x1f433;', '&#x1f434;', '&#x1f435;', '&#x1f436;', '&#x1f437;', '&#x1f438;', '&#x1f439;', '&#x1f43a;', '&#x1f43b;', '&#x1f43c;', '&#x1f43d;', '&#x1f43e;', '&#x1f43f;', '&#x1f440;', '&#x1f441;', '&#x1f442;', '&#x1f443;', '&#x1f444;', '&#x1f445;', '&#x1f446;', '&#x1f447;', '&#x1f448;', '&#x1f449;', '&#x1f44a;', '&#x1f44b;', '&#x1f44c;', '&#x1f44d;', '&#x1f44e;', '&#x1f44f;', '&#x1f450;', '&#x1f451;', '&#x1f452;', '&#x1f453;', '&#x1f454;', '&#x1f455;', '&#x1f456;', '&#x1f457;', '&#x1f458;', '&#x1f459;', '&#x1f45a;', '&#x1f45b;', '&#x1f45c;', '&#x1f45d;', '&#x1f45e;', '&#x1f45f;', '&#x1f460;', '&#x1f461;', '&#x1f462;', '&#x1f463;', '&#x1f464;', '&#x1f465;', '&#x1f466;', '&#x1f467;', '&#x1f468;', '&#x1f469;', '&#x1f46a;', '&#x1f46b;', '&#x1f46c;', '&#x1f46d;', '&#x1f46e;', '&#x1f46f;', '&#x1f470;', '&#x1f471;', '&#x1f472;', '&#x1f473;', '&#x1f474;', '&#x1f475;', '&#x1f476;', '&#x1f477;', '&#x1f478;', '&#x1f479;', '&#x1f47a;', '&#x1f47b;', '&#x1f47c;', '&#x1f47d;', '&#x1f47e;', '&#x1f47f;', '&#x1f480;', '&#x1f481;', '&#x1f482;', '&#x1f483;', '&#x1f484;', '&#x1f485;', '&#x1f486;', '&#x1f487;', '&#x1f488;', '&#x1f489;', '&#x1f48a;', '&#x1f48b;', '&#x1f48c;', '&#x1f48d;', '&#x1f48e;', '&#x1f48f;', '&#x1f490;', '&#x1f491;', '&#x1f492;', '&#x1f493;', '&#x1f494;', '&#x1f495;', '&#x1f496;', '&#x1f497;', '&#x1f498;', '&#x1f499;', '&#x1f49a;', '&#x1f49b;', '&#x1f49c;', '&#x1f49d;', '&#x1f49e;', '&#x1f49f;', '&#x1f4a0;', '&#x1f4a1;', '&#x1f4a2;', '&#x1f4a3;', '&#x1f4a4;', '&#x1f4a5;', '&#x1f4a6;', '&#x1f4a7;', '&#x1f4a8;', '&#x1f4a9;', '&#x1f4aa;', '&#x1f4ab;', '&#x1f4ac;', '&#x1f4ad;', '&#x1f4ae;', '&#x1f4af;', '&#x1f4b0;', '&#x1f4b1;', '&#x1f4b2;', '&#x1f4b3;', '&#x1f4b4;', '&#x1f4b5;', '&#x1f4b6;', '&#x1f4b7;', '&#x1f4b8;', '&#x1f4b9;', '&#x1f4ba;', '&#x1f4bb;', '&#x1f4bc;', '&#x1f4bd;', '&#x1f4be;', '&#x1f4bf;', '&#x1f4c0;', '&#x1f4c1;', '&#x1f4c2;', '&#x1f4c3;', '&#x1f4c4;', '&#x1f4c5;', '&#x1f4c6;', '&#x1f4c7;', '&#x1f4c8;', '&#x1f4c9;', '&#x1f4ca;', '&#x1f4cb;', '&#x1f4cc;', '&#x1f4cd;', '&#x1f4ce;', '&#x1f4cf;', '&#x1f4d0;', '&#x1f4d1;', '&#x1f4d2;', '&#x1f4d3;', '&#x1f4d4;', '&#x1f4d5;', '&#x1f4d6;', '&#x1f4d7;', '&#x1f4d8;', '&#x1f4d9;', '&#x1f4da;', '&#x1f4db;', '&#x1f4dc;', '&#x1f4dd;', '&#x1f4de;', '&#x1f4df;', '&#x1f4e0;', '&#x1f4e1;', '&#x1f4e2;', '&#x1f4e3;', '&#x1f4e4;', '&#x1f4e5;', '&#x1f4e6;', '&#x1f4e7;', '&#x1f4e8;', '&#x1f4e9;', '&#x1f4ea;', '&#x1f4eb;', '&#x1f4ec;', '&#x1f4ed;', '&#x1f4ee;', '&#x1f4ef;', '&#x1f4f0;', '&#x1f4f1;', '&#x1f4f2;', '&#x1f4f3;', '&#x1f4f4;', '&#x1f4f5;', '&#x1f4f6;', '&#x1f4f7;', '&#x1f4f8;', '&#x1f4f9;', '&#x1f4fa;', '&#x1f4fb;', '&#x1f4fc;', '&#x1f4fd;', '&#x1f4ff;', '&#x1f500;', '&#x1f501;', '&#x1f502;', '&#x1f503;', '&#x1f504;', '&#x1f505;', '&#x1f506;', '&#x1f507;', '&#x1f508;', '&#x1f509;', '&#x1f50a;', '&#x1f50b;', '&#x1f50c;', '&#x1f50d;', '&#x1f50e;', '&#x1f50f;', '&#x1f510;', '&#x1f511;', '&#x1f512;', '&#x1f513;', '&#x1f514;', '&#x1f515;', '&#x1f516;', '&#x1f517;', '&#x1f518;', '&#x1f519;', '&#x1f51a;', '&#x1f51b;', '&#x1f51c;', '&#x1f51d;', '&#x1f51e;', '&#x1f51f;', '&#x1f520;', '&#x1f521;', '&#x1f522;', '&#x1f523;', '&#x1f524;', '&#x1f525;', '&#x1f526;', '&#x1f527;', '&#x1f528;', '&#x1f529;', '&#x1f52a;', '&#x1f52b;', '&#x1f52c;', '&#x1f52d;', '&#x1f52e;', '&#x1f52f;', '&#x1f530;', '&#x1f531;', '&#x1f532;', '&#x1f533;', '&#x1f534;', '&#x1f535;', '&#x1f536;', '&#x1f537;', '&#x1f538;', '&#x1f539;', '&#x1f53a;', '&#x1f53b;', '&#x1f53c;', '&#x1f53d;', '&#x1f549;', '&#x1f54a;', '&#x1f54b;', '&#x1f54c;', '&#x1f54d;', '&#x1f54e;', '&#x1f550;', '&#x1f551;', '&#x1f552;', '&#x1f553;', '&#x1f554;', '&#x1f555;', '&#x1f556;', '&#x1f557;', '&#x1f558;', '&#x1f559;', '&#x1f55a;', '&#x1f55b;', '&#x1f55c;', '&#x1f55d;', '&#x1f55e;', '&#x1f55f;', '&#x1f560;', '&#x1f561;', '&#x1f562;', '&#x1f563;', '&#x1f564;', '&#x1f565;', '&#x1f566;', '&#x1f567;', '&#x1f56f;', '&#x1f570;', '&#x1f573;', '&#x1f574;', '&#x1f575;', '&#x1f576;', '&#x1f577;', '&#x1f578;', '&#x1f579;', '&#x1f57a;', '&#x1f587;', '&#x1f58a;', '&#x1f58b;', '&#x1f58c;', '&#x1f58d;', '&#x1f590;', '&#x1f595;', '&#x1f596;', '&#x1f5a4;', '&#x1f5a5;', '&#x1f5a8;', '&#x1f5b1;', '&#x1f5b2;', '&#x1f5bc;', '&#x1f5c2;', '&#x1f5c3;', '&#x1f5c4;', '&#x1f5d1;', '&#x1f5d2;', '&#x1f5d3;', '&#x1f5dc;', '&#x1f5dd;', '&#x1f5de;', '&#x1f5e1;', '&#x1f5e3;', '&#x1f5e8;', '&#x1f5ef;', '&#x1f5f3;', '&#x1f5fa;', '&#x1f5fb;', '&#x1f5fc;', '&#x1f5fd;', '&#x1f5fe;', '&#x1f5ff;', '&#x1f600;', '&#x1f601;', '&#x1f602;', '&#x1f603;', '&#x1f604;', '&#x1f605;', '&#x1f606;', '&#x1f607;', '&#x1f608;', '&#x1f609;', '&#x1f60a;', '&#x1f60b;', '&#x1f60c;', '&#x1f60d;', '&#x1f60e;', '&#x1f60f;', '&#x1f610;', '&#x1f611;', '&#x1f612;', '&#x1f613;', '&#x1f614;', '&#x1f615;', '&#x1f616;', '&#x1f617;', '&#x1f618;', '&#x1f619;', '&#x1f61a;', '&#x1f61b;', '&#x1f61c;', '&#x1f61d;', '&#x1f61e;', '&#x1f61f;', '&#x1f620;', '&#x1f621;', '&#x1f622;', '&#x1f623;', '&#x1f624;', '&#x1f625;', '&#x1f626;', '&#x1f627;', '&#x1f628;', '&#x1f629;', '&#x1f62a;', '&#x1f62b;', '&#x1f62c;', '&#x1f62d;', '&#x1f62e;', '&#x1f62f;', '&#x1f630;', '&#x1f631;', '&#x1f632;', '&#x1f633;', '&#x1f634;', '&#x1f635;', '&#x1f636;', '&#x1f637;', '&#x1f638;', '&#x1f639;', '&#x1f63a;', '&#x1f63b;', '&#x1f63c;', '&#x1f63d;', '&#x1f63e;', '&#x1f63f;', '&#x1f640;', '&#x1f641;', '&#x1f642;', '&#x1f643;', '&#x1f644;', '&#x1f645;', '&#x1f646;', '&#x1f647;', '&#x1f648;', '&#x1f649;', '&#x1f64a;', '&#x1f64b;', '&#x1f64c;', '&#x1f64d;', '&#x1f64e;', '&#x1f64f;', '&#x1f680;', '&#x1f681;', '&#x1f682;', '&#x1f683;', '&#x1f684;', '&#x1f685;', '&#x1f686;', '&#x1f687;', '&#x1f688;', '&#x1f689;', '&#x1f68a;', '&#x1f68b;', '&#x1f68c;', '&#x1f68d;', '&#x1f68e;', '&#x1f68f;', '&#x1f690;', '&#x1f691;', '&#x1f692;', '&#x1f693;', '&#x1f694;', '&#x1f695;', '&#x1f696;', '&#x1f697;', '&#x1f698;', '&#x1f699;', '&#x1f69a;', '&#x1f69b;', '&#x1f69c;', '&#x1f69d;', '&#x1f69e;', '&#x1f69f;', '&#x1f6a0;', '&#x1f6a1;', '&#x1f6a2;', '&#x1f6a3;', '&#x1f6a4;', '&#x1f6a5;', '&#x1f6a6;', '&#x1f6a7;', '&#x1f6a8;', '&#x1f6a9;', '&#x1f6aa;', '&#x1f6ab;', '&#x1f6ac;', '&#x1f6ad;', '&#x1f6ae;', '&#x1f6af;', '&#x1f6b0;', '&#x1f6b1;', '&#x1f6b2;', '&#x1f6b3;', '&#x1f6b4;', '&#x1f6b5;', '&#x1f6b6;', '&#x1f6b7;', '&#x1f6b8;', '&#x1f6b9;', '&#x1f6ba;', '&#x1f6bb;', '&#x1f6bc;', '&#x1f6bd;', '&#x1f6be;', '&#x1f6bf;', '&#x1f6c0;', '&#x1f6c1;', '&#x1f6c2;', '&#x1f6c3;', '&#x1f6c4;', '&#x1f6c5;', '&#x1f6cb;', '&#x1f6cc;', '&#x1f6cd;', '&#x1f6ce;', '&#x1f6cf;', '&#x1f6d0;', '&#x1f6d1;', '&#x1f6d2;', '&#x1f6d5;', '&#x1f6d6;', '&#x1f6d7;', '&#x1f6e0;', '&#x1f6e1;', '&#x1f6e2;', '&#x1f6e3;', '&#x1f6e4;', '&#x1f6e5;', '&#x1f6e9;', '&#x1f6eb;', '&#x1f6ec;', '&#x1f6f0;', '&#x1f6f3;', '&#x1f6f4;', '&#x1f6f5;', '&#x1f6f6;', '&#x1f6f7;', '&#x1f6f8;', '&#x1f6f9;', '&#x1f6fa;', '&#x1f6fb;', '&#x1f6fc;', '&#x1f7e0;', '&#x1f7e1;', '&#x1f7e2;', '&#x1f7e3;', '&#x1f7e4;', '&#x1f7e5;', '&#x1f7e6;', '&#x1f7e7;', '&#x1f7e8;', '&#x1f7e9;', '&#x1f7ea;', '&#x1f7eb;', '&#x1f90c;', '&#x1f90d;', '&#x1f90e;', '&#x1f90f;', '&#x1f910;', '&#x1f911;', '&#x1f912;', '&#x1f913;', '&#x1f914;', '&#x1f915;', '&#x1f916;', '&#x1f917;', '&#x1f918;', '&#x1f919;', '&#x1f91a;', '&#x1f91b;', '&#x1f91c;', '&#x1f91d;', '&#x1f91e;', '&#x1f91f;', '&#x1f920;', '&#x1f921;', '&#x1f922;', '&#x1f923;', '&#x1f924;', '&#x1f925;', '&#x1f926;', '&#x1f927;', '&#x1f928;', '&#x1f929;', '&#x1f92a;', '&#x1f92b;', '&#x1f92c;', '&#x1f92d;', '&#x1f92e;', '&#x1f92f;', '&#x1f930;', '&#x1f931;', '&#x1f932;', '&#x1f933;', '&#x1f934;', '&#x1f935;', '&#x1f936;', '&#x1f937;', '&#x1f938;', '&#x1f939;', '&#x1f93a;', '&#x1f93c;', '&#x1f93d;', '&#x1f93e;', '&#x1f93f;', '&#x1f940;', '&#x1f941;', '&#x1f942;', '&#x1f943;', '&#x1f944;', '&#x1f945;', '&#x1f947;', '&#x1f948;', '&#x1f949;', '&#x1f94a;', '&#x1f94b;', '&#x1f94c;', '&#x1f94d;', '&#x1f94e;', '&#x1f94f;', '&#x1f950;', '&#x1f951;', '&#x1f952;', '&#x1f953;', '&#x1f954;', '&#x1f955;', '&#x1f956;', '&#x1f957;', '&#x1f958;', '&#x1f959;', '&#x1f95a;', '&#x1f95b;', '&#x1f95c;', '&#x1f95d;', '&#x1f95e;', '&#x1f95f;', '&#x1f960;', '&#x1f961;', '&#x1f962;', '&#x1f963;', '&#x1f964;', '&#x1f965;', '&#x1f966;', '&#x1f967;', '&#x1f968;', '&#x1f969;', '&#x1f96a;', '&#x1f96b;', '&#x1f96c;', '&#x1f96d;', '&#x1f96e;', '&#x1f96f;', '&#x1f970;', '&#x1f971;', '&#x1f972;', '&#x1f973;', '&#x1f974;', '&#x1f975;', '&#x1f976;', '&#x1f977;', '&#x1f978;', '&#x1f97a;', '&#x1f97b;', '&#x1f97c;', '&#x1f97d;', '&#x1f97e;', '&#x1f97f;', '&#x1f980;', '&#x1f981;', '&#x1f982;', '&#x1f983;', '&#x1f984;', '&#x1f985;', '&#x1f986;', '&#x1f987;', '&#x1f988;', '&#x1f989;', '&#x1f98a;', '&#x1f98b;', '&#x1f98c;', '&#x1f98d;', '&#x1f98e;', '&#x1f98f;', '&#x1f990;', '&#x1f991;', '&#x1f992;', '&#x1f993;', '&#x1f994;', '&#x1f995;', '&#x1f996;', '&#x1f997;', '&#x1f998;', '&#x1f999;', '&#x1f99a;', '&#x1f99b;', '&#x1f99c;', '&#x1f99d;', '&#x1f99e;', '&#x1f99f;', '&#x1f9a0;', '&#x1f9a1;', '&#x1f9a2;', '&#x1f9a3;', '&#x1f9a4;', '&#x1f9a5;', '&#x1f9a6;', '&#x1f9a7;', '&#x1f9a8;', '&#x1f9a9;', '&#x1f9aa;', '&#x1f9ab;', '&#x1f9ac;', '&#x1f9ad;', '&#x1f9ae;', '&#x1f9af;', '&#x1f9b0;', '&#x1f9b1;', '&#x1f9b2;', '&#x1f9b3;', '&#x1f9b4;', '&#x1f9b5;', '&#x1f9b6;', '&#x1f9b7;', '&#x1f9b8;', '&#x1f9b9;', '&#x1f9ba;', '&#x1f9bb;', '&#x1f9bc;', '&#x1f9bd;', '&#x1f9be;', '&#x1f9bf;', '&#x1f9c0;', '&#x1f9c1;', '&#x1f9c2;', '&#x1f9c3;', '&#x1f9c4;', '&#x1f9c5;', '&#x1f9c6;', '&#x1f9c7;', '&#x1f9c8;', '&#x1f9c9;', '&#x1f9ca;', '&#x1f9cb;', '&#x1f9cd;', '&#x1f9ce;', '&#x1f9cf;', '&#x1f9d0;', '&#x1f9d1;', '&#x1f9d2;', '&#x1f9d3;', '&#x1f9d4;', '&#x1f9d5;', '&#x1f9d6;', '&#x1f9d7;', '&#x1f9d8;', '&#x1f9d9;', '&#x1f9da;', '&#x1f9db;', '&#x1f9dc;', '&#x1f9dd;', '&#x1f9de;', '&#x1f9df;', '&#x1f9e0;', '&#x1f9e1;', '&#x1f9e2;', '&#x1f9e3;', '&#x1f9e4;', '&#x1f9e5;', '&#x1f9e6;', '&#x1f9e7;', '&#x1f9e8;', '&#x1f9e9;', '&#x1f9ea;', '&#x1f9eb;', '&#x1f9ec;', '&#x1f9ed;', '&#x1f9ee;', '&#x1f9ef;', '&#x1f9f0;', '&#x1f9f1;', '&#x1f9f2;', '&#x1f9f3;', '&#x1f9f4;', '&#x1f9f5;', '&#x1f9f6;', '&#x1f9f7;', '&#x1f9f8;', '&#x1f9f9;', '&#x1f9fa;', '&#x1f9fb;', '&#x1f9fc;', '&#x1f9fd;', '&#x1f9fe;', '&#x1f9ff;', '&#x1fa70;', '&#x1fa71;', '&#x1fa72;', '&#x1fa73;', '&#x1fa74;', '&#x1fa78;', '&#x1fa79;', '&#x1fa7a;', '&#x1fa80;', '&#x1fa81;', '&#x1fa82;', '&#x1fa83;', '&#x1fa84;', '&#x1fa85;', '&#x1fa86;', '&#x1fa90;', '&#x1fa91;', '&#x1fa92;', '&#x1fa93;', '&#x1fa94;', '&#x1fa95;', '&#x1fa96;', '&#x1fa97;', '&#x1fa98;', '&#x1fa99;', '&#x1fa9a;', '&#x1fa9b;', '&#x1fa9c;', '&#x1fa9d;', '&#x1fa9e;', '&#x1fa9f;', '&#x1faa0;', '&#x1faa1;', '&#x1faa2;', '&#x1faa3;', '&#x1faa4;', '&#x1faa5;', '&#x1faa6;', '&#x1faa7;', '&#x1faa8;', '&#x1fab0;', '&#x1fab1;', '&#x1fab2;', '&#x1fab3;', '&#x1fab4;', '&#x1fab5;', '&#x1fab6;', '&#x1fac0;', '&#x1fac1;', '&#x1fac2;', '&#x1fad0;', '&#x1fad1;', '&#x1fad2;', '&#x1fad3;', '&#x1fad4;', '&#x1fad5;', '&#x1fad6;', '&#x203c;', '&#x2049;', '&#x2122;', '&#x2139;', '&#x2194;', '&#x2195;', '&#x2196;', '&#x2197;', '&#x2198;', '&#x2199;', '&#x21a9;', '&#x21aa;', '&#x231a;', '&#x231b;', '&#x2328;', '&#x23cf;', '&#x23e9;', '&#x23ea;', '&#x23eb;', '&#x23ec;', '&#x23ed;', '&#x23ee;', '&#x23ef;', '&#x23f0;', '&#x23f1;', '&#x23f2;', '&#x23f3;', '&#x23f8;', '&#x23f9;', '&#x23fa;', '&#x24c2;', '&#x25aa;', '&#x25ab;', '&#x25b6;', '&#x25c0;', '&#x25fb;', '&#x25fc;', '&#x25fd;', '&#x25fe;', '&#x2600;', '&#x2601;', '&#x2602;', '&#x2603;', '&#x2604;', '&#x260e;', '&#x2611;', '&#x2614;', '&#x2615;', '&#x2618;', '&#x261d;', '&#x2620;', '&#x2622;', '&#x2623;', '&#x2626;', '&#x262a;', '&#x262e;', '&#x262f;', '&#x2638;', '&#x2639;', '&#x263a;', '&#x2640;', '&#x2642;', '&#x2648;', '&#x2649;', '&#x264a;', '&#x264b;', '&#x264c;', '&#x264d;', '&#x264e;', '&#x264f;', '&#x2650;', '&#x2651;', '&#x2652;', '&#x2653;', '&#x265f;', '&#x2660;', '&#x2663;', '&#x2665;', '&#x2666;', '&#x2668;', '&#x267b;', '&#x267e;', '&#x267f;', '&#x2692;', '&#x2693;', '&#x2694;', '&#x2695;', '&#x2696;', '&#x2697;', '&#x2699;', '&#x269b;', '&#x269c;', '&#x26a0;', '&#x26a1;', '&#x26a7;', '&#x26aa;', '&#x26ab;', '&#x26b0;', '&#x26b1;', '&#x26bd;', '&#x26be;', '&#x26c4;', '&#x26c5;', '&#x26c8;', '&#x26ce;', '&#x26cf;', '&#x26d1;', '&#x26d3;', '&#x26d4;', '&#x26e9;', '&#x26ea;', '&#x26f0;', '&#x26f1;', '&#x26f2;', '&#x26f3;', '&#x26f4;', '&#x26f5;', '&#x26f7;', '&#x26f8;', '&#x26f9;', '&#x26fa;', '&#x26fd;', '&#x2702;', '&#x2705;', '&#x2708;', '&#x2709;', '&#x270a;', '&#x270b;', '&#x270c;', '&#x270d;', '&#x270f;', '&#x2712;', '&#x2714;', '&#x2716;', '&#x271d;', '&#x2721;', '&#x2728;', '&#x2733;', '&#x2734;', '&#x2744;', '&#x2747;', '&#x274c;', '&#x274e;', '&#x2753;', '&#x2754;', '&#x2755;', '&#x2757;', '&#x2763;', '&#x2764;', '&#x2795;', '&#x2796;', '&#x2797;', '&#x27a1;', '&#x27b0;', '&#x27bf;', '&#x2934;', '&#x2935;', '&#x2b05;', '&#x2b06;', '&#x2b07;', '&#x2b1b;', '&#x2b1c;', '&#x2b50;', '&#x2b55;', '&#x3030;', '&#x303d;', '&#x3297;', '&#x3299;', '&#xe50a;' );
  5449. $partials = array( '&#x1f004;', '&#x1f0cf;', '&#x1f170;', '&#x1f171;', '&#x1f17e;', '&#x1f17f;', '&#x1f18e;', '&#x1f191;', '&#x1f192;', '&#x1f193;', '&#x1f194;', '&#x1f195;', '&#x1f196;', '&#x1f197;', '&#x1f198;', '&#x1f199;', '&#x1f19a;', '&#x1f1e6;', '&#x1f1e8;', '&#x1f1e9;', '&#x1f1ea;', '&#x1f1eb;', '&#x1f1ec;', '&#x1f1ee;', '&#x1f1f1;', '&#x1f1f2;', '&#x1f1f4;', '&#x1f1f6;', '&#x1f1f7;', '&#x1f1f8;', '&#x1f1f9;', '&#x1f1fa;', '&#x1f1fc;', '&#x1f1fd;', '&#x1f1ff;', '&#x1f1e7;', '&#x1f1ed;', '&#x1f1ef;', '&#x1f1f3;', '&#x1f1fb;', '&#x1f1fe;', '&#x1f1f0;', '&#x1f1f5;', '&#x1f201;', '&#x1f202;', '&#x1f21a;', '&#x1f22f;', '&#x1f232;', '&#x1f233;', '&#x1f234;', '&#x1f235;', '&#x1f236;', '&#x1f237;', '&#x1f238;', '&#x1f239;', '&#x1f23a;', '&#x1f250;', '&#x1f251;', '&#x1f300;', '&#x1f301;', '&#x1f302;', '&#x1f303;', '&#x1f304;', '&#x1f305;', '&#x1f306;', '&#x1f307;', '&#x1f308;', '&#x1f309;', '&#x1f30a;', '&#x1f30b;', '&#x1f30c;', '&#x1f30d;', '&#x1f30e;', '&#x1f30f;', '&#x1f310;', '&#x1f311;', '&#x1f312;', '&#x1f313;', '&#x1f314;', '&#x1f315;', '&#x1f316;', '&#x1f317;', '&#x1f318;', '&#x1f319;', '&#x1f31a;', '&#x1f31b;', '&#x1f31c;', '&#x1f31d;', '&#x1f31e;', '&#x1f31f;', '&#x1f320;', '&#x1f321;', '&#x1f324;', '&#x1f325;', '&#x1f326;', '&#x1f327;', '&#x1f328;', '&#x1f329;', '&#x1f32a;', '&#x1f32b;', '&#x1f32c;', '&#x1f32d;', '&#x1f32e;', '&#x1f32f;', '&#x1f330;', '&#x1f331;', '&#x1f332;', '&#x1f333;', '&#x1f334;', '&#x1f335;', '&#x1f336;', '&#x1f337;', '&#x1f338;', '&#x1f339;', '&#x1f33a;', '&#x1f33b;', '&#x1f33c;', '&#x1f33d;', '&#x1f33e;', '&#x1f33f;', '&#x1f340;', '&#x1f341;', '&#x1f342;', '&#x1f343;', '&#x1f344;', '&#x1f345;', '&#x1f346;', '&#x1f347;', '&#x1f348;', '&#x1f349;', '&#x1f34a;', '&#x1f34b;', '&#x1f34c;', '&#x1f34d;', '&#x1f34e;', '&#x1f34f;', '&#x1f350;', '&#x1f351;', '&#x1f352;', '&#x1f353;', '&#x1f354;', '&#x1f355;', '&#x1f356;', '&#x1f357;', '&#x1f358;', '&#x1f359;', '&#x1f35a;', '&#x1f35b;', '&#x1f35c;', '&#x1f35d;', '&#x1f35e;', '&#x1f35f;', '&#x1f360;', '&#x1f361;', '&#x1f362;', '&#x1f363;', '&#x1f364;', '&#x1f365;', '&#x1f366;', '&#x1f367;', '&#x1f368;', '&#x1f369;', '&#x1f36a;', '&#x1f36b;', '&#x1f36c;', '&#x1f36d;', '&#x1f36e;', '&#x1f36f;', '&#x1f370;', '&#x1f371;', '&#x1f372;', '&#x1f373;', '&#x1f374;', '&#x1f375;', '&#x1f376;', '&#x1f377;', '&#x1f378;', '&#x1f379;', '&#x1f37a;', '&#x1f37b;', '&#x1f37c;', '&#x1f37d;', '&#x1f37e;', '&#x1f37f;', '&#x1f380;', '&#x1f381;', '&#x1f382;', '&#x1f383;', '&#x1f384;', '&#x1f385;', '&#x1f3fb;', '&#x1f3fc;', '&#x1f3fd;', '&#x1f3fe;', '&#x1f3ff;', '&#x1f386;', '&#x1f387;', '&#x1f388;', '&#x1f389;', '&#x1f38a;', '&#x1f38b;', '&#x1f38c;', '&#x1f38d;', '&#x1f38e;', '&#x1f38f;', '&#x1f390;', '&#x1f391;', '&#x1f392;', '&#x1f393;', '&#x1f396;', '&#x1f397;', '&#x1f399;', '&#x1f39a;', '&#x1f39b;', '&#x1f39e;', '&#x1f39f;', '&#x1f3a0;', '&#x1f3a1;', '&#x1f3a2;', '&#x1f3a3;', '&#x1f3a4;', '&#x1f3a5;', '&#x1f3a6;', '&#x1f3a7;', '&#x1f3a8;', '&#x1f3a9;', '&#x1f3aa;', '&#x1f3ab;', '&#x1f3ac;', '&#x1f3ad;', '&#x1f3ae;', '&#x1f3af;', '&#x1f3b0;', '&#x1f3b1;', '&#x1f3b2;', '&#x1f3b3;', '&#x1f3b4;', '&#x1f3b5;', '&#x1f3b6;', '&#x1f3b7;', '&#x1f3b8;', '&#x1f3b9;', '&#x1f3ba;', '&#x1f3bb;', '&#x1f3bc;', '&#x1f3bd;', '&#x1f3be;', '&#x1f3bf;', '&#x1f3c0;', '&#x1f3c1;', '&#x1f3c2;', '&#x1f3c3;', '&#x200d;', '&#x2640;', '&#xfe0f;', '&#x2642;', '&#x1f3c4;', '&#x1f3c5;', '&#x1f3c6;', '&#x1f3c7;', '&#x1f3c8;', '&#x1f3c9;', '&#x1f3ca;', '&#x1f3cb;', '&#x1f3cc;', '&#x1f3cd;', '&#x1f3ce;', '&#x1f3cf;', '&#x1f3d0;', '&#x1f3d1;', '&#x1f3d2;', '&#x1f3d3;', '&#x1f3d4;', '&#x1f3d5;', '&#x1f3d6;', '&#x1f3d7;', '&#x1f3d8;', '&#x1f3d9;', '&#x1f3da;', '&#x1f3db;', '&#x1f3dc;', '&#x1f3dd;', '&#x1f3de;', '&#x1f3df;', '&#x1f3e0;', '&#x1f3e1;', '&#x1f3e2;', '&#x1f3e3;', '&#x1f3e4;', '&#x1f3e5;', '&#x1f3e6;', '&#x1f3e7;', '&#x1f3e8;', '&#x1f3e9;', '&#x1f3ea;', '&#x1f3eb;', '&#x1f3ec;', '&#x1f3ed;', '&#x1f3ee;', '&#x1f3ef;', '&#x1f3f0;', '&#x1f3f3;', '&#x26a7;', '&#x1f3f4;', '&#x2620;', '&#xe0067;', '&#xe0062;', '&#xe0065;', '&#xe006e;', '&#xe007f;', '&#xe0073;', '&#xe0063;', '&#xe0074;', '&#xe0077;', '&#xe006c;', '&#x1f3f5;', '&#x1f3f7;', '&#x1f3f8;', '&#x1f3f9;', '&#x1f3fa;', '&#x1f400;', '&#x1f401;', '&#x1f402;', '&#x1f403;', '&#x1f404;', '&#x1f405;', '&#x1f406;', '&#x1f407;', '&#x1f408;', '&#x2b1b;', '&#x1f409;', '&#x1f40a;', '&#x1f40b;', '&#x1f40c;', '&#x1f40d;', '&#x1f40e;', '&#x1f40f;', '&#x1f410;', '&#x1f411;', '&#x1f412;', '&#x1f413;', '&#x1f414;', '&#x1f415;', '&#x1f9ba;', '&#x1f416;', '&#x1f417;', '&#x1f418;', '&#x1f419;', '&#x1f41a;', '&#x1f41b;', '&#x1f41c;', '&#x1f41d;', '&#x1f41e;', '&#x1f41f;', '&#x1f420;', '&#x1f421;', '&#x1f422;', '&#x1f423;', '&#x1f424;', '&#x1f425;', '&#x1f426;', '&#x1f427;', '&#x1f428;', '&#x1f429;', '&#x1f42a;', '&#x1f42b;', '&#x1f42c;', '&#x1f42d;', '&#x1f42e;', '&#x1f42f;', '&#x1f430;', '&#x1f431;', '&#x1f432;', '&#x1f433;', '&#x1f434;', '&#x1f435;', '&#x1f436;', '&#x1f437;', '&#x1f438;', '&#x1f439;', '&#x1f43a;', '&#x1f43b;', '&#x2744;', '&#x1f43c;', '&#x1f43d;', '&#x1f43e;', '&#x1f43f;', '&#x1f440;', '&#x1f441;', '&#x1f5e8;', '&#x1f442;', '&#x1f443;', '&#x1f444;', '&#x1f445;', '&#x1f446;', '&#x1f447;', '&#x1f448;', '&#x1f449;', '&#x1f44a;', '&#x1f44b;', '&#x1f44c;', '&#x1f44d;', '&#x1f44e;', '&#x1f44f;', '&#x1f450;', '&#x1f451;', '&#x1f452;', '&#x1f453;', '&#x1f454;', '&#x1f455;', '&#x1f456;', '&#x1f457;', '&#x1f458;', '&#x1f459;', '&#x1f45a;', '&#x1f45b;', '&#x1f45c;', '&#x1f45d;', '&#x1f45e;', '&#x1f45f;', '&#x1f460;', '&#x1f461;', '&#x1f462;', '&#x1f463;', '&#x1f464;', '&#x1f465;', '&#x1f466;', '&#x1f467;', '&#x1f468;', '&#x1f4bb;', '&#x1f4bc;', '&#x1f527;', '&#x1f52c;', '&#x1f680;', '&#x1f692;', '&#x1f91d;', '&#x1f9af;', '&#x1f9b0;', '&#x1f9b1;', '&#x1f9b2;', '&#x1f9b3;', '&#x1f9bc;', '&#x1f9bd;', '&#x2695;', '&#x2696;', '&#x2708;', '&#x2764;', '&#x1f48b;', '&#x1f469;', '&#x1f46a;', '&#x1f46b;', '&#x1f46c;', '&#x1f46d;', '&#x1f46e;', '&#x1f46f;', '&#x1f470;', '&#x1f471;', '&#x1f472;', '&#x1f473;', '&#x1f474;', '&#x1f475;', '&#x1f476;', '&#x1f477;', '&#x1f478;', '&#x1f479;', '&#x1f47a;', '&#x1f47b;', '&#x1f47c;', '&#x1f47d;', '&#x1f47e;', '&#x1f47f;', '&#x1f480;', '&#x1f481;', '&#x1f482;', '&#x1f483;', '&#x1f484;', '&#x1f485;', '&#x1f486;', '&#x1f487;', '&#x1f488;', '&#x1f489;', '&#x1f48a;', '&#x1f48c;', '&#x1f48d;', '&#x1f48e;', '&#x1f48f;', '&#x1f490;', '&#x1f491;', '&#x1f492;', '&#x1f493;', '&#x1f494;', '&#x1f495;', '&#x1f496;', '&#x1f497;', '&#x1f498;', '&#x1f499;', '&#x1f49a;', '&#x1f49b;', '&#x1f49c;', '&#x1f49d;', '&#x1f49e;', '&#x1f49f;', '&#x1f4a0;', '&#x1f4a1;', '&#x1f4a2;', '&#x1f4a3;', '&#x1f4a4;', '&#x1f4a5;', '&#x1f4a6;', '&#x1f4a7;', '&#x1f4a8;', '&#x1f4a9;', '&#x1f4aa;', '&#x1f4ab;', '&#x1f4ac;', '&#x1f4ad;', '&#x1f4ae;', '&#x1f4af;', '&#x1f4b0;', '&#x1f4b1;', '&#x1f4b2;', '&#x1f4b3;', '&#x1f4b4;', '&#x1f4b5;', '&#x1f4b6;', '&#x1f4b7;', '&#x1f4b8;', '&#x1f4b9;', '&#x1f4ba;', '&#x1f4bd;', '&#x1f4be;', '&#x1f4bf;', '&#x1f4c0;', '&#x1f4c1;', '&#x1f4c2;', '&#x1f4c3;', '&#x1f4c4;', '&#x1f4c5;', '&#x1f4c6;', '&#x1f4c7;', '&#x1f4c8;', '&#x1f4c9;', '&#x1f4ca;', '&#x1f4cb;', '&#x1f4cc;', '&#x1f4cd;', '&#x1f4ce;', '&#x1f4cf;', '&#x1f4d0;', '&#x1f4d1;', '&#x1f4d2;', '&#x1f4d3;', '&#x1f4d4;', '&#x1f4d5;', '&#x1f4d6;', '&#x1f4d7;', '&#x1f4d8;', '&#x1f4d9;', '&#x1f4da;', '&#x1f4db;', '&#x1f4dc;', '&#x1f4dd;', '&#x1f4de;', '&#x1f4df;', '&#x1f4e0;', '&#x1f4e1;', '&#x1f4e2;', '&#x1f4e3;', '&#x1f4e4;', '&#x1f4e5;', '&#x1f4e6;', '&#x1f4e7;', '&#x1f4e8;', '&#x1f4e9;', '&#x1f4ea;', '&#x1f4eb;', '&#x1f4ec;', '&#x1f4ed;', '&#x1f4ee;', '&#x1f4ef;', '&#x1f4f0;', '&#x1f4f1;', '&#x1f4f2;', '&#x1f4f3;', '&#x1f4f4;', '&#x1f4f5;', '&#x1f4f6;', '&#x1f4f7;', '&#x1f4f8;', '&#x1f4f9;', '&#x1f4fa;', '&#x1f4fb;', '&#x1f4fc;', '&#x1f4fd;', '&#x1f4ff;', '&#x1f500;', '&#x1f501;', '&#x1f502;', '&#x1f503;', '&#x1f504;', '&#x1f505;', '&#x1f506;', '&#x1f507;', '&#x1f508;', '&#x1f509;', '&#x1f50a;', '&#x1f50b;', '&#x1f50c;', '&#x1f50d;', '&#x1f50e;', '&#x1f50f;', '&#x1f510;', '&#x1f511;', '&#x1f512;', '&#x1f513;', '&#x1f514;', '&#x1f515;', '&#x1f516;', '&#x1f517;', '&#x1f518;', '&#x1f519;', '&#x1f51a;', '&#x1f51b;', '&#x1f51c;', '&#x1f51d;', '&#x1f51e;', '&#x1f51f;', '&#x1f520;', '&#x1f521;', '&#x1f522;', '&#x1f523;', '&#x1f524;', '&#x1f525;', '&#x1f526;', '&#x1f528;', '&#x1f529;', '&#x1f52a;', '&#x1f52b;', '&#x1f52d;', '&#x1f52e;', '&#x1f52f;', '&#x1f530;', '&#x1f531;', '&#x1f532;', '&#x1f533;', '&#x1f534;', '&#x1f535;', '&#x1f536;', '&#x1f537;', '&#x1f538;', '&#x1f539;', '&#x1f53a;', '&#x1f53b;', '&#x1f53c;', '&#x1f53d;', '&#x1f549;', '&#x1f54a;', '&#x1f54b;', '&#x1f54c;', '&#x1f54d;', '&#x1f54e;', '&#x1f550;', '&#x1f551;', '&#x1f552;', '&#x1f553;', '&#x1f554;', '&#x1f555;', '&#x1f556;', '&#x1f557;', '&#x1f558;', '&#x1f559;', '&#x1f55a;', '&#x1f55b;', '&#x1f55c;', '&#x1f55d;', '&#x1f55e;', '&#x1f55f;', '&#x1f560;', '&#x1f561;', '&#x1f562;', '&#x1f563;', '&#x1f564;', '&#x1f565;', '&#x1f566;', '&#x1f567;', '&#x1f56f;', '&#x1f570;', '&#x1f573;', '&#x1f574;', '&#x1f575;', '&#x1f576;', '&#x1f577;', '&#x1f578;', '&#x1f579;', '&#x1f57a;', '&#x1f587;', '&#x1f58a;', '&#x1f58b;', '&#x1f58c;', '&#x1f58d;', '&#x1f590;', '&#x1f595;', '&#x1f596;', '&#x1f5a4;', '&#x1f5a5;', '&#x1f5a8;', '&#x1f5b1;', '&#x1f5b2;', '&#x1f5bc;', '&#x1f5c2;', '&#x1f5c3;', '&#x1f5c4;', '&#x1f5d1;', '&#x1f5d2;', '&#x1f5d3;', '&#x1f5dc;', '&#x1f5dd;', '&#x1f5de;', '&#x1f5e1;', '&#x1f5e3;', '&#x1f5ef;', '&#x1f5f3;', '&#x1f5fa;', '&#x1f5fb;', '&#x1f5fc;', '&#x1f5fd;', '&#x1f5fe;', '&#x1f5ff;', '&#x1f600;', '&#x1f601;', '&#x1f602;', '&#x1f603;', '&#x1f604;', '&#x1f605;', '&#x1f606;', '&#x1f607;', '&#x1f608;', '&#x1f609;', '&#x1f60a;', '&#x1f60b;', '&#x1f60c;', '&#x1f60d;', '&#x1f60e;', '&#x1f60f;', '&#x1f610;', '&#x1f611;', '&#x1f612;', '&#x1f613;', '&#x1f614;', '&#x1f615;', '&#x1f616;', '&#x1f617;', '&#x1f618;', '&#x1f619;', '&#x1f61a;', '&#x1f61b;', '&#x1f61c;', '&#x1f61d;', '&#x1f61e;', '&#x1f61f;', '&#x1f620;', '&#x1f621;', '&#x1f622;', '&#x1f623;', '&#x1f624;', '&#x1f625;', '&#x1f626;', '&#x1f627;', '&#x1f628;', '&#x1f629;', '&#x1f62a;', '&#x1f62b;', '&#x1f62c;', '&#x1f62d;', '&#x1f62e;', '&#x1f62f;', '&#x1f630;', '&#x1f631;', '&#x1f632;', '&#x1f633;', '&#x1f634;', '&#x1f635;', '&#x1f636;', '&#x1f637;', '&#x1f638;', '&#x1f639;', '&#x1f63a;', '&#x1f63b;', '&#x1f63c;', '&#x1f63d;', '&#x1f63e;', '&#x1f63f;', '&#x1f640;', '&#x1f641;', '&#x1f642;', '&#x1f643;', '&#x1f644;', '&#x1f645;', '&#x1f646;', '&#x1f647;', '&#x1f648;', '&#x1f649;', '&#x1f64a;', '&#x1f64b;', '&#x1f64c;', '&#x1f64d;', '&#x1f64e;', '&#x1f64f;', '&#x1f681;', '&#x1f682;', '&#x1f683;', '&#x1f684;', '&#x1f685;', '&#x1f686;', '&#x1f687;', '&#x1f688;', '&#x1f689;', '&#x1f68a;', '&#x1f68b;', '&#x1f68c;', '&#x1f68d;', '&#x1f68e;', '&#x1f68f;', '&#x1f690;', '&#x1f691;', '&#x1f693;', '&#x1f694;', '&#x1f695;', '&#x1f696;', '&#x1f697;', '&#x1f698;', '&#x1f699;', '&#x1f69a;', '&#x1f69b;', '&#x1f69c;', '&#x1f69d;', '&#x1f69e;', '&#x1f69f;', '&#x1f6a0;', '&#x1f6a1;', '&#x1f6a2;', '&#x1f6a3;', '&#x1f6a4;', '&#x1f6a5;', '&#x1f6a6;', '&#x1f6a7;', '&#x1f6a8;', '&#x1f6a9;', '&#x1f6aa;', '&#x1f6ab;', '&#x1f6ac;', '&#x1f6ad;', '&#x1f6ae;', '&#x1f6af;', '&#x1f6b0;', '&#x1f6b1;', '&#x1f6b2;', '&#x1f6b3;', '&#x1f6b4;', '&#x1f6b5;', '&#x1f6b6;', '&#x1f6b7;', '&#x1f6b8;', '&#x1f6b9;', '&#x1f6ba;', '&#x1f6bb;', '&#x1f6bc;', '&#x1f6bd;', '&#x1f6be;', '&#x1f6bf;', '&#x1f6c0;', '&#x1f6c1;', '&#x1f6c2;', '&#x1f6c3;', '&#x1f6c4;', '&#x1f6c5;', '&#x1f6cb;', '&#x1f6cc;', '&#x1f6cd;', '&#x1f6ce;', '&#x1f6cf;', '&#x1f6d0;', '&#x1f6d1;', '&#x1f6d2;', '&#x1f6d5;', '&#x1f6d6;', '&#x1f6d7;', '&#x1f6e0;', '&#x1f6e1;', '&#x1f6e2;', '&#x1f6e3;', '&#x1f6e4;', '&#x1f6e5;', '&#x1f6e9;', '&#x1f6eb;', '&#x1f6ec;', '&#x1f6f0;', '&#x1f6f3;', '&#x1f6f4;', '&#x1f6f5;', '&#x1f6f6;', '&#x1f6f7;', '&#x1f6f8;', '&#x1f6f9;', '&#x1f6fa;', '&#x1f6fb;', '&#x1f6fc;', '&#x1f7e0;', '&#x1f7e1;', '&#x1f7e2;', '&#x1f7e3;', '&#x1f7e4;', '&#x1f7e5;', '&#x1f7e6;', '&#x1f7e7;', '&#x1f7e8;', '&#x1f7e9;', '&#x1f7ea;', '&#x1f7eb;', '&#x1f90c;', '&#x1f90d;', '&#x1f90e;', '&#x1f90f;', '&#x1f910;', '&#x1f911;', '&#x1f912;', '&#x1f913;', '&#x1f914;', '&#x1f915;', '&#x1f916;', '&#x1f917;', '&#x1f918;', '&#x1f919;', '&#x1f91a;', '&#x1f91b;', '&#x1f91c;', '&#x1f91e;', '&#x1f91f;', '&#x1f920;', '&#x1f921;', '&#x1f922;', '&#x1f923;', '&#x1f924;', '&#x1f925;', '&#x1f926;', '&#x1f927;', '&#x1f928;', '&#x1f929;', '&#x1f92a;', '&#x1f92b;', '&#x1f92c;', '&#x1f92d;', '&#x1f92e;', '&#x1f92f;', '&#x1f930;', '&#x1f931;', '&#x1f932;', '&#x1f933;', '&#x1f934;', '&#x1f935;', '&#x1f936;', '&#x1f937;', '&#x1f938;', '&#x1f939;', '&#x1f93a;', '&#x1f93c;', '&#x1f93d;', '&#x1f93e;', '&#x1f93f;', '&#x1f940;', '&#x1f941;', '&#x1f942;', '&#x1f943;', '&#x1f944;', '&#x1f945;', '&#x1f947;', '&#x1f948;', '&#x1f949;', '&#x1f94a;', '&#x1f94b;', '&#x1f94c;', '&#x1f94d;', '&#x1f94e;', '&#x1f94f;', '&#x1f950;', '&#x1f951;', '&#x1f952;', '&#x1f953;', '&#x1f954;', '&#x1f955;', '&#x1f956;', '&#x1f957;', '&#x1f958;', '&#x1f959;', '&#x1f95a;', '&#x1f95b;', '&#x1f95c;', '&#x1f95d;', '&#x1f95e;', '&#x1f95f;', '&#x1f960;', '&#x1f961;', '&#x1f962;', '&#x1f963;', '&#x1f964;', '&#x1f965;', '&#x1f966;', '&#x1f967;', '&#x1f968;', '&#x1f969;', '&#x1f96a;', '&#x1f96b;', '&#x1f96c;', '&#x1f96d;', '&#x1f96e;', '&#x1f96f;', '&#x1f970;', '&#x1f971;', '&#x1f972;', '&#x1f973;', '&#x1f974;', '&#x1f975;', '&#x1f976;', '&#x1f977;', '&#x1f978;', '&#x1f97a;', '&#x1f97b;', '&#x1f97c;', '&#x1f97d;', '&#x1f97e;', '&#x1f97f;', '&#x1f980;', '&#x1f981;', '&#x1f982;', '&#x1f983;', '&#x1f984;', '&#x1f985;', '&#x1f986;', '&#x1f987;', '&#x1f988;', '&#x1f989;', '&#x1f98a;', '&#x1f98b;', '&#x1f98c;', '&#x1f98d;', '&#x1f98e;', '&#x1f98f;', '&#x1f990;', '&#x1f991;', '&#x1f992;', '&#x1f993;', '&#x1f994;', '&#x1f995;', '&#x1f996;', '&#x1f997;', '&#x1f998;', '&#x1f999;', '&#x1f99a;', '&#x1f99b;', '&#x1f99c;', '&#x1f99d;', '&#x1f99e;', '&#x1f99f;', '&#x1f9a0;', '&#x1f9a1;', '&#x1f9a2;', '&#x1f9a3;', '&#x1f9a4;', '&#x1f9a5;', '&#x1f9a6;', '&#x1f9a7;', '&#x1f9a8;', '&#x1f9a9;', '&#x1f9aa;', '&#x1f9ab;', '&#x1f9ac;', '&#x1f9ad;', '&#x1f9ae;', '&#x1f9b4;', '&#x1f9b5;', '&#x1f9b6;', '&#x1f9b7;', '&#x1f9b8;', '&#x1f9b9;', '&#x1f9bb;', '&#x1f9be;', '&#x1f9bf;', '&#x1f9c0;', '&#x1f9c1;', '&#x1f9c2;', '&#x1f9c3;', '&#x1f9c4;', '&#x1f9c5;', '&#x1f9c6;', '&#x1f9c7;', '&#x1f9c8;', '&#x1f9c9;', '&#x1f9ca;', '&#x1f9cb;', '&#x1f9cd;', '&#x1f9ce;', '&#x1f9cf;', '&#x1f9d0;', '&#x1f9d1;', '&#x1f9d2;', '&#x1f9d3;', '&#x1f9d4;', '&#x1f9d5;', '&#x1f9d6;', '&#x1f9d7;', '&#x1f9d8;', '&#x1f9d9;', '&#x1f9da;', '&#x1f9db;', '&#x1f9dc;', '&#x1f9dd;', '&#x1f9de;', '&#x1f9df;', '&#x1f9e0;', '&#x1f9e1;', '&#x1f9e2;', '&#x1f9e3;', '&#x1f9e4;', '&#x1f9e5;', '&#x1f9e6;', '&#x1f9e7;', '&#x1f9e8;', '&#x1f9e9;', '&#x1f9ea;', '&#x1f9eb;', '&#x1f9ec;', '&#x1f9ed;', '&#x1f9ee;', '&#x1f9ef;', '&#x1f9f0;', '&#x1f9f1;', '&#x1f9f2;', '&#x1f9f3;', '&#x1f9f4;', '&#x1f9f5;', '&#x1f9f6;', '&#x1f9f7;', '&#x1f9f8;', '&#x1f9f9;', '&#x1f9fa;', '&#x1f9fb;', '&#x1f9fc;', '&#x1f9fd;', '&#x1f9fe;', '&#x1f9ff;', '&#x1fa70;', '&#x1fa71;', '&#x1fa72;', '&#x1fa73;', '&#x1fa74;', '&#x1fa78;', '&#x1fa79;', '&#x1fa7a;', '&#x1fa80;', '&#x1fa81;', '&#x1fa82;', '&#x1fa83;', '&#x1fa84;', '&#x1fa85;', '&#x1fa86;', '&#x1fa90;', '&#x1fa91;', '&#x1fa92;', '&#x1fa93;', '&#x1fa94;', '&#x1fa95;', '&#x1fa96;', '&#x1fa97;', '&#x1fa98;', '&#x1fa99;', '&#x1fa9a;', '&#x1fa9b;', '&#x1fa9c;', '&#x1fa9d;', '&#x1fa9e;', '&#x1fa9f;', '&#x1faa0;', '&#x1faa1;', '&#x1faa2;', '&#x1faa3;', '&#x1faa4;', '&#x1faa5;', '&#x1faa6;', '&#x1faa7;', '&#x1faa8;', '&#x1fab0;', '&#x1fab1;', '&#x1fab2;', '&#x1fab3;', '&#x1fab4;', '&#x1fab5;', '&#x1fab6;', '&#x1fac0;', '&#x1fac1;', '&#x1fac2;', '&#x1fad0;', '&#x1fad1;', '&#x1fad2;', '&#x1fad3;', '&#x1fad4;', '&#x1fad5;', '&#x1fad6;', '&#x203c;', '&#x2049;', '&#x2122;', '&#x2139;', '&#x2194;', '&#x2195;', '&#x2196;', '&#x2197;', '&#x2198;', '&#x2199;', '&#x21a9;', '&#x21aa;', '&#x20e3;', '&#x231a;', '&#x231b;', '&#x2328;', '&#x23cf;', '&#x23e9;', '&#x23ea;', '&#x23eb;', '&#x23ec;', '&#x23ed;', '&#x23ee;', '&#x23ef;', '&#x23f0;', '&#x23f1;', '&#x23f2;', '&#x23f3;', '&#x23f8;', '&#x23f9;', '&#x23fa;', '&#x24c2;', '&#x25aa;', '&#x25ab;', '&#x25b6;', '&#x25c0;', '&#x25fb;', '&#x25fc;', '&#x25fd;', '&#x25fe;', '&#x2600;', '&#x2601;', '&#x2602;', '&#x2603;', '&#x2604;', '&#x260e;', '&#x2611;', '&#x2614;', '&#x2615;', '&#x2618;', '&#x261d;', '&#x2622;', '&#x2623;', '&#x2626;', '&#x262a;', '&#x262e;', '&#x262f;', '&#x2638;', '&#x2639;', '&#x263a;', '&#x2648;', '&#x2649;', '&#x264a;', '&#x264b;', '&#x264c;', '&#x264d;', '&#x264e;', '&#x264f;', '&#x2650;', '&#x2651;', '&#x2652;', '&#x2653;', '&#x265f;', '&#x2660;', '&#x2663;', '&#x2665;', '&#x2666;', '&#x2668;', '&#x267b;', '&#x267e;', '&#x267f;', '&#x2692;', '&#x2693;', '&#x2694;', '&#x2697;', '&#x2699;', '&#x269b;', '&#x269c;', '&#x26a0;', '&#x26a1;', '&#x26aa;', '&#x26ab;', '&#x26b0;', '&#x26b1;', '&#x26bd;', '&#x26be;', '&#x26c4;', '&#x26c5;', '&#x26c8;', '&#x26ce;', '&#x26cf;', '&#x26d1;', '&#x26d3;', '&#x26d4;', '&#x26e9;', '&#x26ea;', '&#x26f0;', '&#x26f1;', '&#x26f2;', '&#x26f3;', '&#x26f4;', '&#x26f5;', '&#x26f7;', '&#x26f8;', '&#x26f9;', '&#x26fa;', '&#x26fd;', '&#x2702;', '&#x2705;', '&#x2709;', '&#x270a;', '&#x270b;', '&#x270c;', '&#x270d;', '&#x270f;', '&#x2712;', '&#x2714;', '&#x2716;', '&#x271d;', '&#x2721;', '&#x2728;', '&#x2733;', '&#x2734;', '&#x2747;', '&#x274c;', '&#x274e;', '&#x2753;', '&#x2754;', '&#x2755;', '&#x2757;', '&#x2763;', '&#x2795;', '&#x2796;', '&#x2797;', '&#x27a1;', '&#x27b0;', '&#x27bf;', '&#x2934;', '&#x2935;', '&#x2b05;', '&#x2b06;', '&#x2b07;', '&#x2b1c;', '&#x2b50;', '&#x2b55;', '&#x3030;', '&#x303d;', '&#x3297;', '&#x3299;', '&#xe50a;' );
  5450. // END: emoji arrays
  5451. if ( 'entities' === $type ) {
  5452. return $entities;
  5453. }
  5454. return $partials;
  5455. }
  5456. /**
  5457. * Shorten a URL, to be used as link text.
  5458. *
  5459. * @since 1.2.0
  5460. * @since 4.4.0 Moved to wp-includes/formatting.php from wp-admin/includes/misc.php and added $length param.
  5461. *
  5462. * @param string $url URL to shorten.
  5463. * @param int $length Optional. Maximum length of the shortened URL. Default 35 characters.
  5464. * @return string Shortened URL.
  5465. */
  5466. function url_shorten( $url, $length = 35 ) {
  5467. $stripped = str_replace( array( 'https://', 'http://', 'www.' ), '', $url );
  5468. $short_url = untrailingslashit( $stripped );
  5469. if ( strlen( $short_url ) > $length ) {
  5470. $short_url = substr( $short_url, 0, $length - 3 ) . '&hellip;';
  5471. }
  5472. return $short_url;
  5473. }
  5474. /**
  5475. * Sanitizes a hex color.
  5476. *
  5477. * Returns either '', a 3 or 6 digit hex color (with #), or nothing.
  5478. * For sanitizing values without a #, see sanitize_hex_color_no_hash().
  5479. *
  5480. * @since 3.4.0
  5481. *
  5482. * @param string $color
  5483. * @return string|void
  5484. */
  5485. function sanitize_hex_color( $color ) {
  5486. if ( '' === $color ) {
  5487. return '';
  5488. }
  5489. // 3 or 6 hex digits, or the empty string.
  5490. if ( preg_match( '|^#([A-Fa-f0-9]{3}){1,2}$|', $color ) ) {
  5491. return $color;
  5492. }
  5493. }
  5494. /**
  5495. * Sanitizes a hex color without a hash. Use sanitize_hex_color() when possible.
  5496. *
  5497. * Saving hex colors without a hash puts the burden of adding the hash on the
  5498. * UI, which makes it difficult to use or upgrade to other color types such as
  5499. * rgba, hsl, rgb, and HTML color names.
  5500. *
  5501. * Returns either '', a 3 or 6 digit hex color (without a #), or null.
  5502. *
  5503. * @since 3.4.0
  5504. *
  5505. * @param string $color
  5506. * @return string|null
  5507. */
  5508. function sanitize_hex_color_no_hash( $color ) {
  5509. $color = ltrim( $color, '#' );
  5510. if ( '' === $color ) {
  5511. return '';
  5512. }
  5513. return sanitize_hex_color( '#' . $color ) ? $color : null;
  5514. }
  5515. /**
  5516. * Ensures that any hex color is properly hashed.
  5517. * Otherwise, returns value untouched.
  5518. *
  5519. * This method should only be necessary if using sanitize_hex_color_no_hash().
  5520. *
  5521. * @since 3.4.0
  5522. *
  5523. * @param string $color
  5524. * @return string
  5525. */
  5526. function maybe_hash_hex_color( $color ) {
  5527. $unhashed = sanitize_hex_color_no_hash( $color );
  5528. if ( $unhashed ) {
  5529. return '#' . $unhashed;
  5530. }
  5531. return $color;
  5532. }