formatting.php 324 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091409240934094409540964097409840994100410141024103410441054106410741084109411041114112411341144115411641174118411941204121412241234124412541264127412841294130413141324133413441354136413741384139414041414142414341444145414641474148414941504151415241534154415541564157415841594160416141624163416441654166416741684169417041714172417341744175417641774178417941804181418241834184418541864187418841894190419141924193419441954196419741984199420042014202420342044205420642074208420942104211421242134214421542164217421842194220422142224223422442254226422742284229423042314232423342344235423642374238423942404241424242434244424542464247424842494250425142524253425442554256425742584259426042614262426342644265426642674268426942704271427242734274427542764277427842794280428142824283428442854286428742884289429042914292429342944295429642974298429943004301430243034304430543064307430843094310431143124313431443154316431743184319432043214322432343244325432643274328432943304331433243334334433543364337433843394340434143424343434443454346434743484349435043514352435343544355435643574358435943604361436243634364436543664367436843694370437143724373437443754376437743784379438043814382438343844385438643874388438943904391439243934394439543964397439843994400440144024403440444054406440744084409441044114412441344144415441644174418441944204421442244234424442544264427442844294430443144324433443444354436443744384439444044414442444344444445444644474448444944504451445244534454445544564457445844594460446144624463446444654466446744684469447044714472447344744475447644774478447944804481448244834484448544864487448844894490449144924493449444954496449744984499450045014502450345044505450645074508450945104511451245134514451545164517451845194520452145224523452445254526452745284529453045314532453345344535453645374538453945404541454245434544454545464547454845494550455145524553455445554556455745584559456045614562456345644565456645674568456945704571457245734574457545764577457845794580458145824583458445854586458745884589459045914592459345944595459645974598459946004601460246034604460546064607460846094610461146124613461446154616461746184619462046214622462346244625462646274628462946304631463246334634463546364637463846394640464146424643464446454646464746484649465046514652465346544655465646574658465946604661466246634664466546664667466846694670467146724673467446754676467746784679468046814682468346844685468646874688468946904691469246934694469546964697469846994700470147024703470447054706470747084709471047114712471347144715471647174718471947204721472247234724472547264727472847294730473147324733473447354736473747384739474047414742474347444745474647474748474947504751475247534754475547564757475847594760476147624763476447654766476747684769477047714772477347744775477647774778477947804781478247834784478547864787478847894790479147924793479447954796479747984799480048014802480348044805480648074808480948104811481248134814481548164817481848194820482148224823482448254826482748284829483048314832483348344835483648374838483948404841484248434844484548464847484848494850485148524853485448554856485748584859486048614862486348644865486648674868486948704871487248734874487548764877487848794880488148824883488448854886488748884889489048914892489348944895489648974898489949004901490249034904490549064907490849094910491149124913491449154916491749184919492049214922492349244925492649274928492949304931493249334934493549364937493849394940494149424943494449454946494749484949495049514952495349544955495649574958495949604961496249634964496549664967496849694970497149724973497449754976497749784979498049814982498349844985498649874988498949904991499249934994499549964997499849995000500150025003500450055006500750085009501050115012501350145015501650175018501950205021502250235024502550265027502850295030503150325033503450355036503750385039504050415042504350445045504650475048504950505051505250535054505550565057505850595060506150625063506450655066506750685069507050715072507350745075507650775078507950805081508250835084508550865087508850895090509150925093509450955096509750985099510051015102510351045105510651075108510951105111511251135114511551165117511851195120512151225123512451255126512751285129513051315132513351345135513651375138513951405141514251435144514551465147514851495150515151525153515451555156515751585159516051615162516351645165516651675168516951705171517251735174517551765177517851795180518151825183518451855186518751885189519051915192519351945195519651975198519952005201520252035204520552065207520852095210521152125213521452155216521752185219522052215222522352245225522652275228522952305231523252335234523552365237523852395240524152425243524452455246524752485249525052515252525352545255525652575258525952605261526252635264526552665267526852695270527152725273527452755276527752785279528052815282528352845285528652875288528952905291529252935294529552965297529852995300530153025303530453055306530753085309531053115312531353145315531653175318531953205321532253235324532553265327532853295330533153325333533453355336533753385339534053415342534353445345534653475348534953505351535253535354535553565357535853595360536153625363536453655366536753685369537053715372537353745375537653775378537953805381538253835384538553865387538853895390539153925393539453955396539753985399540054015402540354045405540654075408540954105411541254135414541554165417541854195420542154225423542454255426542754285429543054315432543354345435543654375438543954405441544254435444544554465447544854495450545154525453545454555456545754585459546054615462546354645465546654675468546954705471547254735474547554765477547854795480548154825483548454855486548754885489549054915492549354945495549654975498549955005501550255035504550555065507550855095510551155125513551455155516551755185519552055215522552355245525552655275528552955305531553255335534553555365537553855395540554155425543554455455546554755485549555055515552555355545555555655575558555955605561556255635564556555665567556855695570557155725573557455755576557755785579558055815582558355845585558655875588558955905591559255935594559555965597559855995600560156025603560456055606560756085609561056115612561356145615561656175618561956205621562256235624562556265627562856295630563156325633563456355636563756385639564056415642564356445645564656475648564956505651565256535654565556565657565856595660566156625663566456655666566756685669567056715672567356745675567656775678567956805681568256835684568556865687568856895690569156925693569456955696569756985699570057015702570357045705570657075708570957105711571257135714571557165717571857195720572157225723572457255726572757285729573057315732573357345735573657375738573957405741574257435744574557465747574857495750575157525753575457555756575757585759576057615762576357645765576657675768576957705771577257735774577557765777577857795780578157825783578457855786578757885789579057915792579357945795579657975798579958005801580258035804580558065807580858095810581158125813581458155816581758185819582058215822582358245825582658275828582958305831583258335834583558365837583858395840584158425843584458455846584758485849585058515852585358545855585658575858585958605861586258635864586558665867586858695870587158725873587458755876587758785879588058815882588358845885588658875888588958905891589258935894589558965897589858995900590159025903590459055906590759085909591059115912591359145915591659175918591959205921592259235924592559265927592859295930593159325933593459355936593759385939594059415942594359445945594659475948594959505951595259535954595559565957595859595960596159625963596459655966596759685969597059715972597359745975597659775978597959805981598259835984598559865987598859895990599159925993599459955996599759985999600060016002600360046005600660076008600960106011601260136014601560166017601860196020602160226023602460256026602760286029603060316032603360346035603660376038603960406041604260436044604560466047604860496050605160526053605460556056605760586059606060616062606360646065606660676068606960706071607260736074607560766077607860796080608160826083608460856086608760886089609060916092609360946095609660976098609961006101610261036104610561066107610861096110611161126113611461156116
  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. * Searches for disabled element tags. Pushes element to stack on tag open
  331. * and pops 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 $text 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( $text, $br = true ) {
  395. $pre_tags = array();
  396. if ( trim( $text ) === '' ) {
  397. return '';
  398. }
  399. // Just to make things a little easier, pad the end.
  400. $text = $text . "\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( $text, '<pre' ) !== false ) {
  406. $text_parts = explode( '</pre>', $text );
  407. $last_part = array_pop( $text_parts );
  408. $text = '';
  409. $i = 0;
  410. foreach ( $text_parts as $text_part ) {
  411. $start = strpos( $text_part, '<pre' );
  412. // Malformed HTML?
  413. if ( false === $start ) {
  414. $text .= $text_part;
  415. continue;
  416. }
  417. $name = "<pre wp-pre-tag-$i></pre>";
  418. $pre_tags[ $name ] = substr( $text_part, $start ) . '</pre>';
  419. $text .= substr( $text_part, 0, $start ) . $name;
  420. $i++;
  421. }
  422. $text .= $last_part;
  423. }
  424. // Change multiple <br>'s into two line breaks, which will turn into paragraphs.
  425. $text = preg_replace( '|<br\s*/?>\s*<br\s*/?>|', "\n\n", $text );
  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. $text = preg_replace( '!(<' . $allblocks . '[\s/>])!', "\n\n$1", $text );
  429. // Add a double line break below block-level closing tags.
  430. $text = preg_replace( '!(</' . $allblocks . '>)!', "$1\n\n", $text );
  431. // Add a double line break after hr tags, which are self closing.
  432. $text = preg_replace( '!(<hr\s*?/?>)!', "$1\n\n", $text );
  433. // Standardize newline characters to "\n".
  434. $text = str_replace( array( "\r\n", "\r" ), "\n", $text );
  435. // Find newlines in all elements and add placeholders.
  436. $text = wp_replace_in_html_tags( $text, array( "\n" => ' <!-- wpnl --> ' ) );
  437. // Collapse line breaks before and after <option> elements so they don't get autop'd.
  438. if ( strpos( $text, '<option' ) !== false ) {
  439. $text = preg_replace( '|\s*<option|', '<option', $text );
  440. $text = preg_replace( '|</option>\s*|', '</option>', $text );
  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( $text, '</object>' ) !== false ) {
  447. $text = preg_replace( '|(<object[^>]*>)\s*|', '$1', $text );
  448. $text = preg_replace( '|\s*</object>|', '</object>', $text );
  449. $text = preg_replace( '%\s*(</?(?:param|embed)[^>]*>)\s*%', '$1', $text );
  450. }
  451. /*
  452. * Collapse line breaks inside <audio> and <video> elements,
  453. * before and after <source> and <track> elements.
  454. */
  455. if ( strpos( $text, '<source' ) !== false || strpos( $text, '<track' ) !== false ) {
  456. $text = preg_replace( '%([<\[](?:audio|video)[^>\]]*[>\]])\s*%', '$1', $text );
  457. $text = preg_replace( '%\s*([<\[]/(?:audio|video)[>\]])%', '$1', $text );
  458. $text = preg_replace( '%\s*(<(?:source|track)[^>]*>)\s*%', '$1', $text );
  459. }
  460. // Collapse line breaks before and after <figcaption> elements.
  461. if ( strpos( $text, '<figcaption' ) !== false ) {
  462. $text = preg_replace( '|\s*(<figcaption[^>]*>)|', '$1', $text );
  463. $text = preg_replace( '|</figcaption>\s*|', '</figcaption>', $text );
  464. }
  465. // Remove more than two contiguous line breaks.
  466. $text = preg_replace( "/\n\n+/", "\n\n", $text );
  467. // Split up the contents into an array of strings, separated by double line breaks.
  468. $paragraphs = preg_split( '/\n\s*\n/', $text, -1, PREG_SPLIT_NO_EMPTY );
  469. // Reset $text prior to rebuilding.
  470. $text = '';
  471. // Rebuild the content as a string, wrapping every bit with a <p>.
  472. foreach ( $paragraphs as $paragraph ) {
  473. $text .= '<p>' . trim( $paragraph, "\n" ) . "</p>\n";
  474. }
  475. // Under certain strange conditions it could create a P of entirely whitespace.
  476. $text = preg_replace( '|<p>\s*</p>|', '', $text );
  477. // Add a closing <p> inside <div>, <address>, or <form> tag if missing.
  478. $text = preg_replace( '!<p>([^<]+)</(div|address|form)>!', '<p>$1</p></$2>', $text );
  479. // If an opening or closing block element tag is wrapped in a <p>, unwrap it.
  480. $text = preg_replace( '!<p>\s*(</?' . $allblocks . '[^>]*>)\s*</p>!', '$1', $text );
  481. // In some cases <li> may get wrapped in <p>, fix them.
  482. $text = preg_replace( '|<p>(<li.+?)</p>|', '$1', $text );
  483. // If a <blockquote> is wrapped with a <p>, move it inside the <blockquote>.
  484. $text = preg_replace( '|<p><blockquote([^>]*)>|i', '<blockquote$1><p>', $text );
  485. $text = str_replace( '</blockquote></p>', '</p></blockquote>', $text );
  486. // If an opening or closing block element tag is preceded by an opening <p> tag, remove it.
  487. $text = preg_replace( '!<p>\s*(</?' . $allblocks . '[^>]*>)!', '$1', $text );
  488. // If an opening or closing block element tag is followed by a closing <p> tag, remove it.
  489. $text = preg_replace( '!(</?' . $allblocks . '[^>]*>)\s*</p>!', '$1', $text );
  490. // Optionally insert line breaks.
  491. if ( $br ) {
  492. // Replace newlines that shouldn't be touched with a placeholder.
  493. $text = preg_replace_callback( '/<(script|style|svg).*?<\/\\1>/s', '_autop_newline_preservation_helper', $text );
  494. // Normalize <br>
  495. $text = str_replace( array( '<br>', '<br/>' ), '<br />', $text );
  496. // Replace any new line characters that aren't preceded by a <br /> with a <br />.
  497. $text = preg_replace( '|(?<!<br />)\s*\n|', "<br />\n", $text );
  498. // Replace newline placeholders with newlines.
  499. $text = str_replace( '<WPPreserveNewline />', "\n", $text );
  500. }
  501. // If a <br /> tag is after an opening or closing block tag, remove it.
  502. $text = preg_replace( '!(</?' . $allblocks . '[^>]*>)\s*<br />!', '$1', $text );
  503. // If a <br /> tag is before a subset of opening or closing block tags, remove it.
  504. $text = preg_replace( '!<br />(\s*</?(?:p|li|div|dl|dd|dt|th|pre|td|ul|ol)[^>]*>)!', '$1', $text );
  505. $text = preg_replace( "|\n</p>$|", '</p>', $text );
  506. // Replace placeholder <pre> tags with their original content.
  507. if ( ! empty( $pre_tags ) ) {
  508. $text = str_replace( array_keys( $pre_tags ), array_values( $pre_tags ), $text );
  509. }
  510. // Restore newlines in all elements.
  511. if ( false !== strpos( $text, '<!-- wpnl -->' ) ) {
  512. $text = str_replace( array( ' <!-- wpnl --> ', '<!-- wpnl -->' ), "\n", $text );
  513. }
  514. return $text;
  515. }
  516. /**
  517. * Separates 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. * Retrieves 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. * Retrieves 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 Optional. The result from _get_wptexturize_shortcode_regex().
  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. * Retrieves 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. * Replaces 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 $text The content.
  710. * @return string The filtered content.
  711. */
  712. function shortcode_unautop( $text ) {
  713. global $shortcode_tags;
  714. if ( empty( $shortcode_tags ) || ! is_array( $shortcode_tags ) ) {
  715. return $text;
  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', $text );
  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. * Encodes 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. * @since 6.0.0 Added the `$locale` parameter.
  1436. * @since 6.1.0 Added Unicode NFC encoding normalization support.
  1437. *
  1438. * @param string $string Text that might have accent characters.
  1439. * @param string $locale Optional. The locale to use for accent removal. Some character
  1440. * replacements depend on the locale being used (e.g. 'de_DE').
  1441. * Defaults to the current locale.
  1442. * @return string Filtered string with replaced "nice" characters.
  1443. */
  1444. function remove_accents( $string, $locale = '' ) {
  1445. if ( ! preg_match( '/[\x80-\xff]/', $string ) ) {
  1446. return $string;
  1447. }
  1448. if ( seems_utf8( $string ) ) {
  1449. // Unicode sequence normalization from NFD (Normalization Form Decomposed)
  1450. // to NFC (Normalization Form [Pre]Composed), the encoding used in this function.
  1451. if ( function_exists( 'normalizer_is_normalized' )
  1452. && function_exists( 'normalizer_normalize' )
  1453. ) {
  1454. if ( ! normalizer_is_normalized( $string ) ) {
  1455. $string = normalizer_normalize( $string );
  1456. }
  1457. }
  1458. $chars = array(
  1459. // Decompositions for Latin-1 Supplement.
  1460. 'ª' => 'a',
  1461. 'º' => 'o',
  1462. 'À' => 'A',
  1463. 'Á' => 'A',
  1464. 'Â' => 'A',
  1465. 'Ã' => 'A',
  1466. 'Ä' => 'A',
  1467. 'Å' => 'A',
  1468. 'Æ' => 'AE',
  1469. 'Ç' => 'C',
  1470. 'È' => 'E',
  1471. 'É' => 'E',
  1472. 'Ê' => 'E',
  1473. 'Ë' => 'E',
  1474. 'Ì' => 'I',
  1475. 'Í' => 'I',
  1476. 'Î' => 'I',
  1477. 'Ï' => 'I',
  1478. 'Ð' => 'D',
  1479. 'Ñ' => 'N',
  1480. 'Ò' => 'O',
  1481. 'Ó' => 'O',
  1482. 'Ô' => 'O',
  1483. 'Õ' => 'O',
  1484. 'Ö' => 'O',
  1485. 'Ù' => 'U',
  1486. 'Ú' => 'U',
  1487. 'Û' => 'U',
  1488. 'Ü' => 'U',
  1489. 'Ý' => 'Y',
  1490. 'Þ' => 'TH',
  1491. 'ß' => 's',
  1492. 'à' => 'a',
  1493. 'á' => 'a',
  1494. 'â' => 'a',
  1495. 'ã' => 'a',
  1496. 'ä' => 'a',
  1497. 'å' => 'a',
  1498. 'æ' => 'ae',
  1499. 'ç' => 'c',
  1500. 'è' => 'e',
  1501. 'é' => 'e',
  1502. 'ê' => 'e',
  1503. 'ë' => 'e',
  1504. 'ì' => 'i',
  1505. 'í' => 'i',
  1506. 'î' => 'i',
  1507. 'ï' => 'i',
  1508. 'ð' => 'd',
  1509. 'ñ' => 'n',
  1510. 'ò' => 'o',
  1511. 'ó' => 'o',
  1512. 'ô' => 'o',
  1513. 'õ' => 'o',
  1514. 'ö' => 'o',
  1515. 'ø' => 'o',
  1516. 'ù' => 'u',
  1517. 'ú' => 'u',
  1518. 'û' => 'u',
  1519. 'ü' => 'u',
  1520. 'ý' => 'y',
  1521. 'þ' => 'th',
  1522. 'ÿ' => 'y',
  1523. 'Ø' => 'O',
  1524. // Decompositions for Latin Extended-A.
  1525. 'Ā' => 'A',
  1526. 'ā' => 'a',
  1527. 'Ă' => 'A',
  1528. 'ă' => 'a',
  1529. 'Ą' => 'A',
  1530. 'ą' => 'a',
  1531. 'Ć' => 'C',
  1532. 'ć' => 'c',
  1533. 'Ĉ' => 'C',
  1534. 'ĉ' => 'c',
  1535. 'Ċ' => 'C',
  1536. 'ċ' => 'c',
  1537. 'Č' => 'C',
  1538. 'č' => 'c',
  1539. 'Ď' => 'D',
  1540. 'ď' => 'd',
  1541. 'Đ' => 'D',
  1542. 'đ' => 'd',
  1543. 'Ē' => 'E',
  1544. 'ē' => 'e',
  1545. 'Ĕ' => 'E',
  1546. 'ĕ' => 'e',
  1547. 'Ė' => 'E',
  1548. 'ė' => 'e',
  1549. 'Ę' => 'E',
  1550. 'ę' => 'e',
  1551. 'Ě' => 'E',
  1552. 'ě' => 'e',
  1553. 'Ĝ' => 'G',
  1554. 'ĝ' => 'g',
  1555. 'Ğ' => 'G',
  1556. 'ğ' => 'g',
  1557. 'Ġ' => 'G',
  1558. 'ġ' => 'g',
  1559. 'Ģ' => 'G',
  1560. 'ģ' => 'g',
  1561. 'Ĥ' => 'H',
  1562. 'ĥ' => 'h',
  1563. 'Ħ' => 'H',
  1564. 'ħ' => 'h',
  1565. 'Ĩ' => 'I',
  1566. 'ĩ' => 'i',
  1567. 'Ī' => 'I',
  1568. 'ī' => 'i',
  1569. 'Ĭ' => 'I',
  1570. 'ĭ' => 'i',
  1571. 'Į' => 'I',
  1572. 'į' => 'i',
  1573. 'İ' => 'I',
  1574. 'ı' => 'i',
  1575. 'IJ' => 'IJ',
  1576. 'ij' => 'ij',
  1577. 'Ĵ' => 'J',
  1578. 'ĵ' => 'j',
  1579. 'Ķ' => 'K',
  1580. 'ķ' => 'k',
  1581. 'ĸ' => 'k',
  1582. 'Ĺ' => 'L',
  1583. 'ĺ' => 'l',
  1584. 'Ļ' => 'L',
  1585. 'ļ' => 'l',
  1586. 'Ľ' => 'L',
  1587. 'ľ' => 'l',
  1588. 'Ŀ' => 'L',
  1589. 'ŀ' => 'l',
  1590. 'Ł' => 'L',
  1591. 'ł' => 'l',
  1592. 'Ń' => 'N',
  1593. 'ń' => 'n',
  1594. 'Ņ' => 'N',
  1595. 'ņ' => 'n',
  1596. 'Ň' => 'N',
  1597. 'ň' => 'n',
  1598. 'ʼn' => 'n',
  1599. 'Ŋ' => 'N',
  1600. 'ŋ' => 'n',
  1601. 'Ō' => 'O',
  1602. 'ō' => 'o',
  1603. 'Ŏ' => 'O',
  1604. 'ŏ' => 'o',
  1605. 'Ő' => 'O',
  1606. 'ő' => 'o',
  1607. 'Œ' => 'OE',
  1608. 'œ' => 'oe',
  1609. 'Ŕ' => 'R',
  1610. 'ŕ' => 'r',
  1611. 'Ŗ' => 'R',
  1612. 'ŗ' => 'r',
  1613. 'Ř' => 'R',
  1614. 'ř' => 'r',
  1615. 'Ś' => 'S',
  1616. 'ś' => 's',
  1617. 'Ŝ' => 'S',
  1618. 'ŝ' => 's',
  1619. 'Ş' => 'S',
  1620. 'ş' => 's',
  1621. 'Š' => 'S',
  1622. 'š' => 's',
  1623. 'Ţ' => 'T',
  1624. 'ţ' => 't',
  1625. 'Ť' => 'T',
  1626. 'ť' => 't',
  1627. 'Ŧ' => 'T',
  1628. 'ŧ' => 't',
  1629. 'Ũ' => 'U',
  1630. 'ũ' => 'u',
  1631. 'Ū' => 'U',
  1632. 'ū' => 'u',
  1633. 'Ŭ' => 'U',
  1634. 'ŭ' => 'u',
  1635. 'Ů' => 'U',
  1636. 'ů' => 'u',
  1637. 'Ű' => 'U',
  1638. 'ű' => 'u',
  1639. 'Ų' => 'U',
  1640. 'ų' => 'u',
  1641. 'Ŵ' => 'W',
  1642. 'ŵ' => 'w',
  1643. 'Ŷ' => 'Y',
  1644. 'ŷ' => 'y',
  1645. 'Ÿ' => 'Y',
  1646. 'Ź' => 'Z',
  1647. 'ź' => 'z',
  1648. 'Ż' => 'Z',
  1649. 'ż' => 'z',
  1650. 'Ž' => 'Z',
  1651. 'ž' => 'z',
  1652. 'ſ' => 's',
  1653. // Decompositions for Latin Extended-B.
  1654. 'Ș' => 'S',
  1655. 'ș' => 's',
  1656. 'Ț' => 'T',
  1657. 'ț' => 't',
  1658. // Euro sign.
  1659. '€' => 'E',
  1660. // GBP (Pound) sign.
  1661. '£' => '',
  1662. // Vowels with diacritic (Vietnamese).
  1663. // Unmarked.
  1664. 'Ơ' => 'O',
  1665. 'ơ' => 'o',
  1666. 'Ư' => 'U',
  1667. 'ư' => 'u',
  1668. // Grave accent.
  1669. 'Ầ' => 'A',
  1670. 'ầ' => 'a',
  1671. 'Ằ' => 'A',
  1672. 'ằ' => 'a',
  1673. 'Ề' => 'E',
  1674. 'ề' => 'e',
  1675. 'Ồ' => 'O',
  1676. 'ồ' => 'o',
  1677. 'Ờ' => 'O',
  1678. 'ờ' => 'o',
  1679. 'Ừ' => 'U',
  1680. 'ừ' => 'u',
  1681. 'Ỳ' => 'Y',
  1682. 'ỳ' => 'y',
  1683. // Hook.
  1684. 'Ả' => 'A',
  1685. 'ả' => 'a',
  1686. 'Ẩ' => 'A',
  1687. 'ẩ' => 'a',
  1688. 'Ẳ' => 'A',
  1689. 'ẳ' => 'a',
  1690. 'Ẻ' => 'E',
  1691. 'ẻ' => 'e',
  1692. 'Ể' => 'E',
  1693. 'ể' => 'e',
  1694. 'Ỉ' => 'I',
  1695. 'ỉ' => 'i',
  1696. 'Ỏ' => 'O',
  1697. 'ỏ' => 'o',
  1698. 'Ổ' => 'O',
  1699. 'ổ' => 'o',
  1700. 'Ở' => 'O',
  1701. 'ở' => 'o',
  1702. 'Ủ' => 'U',
  1703. 'ủ' => 'u',
  1704. 'Ử' => 'U',
  1705. 'ử' => 'u',
  1706. 'Ỷ' => 'Y',
  1707. 'ỷ' => 'y',
  1708. // Tilde.
  1709. 'Ẫ' => 'A',
  1710. 'ẫ' => 'a',
  1711. 'Ẵ' => 'A',
  1712. 'ẵ' => 'a',
  1713. 'Ẽ' => 'E',
  1714. 'ẽ' => 'e',
  1715. 'Ễ' => 'E',
  1716. 'ễ' => 'e',
  1717. 'Ỗ' => 'O',
  1718. 'ỗ' => 'o',
  1719. 'Ỡ' => 'O',
  1720. 'ỡ' => 'o',
  1721. 'Ữ' => 'U',
  1722. 'ữ' => 'u',
  1723. 'Ỹ' => 'Y',
  1724. 'ỹ' => 'y',
  1725. // Acute accent.
  1726. 'Ấ' => 'A',
  1727. 'ấ' => 'a',
  1728. 'Ắ' => 'A',
  1729. 'ắ' => 'a',
  1730. 'Ế' => 'E',
  1731. 'ế' => 'e',
  1732. 'Ố' => 'O',
  1733. 'ố' => 'o',
  1734. 'Ớ' => 'O',
  1735. 'ớ' => 'o',
  1736. 'Ứ' => 'U',
  1737. 'ứ' => 'u',
  1738. // Dot below.
  1739. 'Ạ' => 'A',
  1740. 'ạ' => 'a',
  1741. 'Ậ' => 'A',
  1742. 'ậ' => 'a',
  1743. 'Ặ' => 'A',
  1744. 'ặ' => 'a',
  1745. 'Ẹ' => 'E',
  1746. 'ẹ' => 'e',
  1747. 'Ệ' => 'E',
  1748. 'ệ' => 'e',
  1749. 'Ị' => 'I',
  1750. 'ị' => 'i',
  1751. 'Ọ' => 'O',
  1752. 'ọ' => 'o',
  1753. 'Ộ' => 'O',
  1754. 'ộ' => 'o',
  1755. 'Ợ' => 'O',
  1756. 'ợ' => 'o',
  1757. 'Ụ' => 'U',
  1758. 'ụ' => 'u',
  1759. 'Ự' => 'U',
  1760. 'ự' => 'u',
  1761. 'Ỵ' => 'Y',
  1762. 'ỵ' => 'y',
  1763. // Vowels with diacritic (Chinese, Hanyu Pinyin).
  1764. 'ɑ' => 'a',
  1765. // Macron.
  1766. 'Ǖ' => 'U',
  1767. 'ǖ' => 'u',
  1768. // Acute accent.
  1769. 'Ǘ' => 'U',
  1770. 'ǘ' => 'u',
  1771. // Caron.
  1772. 'Ǎ' => 'A',
  1773. 'ǎ' => 'a',
  1774. 'Ǐ' => 'I',
  1775. 'ǐ' => 'i',
  1776. 'Ǒ' => 'O',
  1777. 'ǒ' => 'o',
  1778. 'Ǔ' => 'U',
  1779. 'ǔ' => 'u',
  1780. 'Ǚ' => 'U',
  1781. 'ǚ' => 'u',
  1782. // Grave accent.
  1783. 'Ǜ' => 'U',
  1784. 'ǜ' => 'u',
  1785. );
  1786. // Used for locale-specific rules.
  1787. if ( empty( $locale ) ) {
  1788. $locale = get_locale();
  1789. }
  1790. /*
  1791. * German has various locales (de_DE, de_CH, de_AT, ...) with formal and informal variants.
  1792. * There is no 3-letter locale like 'def', so checking for 'de' instead of 'de_' is safe,
  1793. * since 'de' itself would be a valid locale too.
  1794. */
  1795. if ( str_starts_with( $locale, 'de' ) ) {
  1796. $chars['Ä'] = 'Ae';
  1797. $chars['ä'] = 'ae';
  1798. $chars['Ö'] = 'Oe';
  1799. $chars['ö'] = 'oe';
  1800. $chars['Ü'] = 'Ue';
  1801. $chars['ü'] = 'ue';
  1802. $chars['ß'] = 'ss';
  1803. } elseif ( 'da_DK' === $locale ) {
  1804. $chars['Æ'] = 'Ae';
  1805. $chars['æ'] = 'ae';
  1806. $chars['Ø'] = 'Oe';
  1807. $chars['ø'] = 'oe';
  1808. $chars['Å'] = 'Aa';
  1809. $chars['å'] = 'aa';
  1810. } elseif ( 'ca' === $locale ) {
  1811. $chars['l·l'] = 'll';
  1812. } elseif ( 'sr_RS' === $locale || 'bs_BA' === $locale ) {
  1813. $chars['Đ'] = 'DJ';
  1814. $chars['đ'] = 'dj';
  1815. }
  1816. $string = strtr( $string, $chars );
  1817. } else {
  1818. $chars = array();
  1819. // Assume ISO-8859-1 if not UTF-8.
  1820. $chars['in'] = "\x80\x83\x8a\x8e\x9a\x9e"
  1821. . "\x9f\xa2\xa5\xb5\xc0\xc1\xc2"
  1822. . "\xc3\xc4\xc5\xc7\xc8\xc9\xca"
  1823. . "\xcb\xcc\xcd\xce\xcf\xd1\xd2"
  1824. . "\xd3\xd4\xd5\xd6\xd8\xd9\xda"
  1825. . "\xdb\xdc\xdd\xe0\xe1\xe2\xe3"
  1826. . "\xe4\xe5\xe7\xe8\xe9\xea\xeb"
  1827. . "\xec\xed\xee\xef\xf1\xf2\xf3"
  1828. . "\xf4\xf5\xf6\xf8\xf9\xfa\xfb"
  1829. . "\xfc\xfd\xff";
  1830. $chars['out'] = 'EfSZszYcYuAAAAAACEEEEIIIINOOOOOOUUUUYaaaaaaceeeeiiiinoooooouuuuyy';
  1831. $string = strtr( $string, $chars['in'], $chars['out'] );
  1832. $double_chars = array();
  1833. $double_chars['in'] = array( "\x8c", "\x9c", "\xc6", "\xd0", "\xde", "\xdf", "\xe6", "\xf0", "\xfe" );
  1834. $double_chars['out'] = array( 'OE', 'oe', 'AE', 'DH', 'TH', 'ss', 'ae', 'dh', 'th' );
  1835. $string = str_replace( $double_chars['in'], $double_chars['out'], $string );
  1836. }
  1837. return $string;
  1838. }
  1839. /**
  1840. * Sanitizes a filename, replacing whitespace with dashes.
  1841. *
  1842. * Removes special characters that are illegal in filenames on certain
  1843. * operating systems and special characters requiring special escaping
  1844. * to manipulate at the command line. Replaces spaces and consecutive
  1845. * dashes with a single dash. Trims period, dash and underscore from beginning
  1846. * and end of filename. It is not guaranteed that this function will return a
  1847. * filename that is allowed to be uploaded.
  1848. *
  1849. * @since 2.1.0
  1850. *
  1851. * @param string $filename The filename to be sanitized.
  1852. * @return string The sanitized filename.
  1853. */
  1854. function sanitize_file_name( $filename ) {
  1855. $filename_raw = $filename;
  1856. $filename = remove_accents( $filename );
  1857. $special_chars = array( '?', '[', ']', '/', '\\', '=', '<', '>', ':', ';', ',', "'", '"', '&', '$', '#', '*', '(', ')', '|', '~', '`', '!', '{', '}', '%', '+', '’', '«', '»', '”', '“', chr( 0 ) );
  1858. // Check for support for utf8 in the installed PCRE library once and store the result in a static.
  1859. static $utf8_pcre = null;
  1860. if ( ! isset( $utf8_pcre ) ) {
  1861. // phpcs:ignore WordPress.PHP.NoSilencedErrors.Discouraged
  1862. $utf8_pcre = @preg_match( '/^./u', 'a' );
  1863. }
  1864. if ( ! seems_utf8( $filename ) ) {
  1865. $_ext = pathinfo( $filename, PATHINFO_EXTENSION );
  1866. $_name = pathinfo( $filename, PATHINFO_FILENAME );
  1867. $filename = sanitize_title_with_dashes( $_name ) . '.' . $_ext;
  1868. }
  1869. if ( $utf8_pcre ) {
  1870. $filename = preg_replace( "#\x{00a0}#siu", ' ', $filename );
  1871. }
  1872. /**
  1873. * Filters the list of characters to remove from a filename.
  1874. *
  1875. * @since 2.8.0
  1876. *
  1877. * @param string[] $special_chars Array of characters to remove.
  1878. * @param string $filename_raw The original filename to be sanitized.
  1879. */
  1880. $special_chars = apply_filters( 'sanitize_file_name_chars', $special_chars, $filename_raw );
  1881. $filename = str_replace( $special_chars, '', $filename );
  1882. $filename = str_replace( array( '%20', '+' ), '-', $filename );
  1883. $filename = preg_replace( '/[\r\n\t -]+/', '-', $filename );
  1884. $filename = trim( $filename, '.-_' );
  1885. if ( false === strpos( $filename, '.' ) ) {
  1886. $mime_types = wp_get_mime_types();
  1887. $filetype = wp_check_filetype( 'test.' . $filename, $mime_types );
  1888. if ( $filetype['ext'] === $filename ) {
  1889. $filename = 'unnamed-file.' . $filetype['ext'];
  1890. }
  1891. }
  1892. // Split the filename into a base and extension[s].
  1893. $parts = explode( '.', $filename );
  1894. // Return if only one extension.
  1895. if ( count( $parts ) <= 2 ) {
  1896. /** This filter is documented in wp-includes/formatting.php */
  1897. return apply_filters( 'sanitize_file_name', $filename, $filename_raw );
  1898. }
  1899. // Process multiple extensions.
  1900. $filename = array_shift( $parts );
  1901. $extension = array_pop( $parts );
  1902. $mimes = get_allowed_mime_types();
  1903. /*
  1904. * Loop over any intermediate extensions. Postfix them with a trailing underscore
  1905. * if they are a 2 - 5 character long alpha string not in the allowed extension list.
  1906. */
  1907. foreach ( (array) $parts as $part ) {
  1908. $filename .= '.' . $part;
  1909. if ( preg_match( '/^[a-zA-Z]{2,5}\d?$/', $part ) ) {
  1910. $allowed = false;
  1911. foreach ( $mimes as $ext_preg => $mime_match ) {
  1912. $ext_preg = '!^(' . $ext_preg . ')$!i';
  1913. if ( preg_match( $ext_preg, $part ) ) {
  1914. $allowed = true;
  1915. break;
  1916. }
  1917. }
  1918. if ( ! $allowed ) {
  1919. $filename .= '_';
  1920. }
  1921. }
  1922. }
  1923. $filename .= '.' . $extension;
  1924. /**
  1925. * Filters a sanitized filename string.
  1926. *
  1927. * @since 2.8.0
  1928. *
  1929. * @param string $filename Sanitized filename.
  1930. * @param string $filename_raw The filename prior to sanitization.
  1931. */
  1932. return apply_filters( 'sanitize_file_name', $filename, $filename_raw );
  1933. }
  1934. /**
  1935. * Sanitizes a username, stripping out unsafe characters.
  1936. *
  1937. * Removes tags, octets, entities, and if strict is enabled, will only keep
  1938. * alphanumeric, _, space, ., -, @. After sanitizing, it passes the username,
  1939. * raw username (the username in the parameter), and the value of $strict as
  1940. * parameters for the {@see 'sanitize_user'} filter.
  1941. *
  1942. * @since 2.0.0
  1943. *
  1944. * @param string $username The username to be sanitized.
  1945. * @param bool $strict Optional. If set limits $username to specific characters.
  1946. * Default false.
  1947. * @return string The sanitized username, after passing through filters.
  1948. */
  1949. function sanitize_user( $username, $strict = false ) {
  1950. $raw_username = $username;
  1951. $username = wp_strip_all_tags( $username );
  1952. $username = remove_accents( $username );
  1953. // Kill octets.
  1954. $username = preg_replace( '|%([a-fA-F0-9][a-fA-F0-9])|', '', $username );
  1955. // Kill entities.
  1956. $username = preg_replace( '/&.+?;/', '', $username );
  1957. // If strict, reduce to ASCII for max portability.
  1958. if ( $strict ) {
  1959. $username = preg_replace( '|[^a-z0-9 _.\-@]|i', '', $username );
  1960. }
  1961. $username = trim( $username );
  1962. // Consolidate contiguous whitespace.
  1963. $username = preg_replace( '|\s+|', ' ', $username );
  1964. /**
  1965. * Filters a sanitized username string.
  1966. *
  1967. * @since 2.0.1
  1968. *
  1969. * @param string $username Sanitized username.
  1970. * @param string $raw_username The username prior to sanitization.
  1971. * @param bool $strict Whether to limit the sanitization to specific characters.
  1972. */
  1973. return apply_filters( 'sanitize_user', $username, $raw_username, $strict );
  1974. }
  1975. /**
  1976. * Sanitizes a string key.
  1977. *
  1978. * Keys are used as internal identifiers. Lowercase alphanumeric characters,
  1979. * dashes, and underscores are allowed.
  1980. *
  1981. * @since 3.0.0
  1982. *
  1983. * @param string $key String key.
  1984. * @return string Sanitized key.
  1985. */
  1986. function sanitize_key( $key ) {
  1987. $sanitized_key = '';
  1988. if ( is_scalar( $key ) ) {
  1989. $sanitized_key = strtolower( $key );
  1990. $sanitized_key = preg_replace( '/[^a-z0-9_\-]/', '', $sanitized_key );
  1991. }
  1992. /**
  1993. * Filters a sanitized key string.
  1994. *
  1995. * @since 3.0.0
  1996. *
  1997. * @param string $sanitized_key Sanitized key.
  1998. * @param string $key The key prior to sanitization.
  1999. */
  2000. return apply_filters( 'sanitize_key', $sanitized_key, $key );
  2001. }
  2002. /**
  2003. * Sanitizes a string into a slug, which can be used in URLs or HTML attributes.
  2004. *
  2005. * By default, converts accent characters to ASCII characters and further
  2006. * limits the output to alphanumeric characters, underscore (_) and dash (-)
  2007. * through the {@see 'sanitize_title'} filter.
  2008. *
  2009. * If `$title` is empty and `$fallback_title` is set, the latter will be used.
  2010. *
  2011. * @since 1.0.0
  2012. *
  2013. * @param string $title The string to be sanitized.
  2014. * @param string $fallback_title Optional. A title to use if $title is empty. Default empty.
  2015. * @param string $context Optional. The operation for which the string is sanitized.
  2016. * When set to 'save', the string runs through remove_accents().
  2017. * Default 'save'.
  2018. * @return string The sanitized string.
  2019. */
  2020. function sanitize_title( $title, $fallback_title = '', $context = 'save' ) {
  2021. $raw_title = $title;
  2022. if ( 'save' === $context ) {
  2023. $title = remove_accents( $title );
  2024. }
  2025. /**
  2026. * Filters a sanitized title string.
  2027. *
  2028. * @since 1.2.0
  2029. *
  2030. * @param string $title Sanitized title.
  2031. * @param string $raw_title The title prior to sanitization.
  2032. * @param string $context The context for which the title is being sanitized.
  2033. */
  2034. $title = apply_filters( 'sanitize_title', $title, $raw_title, $context );
  2035. if ( '' === $title || false === $title ) {
  2036. $title = $fallback_title;
  2037. }
  2038. return $title;
  2039. }
  2040. /**
  2041. * Sanitizes a title with the 'query' context.
  2042. *
  2043. * Used for querying the database for a value from URL.
  2044. *
  2045. * @since 3.1.0
  2046. *
  2047. * @param string $title The string to be sanitized.
  2048. * @return string The sanitized string.
  2049. */
  2050. function sanitize_title_for_query( $title ) {
  2051. return sanitize_title( $title, '', 'query' );
  2052. }
  2053. /**
  2054. * Sanitizes a title, replacing whitespace and a few other characters with dashes.
  2055. *
  2056. * Limits the output to alphanumeric characters, underscore (_) and dash (-).
  2057. * Whitespace becomes a dash.
  2058. *
  2059. * @since 1.2.0
  2060. *
  2061. * @param string $title The title to be sanitized.
  2062. * @param string $raw_title Optional. Not used. Default empty.
  2063. * @param string $context Optional. The operation for which the string is sanitized.
  2064. * When set to 'save', additional entities are converted to hyphens
  2065. * or stripped entirely. Default 'display'.
  2066. * @return string The sanitized title.
  2067. */
  2068. function sanitize_title_with_dashes( $title, $raw_title = '', $context = 'display' ) {
  2069. $title = strip_tags( $title );
  2070. // Preserve escaped octets.
  2071. $title = preg_replace( '|%([a-fA-F0-9][a-fA-F0-9])|', '---$1---', $title );
  2072. // Remove percent signs that are not part of an octet.
  2073. $title = str_replace( '%', '', $title );
  2074. // Restore octets.
  2075. $title = preg_replace( '|---([a-fA-F0-9][a-fA-F0-9])---|', '%$1', $title );
  2076. if ( seems_utf8( $title ) ) {
  2077. if ( function_exists( 'mb_strtolower' ) ) {
  2078. $title = mb_strtolower( $title, 'UTF-8' );
  2079. }
  2080. $title = utf8_uri_encode( $title, 200 );
  2081. }
  2082. $title = strtolower( $title );
  2083. if ( 'save' === $context ) {
  2084. // Convert &nbsp, &ndash, and &mdash to hyphens.
  2085. $title = str_replace( array( '%c2%a0', '%e2%80%93', '%e2%80%94' ), '-', $title );
  2086. // Convert &nbsp, &ndash, and &mdash HTML entities to hyphens.
  2087. $title = str_replace( array( '&nbsp;', '&#160;', '&ndash;', '&#8211;', '&mdash;', '&#8212;' ), '-', $title );
  2088. // Convert forward slash to hyphen.
  2089. $title = str_replace( '/', '-', $title );
  2090. // Strip these characters entirely.
  2091. $title = str_replace(
  2092. array(
  2093. // Soft hyphens.
  2094. '%c2%ad',
  2095. // &iexcl and &iquest.
  2096. '%c2%a1',
  2097. '%c2%bf',
  2098. // Angle quotes.
  2099. '%c2%ab',
  2100. '%c2%bb',
  2101. '%e2%80%b9',
  2102. '%e2%80%ba',
  2103. // Curly quotes.
  2104. '%e2%80%98',
  2105. '%e2%80%99',
  2106. '%e2%80%9c',
  2107. '%e2%80%9d',
  2108. '%e2%80%9a',
  2109. '%e2%80%9b',
  2110. '%e2%80%9e',
  2111. '%e2%80%9f',
  2112. // Bullet.
  2113. '%e2%80%a2',
  2114. // &copy, &reg, &deg, &hellip, and &trade.
  2115. '%c2%a9',
  2116. '%c2%ae',
  2117. '%c2%b0',
  2118. '%e2%80%a6',
  2119. '%e2%84%a2',
  2120. // Acute accents.
  2121. '%c2%b4',
  2122. '%cb%8a',
  2123. '%cc%81',
  2124. '%cd%81',
  2125. // Grave accent, macron, caron.
  2126. '%cc%80',
  2127. '%cc%84',
  2128. '%cc%8c',
  2129. // Non-visible characters that display without a width.
  2130. '%e2%80%8b', // Zero width space.
  2131. '%e2%80%8c', // Zero width non-joiner.
  2132. '%e2%80%8d', // Zero width joiner.
  2133. '%e2%80%8e', // Left-to-right mark.
  2134. '%e2%80%8f', // Right-to-left mark.
  2135. '%e2%80%aa', // Left-to-right embedding.
  2136. '%e2%80%ab', // Right-to-left embedding.
  2137. '%e2%80%ac', // Pop directional formatting.
  2138. '%e2%80%ad', // Left-to-right override.
  2139. '%e2%80%ae', // Right-to-left override.
  2140. '%ef%bb%bf', // Byte order mark.
  2141. '%ef%bf%bc', // Object replacement character.
  2142. ),
  2143. '',
  2144. $title
  2145. );
  2146. // Convert non-visible characters that display with a width to hyphen.
  2147. $title = str_replace(
  2148. array(
  2149. '%e2%80%80', // En quad.
  2150. '%e2%80%81', // Em quad.
  2151. '%e2%80%82', // En space.
  2152. '%e2%80%83', // Em space.
  2153. '%e2%80%84', // Three-per-em space.
  2154. '%e2%80%85', // Four-per-em space.
  2155. '%e2%80%86', // Six-per-em space.
  2156. '%e2%80%87', // Figure space.
  2157. '%e2%80%88', // Punctuation space.
  2158. '%e2%80%89', // Thin space.
  2159. '%e2%80%8a', // Hair space.
  2160. '%e2%80%a8', // Line separator.
  2161. '%e2%80%a9', // Paragraph separator.
  2162. '%e2%80%af', // Narrow no-break space.
  2163. ),
  2164. '-',
  2165. $title
  2166. );
  2167. // Convert &times to 'x'.
  2168. $title = str_replace( '%c3%97', 'x', $title );
  2169. }
  2170. // Kill entities.
  2171. $title = preg_replace( '/&.+?;/', '', $title );
  2172. $title = str_replace( '.', '-', $title );
  2173. $title = preg_replace( '/[^%a-z0-9 _-]/', '', $title );
  2174. $title = preg_replace( '/\s+/', '-', $title );
  2175. $title = preg_replace( '|-+|', '-', $title );
  2176. $title = trim( $title, '-' );
  2177. return $title;
  2178. }
  2179. /**
  2180. * Ensures a string is a valid SQL 'order by' clause.
  2181. *
  2182. * Accepts one or more columns, with or without a sort order (ASC / DESC).
  2183. * e.g. 'column_1', 'column_1, column_2', 'column_1 ASC, column_2 DESC' etc.
  2184. *
  2185. * Also accepts 'RAND()'.
  2186. *
  2187. * @since 2.5.1
  2188. *
  2189. * @param string $orderby Order by clause to be validated.
  2190. * @return string|false Returns $orderby if valid, false otherwise.
  2191. */
  2192. function sanitize_sql_orderby( $orderby ) {
  2193. 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 ) ) {
  2194. return $orderby;
  2195. }
  2196. return false;
  2197. }
  2198. /**
  2199. * Sanitizes an HTML classname to ensure it only contains valid characters.
  2200. *
  2201. * Strips the string down to A-Z,a-z,0-9,_,-. If this results in an empty
  2202. * string then it will return the alternative value supplied.
  2203. *
  2204. * @todo Expand to support the full range of CDATA that a class attribute can contain.
  2205. *
  2206. * @since 2.8.0
  2207. *
  2208. * @param string $class The classname to be sanitized
  2209. * @param string $fallback Optional. The value to return if the sanitization ends up as an empty string.
  2210. * Defaults to an empty string.
  2211. * @return string The sanitized value
  2212. */
  2213. function sanitize_html_class( $class, $fallback = '' ) {
  2214. // Strip out any %-encoded octets.
  2215. $sanitized = preg_replace( '|%[a-fA-F0-9][a-fA-F0-9]|', '', $class );
  2216. // Limit to A-Z, a-z, 0-9, '_', '-'.
  2217. $sanitized = preg_replace( '/[^A-Za-z0-9_-]/', '', $sanitized );
  2218. if ( '' === $sanitized && $fallback ) {
  2219. return sanitize_html_class( $fallback );
  2220. }
  2221. /**
  2222. * Filters a sanitized HTML class string.
  2223. *
  2224. * @since 2.8.0
  2225. *
  2226. * @param string $sanitized The sanitized HTML class.
  2227. * @param string $class HTML class before sanitization.
  2228. * @param string $fallback The fallback string.
  2229. */
  2230. return apply_filters( 'sanitize_html_class', $sanitized, $class, $fallback );
  2231. }
  2232. /**
  2233. * Converts lone & characters into `&#038;` (a.k.a. `&amp;`)
  2234. *
  2235. * @since 0.71
  2236. *
  2237. * @param string $content String of characters to be converted.
  2238. * @param string $deprecated Not used.
  2239. * @return string Converted string.
  2240. */
  2241. function convert_chars( $content, $deprecated = '' ) {
  2242. if ( ! empty( $deprecated ) ) {
  2243. _deprecated_argument( __FUNCTION__, '0.71' );
  2244. }
  2245. if ( strpos( $content, '&' ) !== false ) {
  2246. $content = preg_replace( '/&([^#])(?![a-z1-4]{1,8};)/i', '&#038;$1', $content );
  2247. }
  2248. return $content;
  2249. }
  2250. /**
  2251. * Converts invalid Unicode references range to valid range.
  2252. *
  2253. * @since 4.3.0
  2254. *
  2255. * @param string $content String with entities that need converting.
  2256. * @return string Converted string.
  2257. */
  2258. function convert_invalid_entities( $content ) {
  2259. $wp_htmltranswinuni = array(
  2260. '&#128;' => '&#8364;', // The Euro sign.
  2261. '&#129;' => '',
  2262. '&#130;' => '&#8218;', // These are Windows CP1252 specific characters.
  2263. '&#131;' => '&#402;', // They would look weird on non-Windows browsers.
  2264. '&#132;' => '&#8222;',
  2265. '&#133;' => '&#8230;',
  2266. '&#134;' => '&#8224;',
  2267. '&#135;' => '&#8225;',
  2268. '&#136;' => '&#710;',
  2269. '&#137;' => '&#8240;',
  2270. '&#138;' => '&#352;',
  2271. '&#139;' => '&#8249;',
  2272. '&#140;' => '&#338;',
  2273. '&#141;' => '',
  2274. '&#142;' => '&#381;',
  2275. '&#143;' => '',
  2276. '&#144;' => '',
  2277. '&#145;' => '&#8216;',
  2278. '&#146;' => '&#8217;',
  2279. '&#147;' => '&#8220;',
  2280. '&#148;' => '&#8221;',
  2281. '&#149;' => '&#8226;',
  2282. '&#150;' => '&#8211;',
  2283. '&#151;' => '&#8212;',
  2284. '&#152;' => '&#732;',
  2285. '&#153;' => '&#8482;',
  2286. '&#154;' => '&#353;',
  2287. '&#155;' => '&#8250;',
  2288. '&#156;' => '&#339;',
  2289. '&#157;' => '',
  2290. '&#158;' => '&#382;',
  2291. '&#159;' => '&#376;',
  2292. );
  2293. if ( strpos( $content, '&#1' ) !== false ) {
  2294. $content = strtr( $content, $wp_htmltranswinuni );
  2295. }
  2296. return $content;
  2297. }
  2298. /**
  2299. * Balances tags if forced to, or if the 'use_balanceTags' option is set to true.
  2300. *
  2301. * @since 0.71
  2302. *
  2303. * @param string $text Text to be balanced
  2304. * @param bool $force If true, forces balancing, ignoring the value of the option. Default false.
  2305. * @return string Balanced text
  2306. */
  2307. function balanceTags( $text, $force = false ) { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionNameInvalid
  2308. if ( $force || (int) get_option( 'use_balanceTags' ) === 1 ) {
  2309. return force_balance_tags( $text );
  2310. } else {
  2311. return $text;
  2312. }
  2313. }
  2314. /**
  2315. * Balances tags of string using a modified stack.
  2316. *
  2317. * @since 2.0.4
  2318. * @since 5.3.0 Improve accuracy and add support for custom element tags.
  2319. *
  2320. * @author Leonard Lin <leonard@acm.org>
  2321. * @license GPL
  2322. * @copyright November 4, 2001
  2323. * @version 1.1
  2324. * @todo Make better - change loop condition to $text in 1.2
  2325. * @internal Modified by Scott Reilly (coffee2code) 02 Aug 2004
  2326. * 1.1 Fixed handling of append/stack pop order of end text
  2327. * Added Cleaning Hooks
  2328. * 1.0 First Version
  2329. *
  2330. * @param string $text Text to be balanced.
  2331. * @return string Balanced text.
  2332. */
  2333. function force_balance_tags( $text ) {
  2334. $tagstack = array();
  2335. $stacksize = 0;
  2336. $tagqueue = '';
  2337. $newtext = '';
  2338. // Known single-entity/self-closing tags.
  2339. $single_tags = array( 'area', 'base', 'basefont', 'br', 'col', 'command', 'embed', 'frame', 'hr', 'img', 'input', 'isindex', 'link', 'meta', 'param', 'source', 'track', 'wbr' );
  2340. // Tags that can be immediately nested within themselves.
  2341. $nestable_tags = array( 'article', 'aside', 'blockquote', 'details', 'div', 'figure', 'object', 'q', 'section', 'span' );
  2342. // WP bug fix for comments - in case you REALLY meant to type '< !--'.
  2343. $text = str_replace( '< !--', '< !--', $text );
  2344. // WP bug fix for LOVE <3 (and other situations with '<' before a number).
  2345. $text = preg_replace( '#<([0-9]{1})#', '&lt;$1', $text );
  2346. /**
  2347. * Matches supported tags.
  2348. *
  2349. * To get the pattern as a string without the comments paste into a PHP
  2350. * REPL like `php -a`.
  2351. *
  2352. * @see https://html.spec.whatwg.org/#elements-2
  2353. * @see https://html.spec.whatwg.org/multipage/custom-elements.html#valid-custom-element-name
  2354. *
  2355. * @example
  2356. * ~# php -a
  2357. * php > $s = [paste copied contents of expression below including parentheses];
  2358. * php > echo $s;
  2359. */
  2360. $tag_pattern = (
  2361. '#<' . // Start with an opening bracket.
  2362. '(/?)' . // Group 1 - If it's a closing tag it'll have a leading slash.
  2363. '(' . // Group 2 - Tag name.
  2364. // Custom element tags have more lenient rules than HTML tag names.
  2365. '(?:[a-z](?:[a-z0-9._]*)-(?:[a-z0-9._-]+)+)' .
  2366. '|' .
  2367. // Traditional tag rules approximate HTML tag names.
  2368. '(?:[\w:]+)' .
  2369. ')' .
  2370. '(?:' .
  2371. // We either immediately close the tag with its '>' and have nothing here.
  2372. '\s*' .
  2373. '(/?)' . // Group 3 - "attributes" for empty tag.
  2374. '|' .
  2375. // Or we must start with space characters to separate the tag name from the attributes (or whitespace).
  2376. '(\s+)' . // Group 4 - Pre-attribute whitespace.
  2377. '([^>]*)' . // Group 5 - Attributes.
  2378. ')' .
  2379. '>#' // End with a closing bracket.
  2380. );
  2381. while ( preg_match( $tag_pattern, $text, $regex ) ) {
  2382. $full_match = $regex[0];
  2383. $has_leading_slash = ! empty( $regex[1] );
  2384. $tag_name = $regex[2];
  2385. $tag = strtolower( $tag_name );
  2386. $is_single_tag = in_array( $tag, $single_tags, true );
  2387. $pre_attribute_ws = isset( $regex[4] ) ? $regex[4] : '';
  2388. $attributes = trim( isset( $regex[5] ) ? $regex[5] : $regex[3] );
  2389. $has_self_closer = '/' === substr( $attributes, -1 );
  2390. $newtext .= $tagqueue;
  2391. $i = strpos( $text, $full_match );
  2392. $l = strlen( $full_match );
  2393. // Clear the shifter.
  2394. $tagqueue = '';
  2395. if ( $has_leading_slash ) { // End tag.
  2396. // If too many closing tags.
  2397. if ( $stacksize <= 0 ) {
  2398. $tag = '';
  2399. // Or close to be safe $tag = '/' . $tag.
  2400. // If stacktop value = tag close value, then pop.
  2401. } elseif ( $tagstack[ $stacksize - 1 ] === $tag ) { // Found closing tag.
  2402. $tag = '</' . $tag . '>'; // Close tag.
  2403. array_pop( $tagstack );
  2404. $stacksize--;
  2405. } else { // Closing tag not at top, search for it.
  2406. for ( $j = $stacksize - 1; $j >= 0; $j-- ) {
  2407. if ( $tagstack[ $j ] === $tag ) {
  2408. // Add tag to tagqueue.
  2409. for ( $k = $stacksize - 1; $k >= $j; $k-- ) {
  2410. $tagqueue .= '</' . array_pop( $tagstack ) . '>';
  2411. $stacksize--;
  2412. }
  2413. break;
  2414. }
  2415. }
  2416. $tag = '';
  2417. }
  2418. } else { // Begin tag.
  2419. if ( $has_self_closer ) { // If it presents itself as a self-closing tag...
  2420. // ...but it isn't a known single-entity self-closing tag, then don't let it be treated as such
  2421. // and immediately close it with a closing tag (the tag will encapsulate no text as a result).
  2422. if ( ! $is_single_tag ) {
  2423. $attributes = trim( substr( $attributes, 0, -1 ) ) . "></$tag";
  2424. }
  2425. } elseif ( $is_single_tag ) { // Else if it's a known single-entity tag but it doesn't close itself, do so.
  2426. $pre_attribute_ws = ' ';
  2427. $attributes .= '/';
  2428. } else { // It's not a single-entity tag.
  2429. // If the top of the stack is the same as the tag we want to push, close previous tag.
  2430. if ( $stacksize > 0 && ! in_array( $tag, $nestable_tags, true ) && $tagstack[ $stacksize - 1 ] === $tag ) {
  2431. $tagqueue = '</' . array_pop( $tagstack ) . '>';
  2432. $stacksize--;
  2433. }
  2434. $stacksize = array_push( $tagstack, $tag );
  2435. }
  2436. // Attributes.
  2437. if ( $has_self_closer && $is_single_tag ) {
  2438. // We need some space - avoid <br/> and prefer <br />.
  2439. $pre_attribute_ws = ' ';
  2440. }
  2441. $tag = '<' . $tag . $pre_attribute_ws . $attributes . '>';
  2442. // If already queuing a close tag, then put this tag on too.
  2443. if ( ! empty( $tagqueue ) ) {
  2444. $tagqueue .= $tag;
  2445. $tag = '';
  2446. }
  2447. }
  2448. $newtext .= substr( $text, 0, $i ) . $tag;
  2449. $text = substr( $text, $i + $l );
  2450. }
  2451. // Clear tag queue.
  2452. $newtext .= $tagqueue;
  2453. // Add remaining text.
  2454. $newtext .= $text;
  2455. while ( $x = array_pop( $tagstack ) ) {
  2456. $newtext .= '</' . $x . '>'; // Add remaining tags to close.
  2457. }
  2458. // WP fix for the bug with HTML comments.
  2459. $newtext = str_replace( '< !--', '<!--', $newtext );
  2460. $newtext = str_replace( '< !--', '< !--', $newtext );
  2461. return $newtext;
  2462. }
  2463. /**
  2464. * Acts on text which is about to be edited.
  2465. *
  2466. * The $content is run through esc_textarea(), which uses htmlspecialchars()
  2467. * to convert special characters to HTML entities. If `$richedit` is set to true,
  2468. * it is simply a holder for the {@see 'format_to_edit'} filter.
  2469. *
  2470. * @since 0.71
  2471. * @since 4.4.0 The `$richedit` parameter was renamed to `$rich_text` for clarity.
  2472. *
  2473. * @param string $content The text about to be edited.
  2474. * @param bool $rich_text Optional. Whether `$content` should be considered rich text,
  2475. * in which case it would not be passed through esc_textarea().
  2476. * Default false.
  2477. * @return string The text after the filter (and possibly htmlspecialchars()) has been run.
  2478. */
  2479. function format_to_edit( $content, $rich_text = false ) {
  2480. /**
  2481. * Filters the text to be formatted for editing.
  2482. *
  2483. * @since 1.2.0
  2484. *
  2485. * @param string $content The text, prior to formatting for editing.
  2486. */
  2487. $content = apply_filters( 'format_to_edit', $content );
  2488. if ( ! $rich_text ) {
  2489. $content = esc_textarea( $content );
  2490. }
  2491. return $content;
  2492. }
  2493. /**
  2494. * Add leading zeros when necessary.
  2495. *
  2496. * If you set the threshold to '4' and the number is '10', then you will get
  2497. * back '0010'. If you set the threshold to '4' and the number is '5000', then you
  2498. * will get back '5000'.
  2499. *
  2500. * Uses sprintf to append the amount of zeros based on the $threshold parameter
  2501. * and the size of the number. If the number is large enough, then no zeros will
  2502. * be appended.
  2503. *
  2504. * @since 0.71
  2505. *
  2506. * @param int $number Number to append zeros to if not greater than threshold.
  2507. * @param int $threshold Digit places number needs to be to not have zeros added.
  2508. * @return string Adds leading zeros to number if needed.
  2509. */
  2510. function zeroise( $number, $threshold ) {
  2511. return sprintf( '%0' . $threshold . 's', $number );
  2512. }
  2513. /**
  2514. * Adds backslashes before letters and before a number at the start of a string.
  2515. *
  2516. * @since 0.71
  2517. *
  2518. * @param string $string Value to which backslashes will be added.
  2519. * @return string String with backslashes inserted.
  2520. */
  2521. function backslashit( $string ) {
  2522. if ( isset( $string[0] ) && $string[0] >= '0' && $string[0] <= '9' ) {
  2523. $string = '\\\\' . $string;
  2524. }
  2525. return addcslashes( $string, 'A..Za..z' );
  2526. }
  2527. /**
  2528. * Appends a trailing slash.
  2529. *
  2530. * Will remove trailing forward and backslashes if it exists already before adding
  2531. * a trailing forward slash. This prevents double slashing a string or path.
  2532. *
  2533. * The primary use of this is for paths and thus should be used for paths. It is
  2534. * not restricted to paths and offers no specific path support.
  2535. *
  2536. * @since 1.2.0
  2537. *
  2538. * @param string $string What to add the trailing slash to.
  2539. * @return string String with trailing slash added.
  2540. */
  2541. function trailingslashit( $string ) {
  2542. return untrailingslashit( $string ) . '/';
  2543. }
  2544. /**
  2545. * Removes trailing forward slashes and backslashes if they exist.
  2546. *
  2547. * The primary use of this is for paths and thus should be used for paths. It is
  2548. * not restricted to paths and offers no specific path support.
  2549. *
  2550. * @since 2.2.0
  2551. *
  2552. * @param string $string What to remove the trailing slashes from.
  2553. * @return string String without the trailing slashes.
  2554. */
  2555. function untrailingslashit( $string ) {
  2556. return rtrim( $string, '/\\' );
  2557. }
  2558. /**
  2559. * Adds slashes to a string or recursively adds slashes to strings within an array.
  2560. *
  2561. * @since 0.71
  2562. *
  2563. * @param string|array $gpc String or array of data to slash.
  2564. * @return string|array Slashed `$gpc`.
  2565. */
  2566. function addslashes_gpc( $gpc ) {
  2567. return wp_slash( $gpc );
  2568. }
  2569. /**
  2570. * Navigates through an array, object, or scalar, and removes slashes from the values.
  2571. *
  2572. * @since 2.0.0
  2573. *
  2574. * @param mixed $value The value to be stripped.
  2575. * @return mixed Stripped value.
  2576. */
  2577. function stripslashes_deep( $value ) {
  2578. return map_deep( $value, 'stripslashes_from_strings_only' );
  2579. }
  2580. /**
  2581. * Callback function for `stripslashes_deep()` which strips slashes from strings.
  2582. *
  2583. * @since 4.4.0
  2584. *
  2585. * @param mixed $value The array or string to be stripped.
  2586. * @return mixed The stripped value.
  2587. */
  2588. function stripslashes_from_strings_only( $value ) {
  2589. return is_string( $value ) ? stripslashes( $value ) : $value;
  2590. }
  2591. /**
  2592. * Navigates through an array, object, or scalar, and encodes the values to be used in a URL.
  2593. *
  2594. * @since 2.2.0
  2595. *
  2596. * @param mixed $value The array or string to be encoded.
  2597. * @return mixed The encoded value.
  2598. */
  2599. function urlencode_deep( $value ) {
  2600. return map_deep( $value, 'urlencode' );
  2601. }
  2602. /**
  2603. * Navigates through an array, object, or scalar, and raw-encodes the values to be used in a URL.
  2604. *
  2605. * @since 3.4.0
  2606. *
  2607. * @param mixed $value The array or string to be encoded.
  2608. * @return mixed The encoded value.
  2609. */
  2610. function rawurlencode_deep( $value ) {
  2611. return map_deep( $value, 'rawurlencode' );
  2612. }
  2613. /**
  2614. * Navigates through an array, object, or scalar, and decodes URL-encoded values
  2615. *
  2616. * @since 4.4.0
  2617. *
  2618. * @param mixed $value The array or string to be decoded.
  2619. * @return mixed The decoded value.
  2620. */
  2621. function urldecode_deep( $value ) {
  2622. return map_deep( $value, 'urldecode' );
  2623. }
  2624. /**
  2625. * Converts email addresses characters to HTML entities to block spam bots.
  2626. *
  2627. * @since 0.71
  2628. *
  2629. * @param string $email_address Email address.
  2630. * @param int $hex_encoding Optional. Set to 1 to enable hex encoding.
  2631. * @return string Converted email address.
  2632. */
  2633. function antispambot( $email_address, $hex_encoding = 0 ) {
  2634. $email_no_spam_address = '';
  2635. for ( $i = 0, $len = strlen( $email_address ); $i < $len; $i++ ) {
  2636. $j = rand( 0, 1 + $hex_encoding );
  2637. if ( 0 == $j ) {
  2638. $email_no_spam_address .= '&#' . ord( $email_address[ $i ] ) . ';';
  2639. } elseif ( 1 == $j ) {
  2640. $email_no_spam_address .= $email_address[ $i ];
  2641. } elseif ( 2 == $j ) {
  2642. $email_no_spam_address .= '%' . zeroise( dechex( ord( $email_address[ $i ] ) ), 2 );
  2643. }
  2644. }
  2645. return str_replace( '@', '&#64;', $email_no_spam_address );
  2646. }
  2647. /**
  2648. * Callback to convert URI match to HTML A element.
  2649. *
  2650. * This function was backported from 2.5.0 to 2.3.2. Regex callback for make_clickable().
  2651. *
  2652. * @since 2.3.2
  2653. * @access private
  2654. *
  2655. * @param array $matches Single Regex Match.
  2656. * @return string HTML A element with URI address.
  2657. */
  2658. function _make_url_clickable_cb( $matches ) {
  2659. $url = $matches[2];
  2660. if ( ')' === $matches[3] && strpos( $url, '(' ) ) {
  2661. // If the trailing character is a closing parethesis, and the URL has an opening parenthesis in it,
  2662. // add the closing parenthesis to the URL. Then we can let the parenthesis balancer do its thing below.
  2663. $url .= $matches[3];
  2664. $suffix = '';
  2665. } else {
  2666. $suffix = $matches[3];
  2667. }
  2668. // Include parentheses in the URL only if paired.
  2669. while ( substr_count( $url, '(' ) < substr_count( $url, ')' ) ) {
  2670. $suffix = strrchr( $url, ')' ) . $suffix;
  2671. $url = substr( $url, 0, strrpos( $url, ')' ) );
  2672. }
  2673. $url = esc_url( $url );
  2674. if ( empty( $url ) ) {
  2675. return $matches[0];
  2676. }
  2677. if ( 'comment_text' === current_filter() ) {
  2678. $rel = 'nofollow ugc';
  2679. } else {
  2680. $rel = 'nofollow';
  2681. }
  2682. /**
  2683. * Filters the rel value that is added to URL matches converted to links.
  2684. *
  2685. * @since 5.3.0
  2686. *
  2687. * @param string $rel The rel value.
  2688. * @param string $url The matched URL being converted to a link tag.
  2689. */
  2690. $rel = apply_filters( 'make_clickable_rel', $rel, $url );
  2691. $rel = esc_attr( $rel );
  2692. return $matches[1] . "<a href=\"$url\" rel=\"$rel\">$url</a>" . $suffix;
  2693. }
  2694. /**
  2695. * Callback to convert URL match to HTML A element.
  2696. *
  2697. * This function was backported from 2.5.0 to 2.3.2. Regex callback for make_clickable().
  2698. *
  2699. * @since 2.3.2
  2700. * @access private
  2701. *
  2702. * @param array $matches Single Regex Match.
  2703. * @return string HTML A element with URL address.
  2704. */
  2705. function _make_web_ftp_clickable_cb( $matches ) {
  2706. $ret = '';
  2707. $dest = $matches[2];
  2708. $dest = 'http://' . $dest;
  2709. // Removed trailing [.,;:)] from URL.
  2710. $last_char = substr( $dest, -1 );
  2711. if ( in_array( $last_char, array( '.', ',', ';', ':', ')' ), true ) === true ) {
  2712. $ret = $last_char;
  2713. $dest = substr( $dest, 0, strlen( $dest ) - 1 );
  2714. }
  2715. $dest = esc_url( $dest );
  2716. if ( empty( $dest ) ) {
  2717. return $matches[0];
  2718. }
  2719. if ( 'comment_text' === current_filter() ) {
  2720. $rel = 'nofollow ugc';
  2721. } else {
  2722. $rel = 'nofollow';
  2723. }
  2724. /** This filter is documented in wp-includes/formatting.php */
  2725. $rel = apply_filters( 'make_clickable_rel', $rel, $dest );
  2726. $rel = esc_attr( $rel );
  2727. return $matches[1] . "<a href=\"$dest\" rel=\"$rel\">$dest</a>$ret";
  2728. }
  2729. /**
  2730. * Callback to convert email address match to HTML A element.
  2731. *
  2732. * This function was backported from 2.5.0 to 2.3.2. Regex callback for make_clickable().
  2733. *
  2734. * @since 2.3.2
  2735. * @access private
  2736. *
  2737. * @param array $matches Single Regex Match.
  2738. * @return string HTML A element with email address.
  2739. */
  2740. function _make_email_clickable_cb( $matches ) {
  2741. $email = $matches[2] . '@' . $matches[3];
  2742. return $matches[1] . "<a href=\"mailto:$email\">$email</a>";
  2743. }
  2744. /**
  2745. * Converts plaintext URI to HTML links.
  2746. *
  2747. * Converts URI, www and ftp, and email addresses. Finishes by fixing links
  2748. * within links.
  2749. *
  2750. * @since 0.71
  2751. *
  2752. * @param string $text Content to convert URIs.
  2753. * @return string Content with converted URIs.
  2754. */
  2755. function make_clickable( $text ) {
  2756. $r = '';
  2757. $textarr = preg_split( '/(<[^<>]+>)/', $text, -1, PREG_SPLIT_DELIM_CAPTURE ); // Split out HTML tags.
  2758. $nested_code_pre = 0; // Keep track of how many levels link is nested inside <pre> or <code>.
  2759. foreach ( $textarr as $piece ) {
  2760. 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 ) ) {
  2761. $nested_code_pre++;
  2762. } elseif ( $nested_code_pre && ( '</code>' === strtolower( $piece ) || '</pre>' === strtolower( $piece ) || '</script>' === strtolower( $piece ) || '</style>' === strtolower( $piece ) ) ) {
  2763. $nested_code_pre--;
  2764. }
  2765. if ( $nested_code_pre || empty( $piece ) || ( '<' === $piece[0] && ! preg_match( '|^<\s*[\w]{1,20}+://|', $piece ) ) ) {
  2766. $r .= $piece;
  2767. continue;
  2768. }
  2769. // Long strings might contain expensive edge cases...
  2770. if ( 10000 < strlen( $piece ) ) {
  2771. // ...break it up.
  2772. foreach ( _split_str_by_whitespace( $piece, 2100 ) as $chunk ) { // 2100: Extra room for scheme and leading and trailing paretheses.
  2773. if ( 2101 < strlen( $chunk ) ) {
  2774. $r .= $chunk; // Too big, no whitespace: bail.
  2775. } else {
  2776. $r .= make_clickable( $chunk );
  2777. }
  2778. }
  2779. } else {
  2780. $ret = " $piece "; // Pad with whitespace to simplify the regexes.
  2781. $url_clickable = '~
  2782. ([\\s(<.,;:!?]) # 1: Leading whitespace, or punctuation.
  2783. ( # 2: URL.
  2784. [\\w]{1,20}+:// # Scheme and hier-part prefix.
  2785. (?=\S{1,2000}\s) # Limit to URLs less than about 2000 characters long.
  2786. [\\w\\x80-\\xff#%\\~/@\\[\\]*(+=&$-]*+ # Non-punctuation URL character.
  2787. (?: # Unroll the Loop: Only allow puctuation URL character if followed by a non-punctuation URL character.
  2788. [\'.,;:!?)] # Punctuation URL character.
  2789. [\\w\\x80-\\xff#%\\~/@\\[\\]*(+=&$-]++ # Non-punctuation URL character.
  2790. )*
  2791. )
  2792. (\)?) # 3: Trailing closing parenthesis (for parethesis balancing post processing).
  2793. ~xS';
  2794. // The regex is a non-anchored pattern and does not have a single fixed starting character.
  2795. // Tell PCRE to spend more time optimizing since, when used on a page load, it will probably be used several times.
  2796. $ret = preg_replace_callback( $url_clickable, '_make_url_clickable_cb', $ret );
  2797. $ret = preg_replace_callback( '#([\s>])((www|ftp)\.[\w\\x80-\\xff\#$%&~/.\-;:=,?@\[\]+]+)#is', '_make_web_ftp_clickable_cb', $ret );
  2798. $ret = preg_replace_callback( '#([\s>])([.0-9a-z_+-]+)@(([0-9a-z-]+\.)+[0-9a-z]{2,})#i', '_make_email_clickable_cb', $ret );
  2799. $ret = substr( $ret, 1, -1 ); // Remove our whitespace padding.
  2800. $r .= $ret;
  2801. }
  2802. }
  2803. // Cleanup of accidental links within links.
  2804. return preg_replace( '#(<a([ \r\n\t]+[^>]+?>|>))<a [^>]+?>([^>]+?)</a></a>#i', '$1$3</a>', $r );
  2805. }
  2806. /**
  2807. * Breaks a string into chunks by splitting at whitespace characters.
  2808. *
  2809. * The length of each returned chunk is as close to the specified length goal as possible,
  2810. * with the caveat that each chunk includes its trailing delimiter.
  2811. * Chunks longer than the goal are guaranteed to not have any inner whitespace.
  2812. *
  2813. * Joining the returned chunks with empty delimiters reconstructs the input string losslessly.
  2814. *
  2815. * Input string must have no null characters (or eventual transformations on output chunks must not care about null characters)
  2816. *
  2817. * _split_str_by_whitespace( "1234 67890 1234 67890a cd 1234 890 123456789 1234567890a 45678 1 3 5 7 90 ", 10 ) ==
  2818. * array (
  2819. * 0 => '1234 67890 ', // 11 characters: Perfect split.
  2820. * 1 => '1234 ', // 5 characters: '1234 67890a' was too long.
  2821. * 2 => '67890a cd ', // 10 characters: '67890a cd 1234' was too long.
  2822. * 3 => '1234 890 ', // 11 characters: Perfect split.
  2823. * 4 => '123456789 ', // 10 characters: '123456789 1234567890a' was too long.
  2824. * 5 => '1234567890a ', // 12 characters: Too long, but no inner whitespace on which to split.
  2825. * 6 => ' 45678 ', // 11 characters: Perfect split.
  2826. * 7 => '1 3 5 7 90 ', // 11 characters: End of $string.
  2827. * );
  2828. *
  2829. * @since 3.4.0
  2830. * @access private
  2831. *
  2832. * @param string $string The string to split.
  2833. * @param int $goal The desired chunk length.
  2834. * @return array Numeric array of chunks.
  2835. */
  2836. function _split_str_by_whitespace( $string, $goal ) {
  2837. $chunks = array();
  2838. $string_nullspace = strtr( $string, "\r\n\t\v\f ", "\000\000\000\000\000\000" );
  2839. while ( $goal < strlen( $string_nullspace ) ) {
  2840. $pos = strrpos( substr( $string_nullspace, 0, $goal + 1 ), "\000" );
  2841. if ( false === $pos ) {
  2842. $pos = strpos( $string_nullspace, "\000", $goal + 1 );
  2843. if ( false === $pos ) {
  2844. break;
  2845. }
  2846. }
  2847. $chunks[] = substr( $string, 0, $pos + 1 );
  2848. $string = substr( $string, $pos + 1 );
  2849. $string_nullspace = substr( $string_nullspace, $pos + 1 );
  2850. }
  2851. if ( $string ) {
  2852. $chunks[] = $string;
  2853. }
  2854. return $chunks;
  2855. }
  2856. /**
  2857. * Callback to add a rel attribute to HTML A element.
  2858. *
  2859. * Will remove already existing string before adding to prevent invalidating (X)HTML.
  2860. *
  2861. * @since 5.3.0
  2862. *
  2863. * @param array $matches Single match.
  2864. * @param string $rel The rel attribute to add.
  2865. * @return string HTML A element with the added rel attribute.
  2866. */
  2867. function wp_rel_callback( $matches, $rel ) {
  2868. $text = $matches[1];
  2869. $atts = wp_kses_hair( $matches[1], wp_allowed_protocols() );
  2870. if ( ! empty( $atts['href'] ) ) {
  2871. if ( in_array( strtolower( wp_parse_url( $atts['href']['value'], PHP_URL_SCHEME ) ), array( 'http', 'https' ), true ) ) {
  2872. if ( strtolower( wp_parse_url( $atts['href']['value'], PHP_URL_HOST ) ) === strtolower( wp_parse_url( home_url(), PHP_URL_HOST ) ) ) {
  2873. return "<a $text>";
  2874. }
  2875. }
  2876. }
  2877. if ( ! empty( $atts['rel'] ) ) {
  2878. $parts = array_map( 'trim', explode( ' ', $atts['rel']['value'] ) );
  2879. $rel_array = array_map( 'trim', explode( ' ', $rel ) );
  2880. $parts = array_unique( array_merge( $parts, $rel_array ) );
  2881. $rel = implode( ' ', $parts );
  2882. unset( $atts['rel'] );
  2883. $html = '';
  2884. foreach ( $atts as $name => $value ) {
  2885. if ( isset( $value['vless'] ) && 'y' === $value['vless'] ) {
  2886. $html .= $name . ' ';
  2887. } else {
  2888. $html .= "{$name}=\"" . esc_attr( $value['value'] ) . '" ';
  2889. }
  2890. }
  2891. $text = trim( $html );
  2892. }
  2893. return "<a $text rel=\"" . esc_attr( $rel ) . '">';
  2894. }
  2895. /**
  2896. * Adds `rel="nofollow"` string to all HTML A elements in content.
  2897. *
  2898. * @since 1.5.0
  2899. *
  2900. * @param string $text Content that may contain HTML A elements.
  2901. * @return string Converted content.
  2902. */
  2903. function wp_rel_nofollow( $text ) {
  2904. // This is a pre-save filter, so text is already escaped.
  2905. $text = stripslashes( $text );
  2906. $text = preg_replace_callback(
  2907. '|<a (.+?)>|i',
  2908. static function( $matches ) {
  2909. return wp_rel_callback( $matches, 'nofollow' );
  2910. },
  2911. $text
  2912. );
  2913. return wp_slash( $text );
  2914. }
  2915. /**
  2916. * Callback to add `rel="nofollow"` string to HTML A element.
  2917. *
  2918. * @since 2.3.0
  2919. * @deprecated 5.3.0 Use wp_rel_callback()
  2920. *
  2921. * @param array $matches Single match.
  2922. * @return string HTML A Element with `rel="nofollow"`.
  2923. */
  2924. function wp_rel_nofollow_callback( $matches ) {
  2925. return wp_rel_callback( $matches, 'nofollow' );
  2926. }
  2927. /**
  2928. * Adds `rel="nofollow ugc"` string to all HTML A elements in content.
  2929. *
  2930. * @since 5.3.0
  2931. *
  2932. * @param string $text Content that may contain HTML A elements.
  2933. * @return string Converted content.
  2934. */
  2935. function wp_rel_ugc( $text ) {
  2936. // This is a pre-save filter, so text is already escaped.
  2937. $text = stripslashes( $text );
  2938. $text = preg_replace_callback(
  2939. '|<a (.+?)>|i',
  2940. static function( $matches ) {
  2941. return wp_rel_callback( $matches, 'nofollow ugc' );
  2942. },
  2943. $text
  2944. );
  2945. return wp_slash( $text );
  2946. }
  2947. /**
  2948. * Adds `rel="noopener"` to all HTML A elements that have a target.
  2949. *
  2950. * @since 5.1.0
  2951. * @since 5.6.0 Removed 'noreferrer' relationship.
  2952. *
  2953. * @param string $text Content that may contain HTML A elements.
  2954. * @return string Converted content.
  2955. */
  2956. function wp_targeted_link_rel( $text ) {
  2957. // Don't run (more expensive) regex if no links with targets.
  2958. if ( stripos( $text, 'target' ) === false || stripos( $text, '<a ' ) === false || is_serialized( $text ) ) {
  2959. return $text;
  2960. }
  2961. $script_and_style_regex = '/<(script|style).*?<\/\\1>/si';
  2962. preg_match_all( $script_and_style_regex, $text, $matches );
  2963. $extra_parts = $matches[0];
  2964. $html_parts = preg_split( $script_and_style_regex, $text );
  2965. foreach ( $html_parts as &$part ) {
  2966. $part = preg_replace_callback( '|<a\s([^>]*target\s*=[^>]*)>|i', 'wp_targeted_link_rel_callback', $part );
  2967. }
  2968. $text = '';
  2969. for ( $i = 0; $i < count( $html_parts ); $i++ ) {
  2970. $text .= $html_parts[ $i ];
  2971. if ( isset( $extra_parts[ $i ] ) ) {
  2972. $text .= $extra_parts[ $i ];
  2973. }
  2974. }
  2975. return $text;
  2976. }
  2977. /**
  2978. * Callback to add `rel="noopener"` string to HTML A element.
  2979. *
  2980. * Will not duplicate an existing 'noopener' value to avoid invalidating the HTML.
  2981. *
  2982. * @since 5.1.0
  2983. * @since 5.6.0 Removed 'noreferrer' relationship.
  2984. *
  2985. * @param array $matches Single match.
  2986. * @return string HTML A Element with `rel="noopener"` in addition to any existing values.
  2987. */
  2988. function wp_targeted_link_rel_callback( $matches ) {
  2989. $link_html = $matches[1];
  2990. $original_link_html = $link_html;
  2991. // Consider the HTML escaped if there are no unescaped quotes.
  2992. $is_escaped = ! preg_match( '/(^|[^\\\\])[\'"]/', $link_html );
  2993. if ( $is_escaped ) {
  2994. // Replace only the quotes so that they are parsable by wp_kses_hair(), leave the rest as is.
  2995. $link_html = preg_replace( '/\\\\([\'"])/', '$1', $link_html );
  2996. }
  2997. $atts = wp_kses_hair( $link_html, wp_allowed_protocols() );
  2998. /**
  2999. * Filters the rel values that are added to links with `target` attribute.
  3000. *
  3001. * @since 5.1.0
  3002. *
  3003. * @param string $rel The rel values.
  3004. * @param string $link_html The matched content of the link tag including all HTML attributes.
  3005. */
  3006. $rel = apply_filters( 'wp_targeted_link_rel', 'noopener', $link_html );
  3007. // Return early if no rel values to be added or if no actual target attribute.
  3008. if ( ! $rel || ! isset( $atts['target'] ) ) {
  3009. return "<a $original_link_html>";
  3010. }
  3011. if ( isset( $atts['rel'] ) ) {
  3012. $all_parts = preg_split( '/\s/', "{$atts['rel']['value']} $rel", -1, PREG_SPLIT_NO_EMPTY );
  3013. $rel = implode( ' ', array_unique( $all_parts ) );
  3014. }
  3015. $atts['rel']['whole'] = 'rel="' . esc_attr( $rel ) . '"';
  3016. $link_html = implode( ' ', array_column( $atts, 'whole' ) );
  3017. if ( $is_escaped ) {
  3018. $link_html = preg_replace( '/[\'"]/', '\\\\$0', $link_html );
  3019. }
  3020. return "<a $link_html>";
  3021. }
  3022. /**
  3023. * Adds all filters modifying the rel attribute of targeted links.
  3024. *
  3025. * @since 5.1.0
  3026. */
  3027. function wp_init_targeted_link_rel_filters() {
  3028. $filters = array(
  3029. 'title_save_pre',
  3030. 'content_save_pre',
  3031. 'excerpt_save_pre',
  3032. 'content_filtered_save_pre',
  3033. 'pre_comment_content',
  3034. 'pre_term_description',
  3035. 'pre_link_description',
  3036. 'pre_link_notes',
  3037. 'pre_user_description',
  3038. );
  3039. foreach ( $filters as $filter ) {
  3040. add_filter( $filter, 'wp_targeted_link_rel' );
  3041. }
  3042. }
  3043. /**
  3044. * Removes all filters modifying the rel attribute of targeted links.
  3045. *
  3046. * @since 5.1.0
  3047. */
  3048. function wp_remove_targeted_link_rel_filters() {
  3049. $filters = array(
  3050. 'title_save_pre',
  3051. 'content_save_pre',
  3052. 'excerpt_save_pre',
  3053. 'content_filtered_save_pre',
  3054. 'pre_comment_content',
  3055. 'pre_term_description',
  3056. 'pre_link_description',
  3057. 'pre_link_notes',
  3058. 'pre_user_description',
  3059. );
  3060. foreach ( $filters as $filter ) {
  3061. remove_filter( $filter, 'wp_targeted_link_rel' );
  3062. }
  3063. }
  3064. /**
  3065. * Converts one smiley code to the icon graphic file equivalent.
  3066. *
  3067. * Callback handler for convert_smilies().
  3068. *
  3069. * Looks up one smiley code in the $wpsmiliestrans global array and returns an
  3070. * `<img>` string for that smiley.
  3071. *
  3072. * @since 2.8.0
  3073. *
  3074. * @global array $wpsmiliestrans
  3075. *
  3076. * @param array $matches Single match. Smiley code to convert to image.
  3077. * @return string Image string for smiley.
  3078. */
  3079. function translate_smiley( $matches ) {
  3080. global $wpsmiliestrans;
  3081. if ( count( $matches ) == 0 ) {
  3082. return '';
  3083. }
  3084. $smiley = trim( reset( $matches ) );
  3085. $img = $wpsmiliestrans[ $smiley ];
  3086. $matches = array();
  3087. $ext = preg_match( '/\.([^.]+)$/', $img, $matches ) ? strtolower( $matches[1] ) : false;
  3088. $image_exts = array( 'jpg', 'jpeg', 'jpe', 'gif', 'png', 'webp' );
  3089. // Don't convert smilies that aren't images - they're probably emoji.
  3090. if ( ! in_array( $ext, $image_exts, true ) ) {
  3091. return $img;
  3092. }
  3093. /**
  3094. * Filters the Smiley image URL before it's used in the image element.
  3095. *
  3096. * @since 2.9.0
  3097. *
  3098. * @param string $smiley_url URL for the smiley image.
  3099. * @param string $img Filename for the smiley image.
  3100. * @param string $site_url Site URL, as returned by site_url().
  3101. */
  3102. $src_url = apply_filters( 'smilies_src', includes_url( "images/smilies/$img" ), $img, site_url() );
  3103. return sprintf( '<img src="%s" alt="%s" class="wp-smiley" style="height: 1em; max-height: 1em;" />', esc_url( $src_url ), esc_attr( $smiley ) );
  3104. }
  3105. /**
  3106. * Converts text equivalent of smilies to images.
  3107. *
  3108. * Will only convert smilies if the option 'use_smilies' is true and the global
  3109. * used in the function isn't empty.
  3110. *
  3111. * @since 0.71
  3112. *
  3113. * @global string|array $wp_smiliessearch
  3114. *
  3115. * @param string $text Content to convert smilies from text.
  3116. * @return string Converted content with text smilies replaced with images.
  3117. */
  3118. function convert_smilies( $text ) {
  3119. global $wp_smiliessearch;
  3120. $output = '';
  3121. if ( get_option( 'use_smilies' ) && ! empty( $wp_smiliessearch ) ) {
  3122. // HTML loop taken from texturize function, could possible be consolidated.
  3123. $textarr = preg_split( '/(<.*>)/U', $text, -1, PREG_SPLIT_DELIM_CAPTURE ); // Capture the tags as well as in between.
  3124. $stop = count( $textarr ); // Loop stuff.
  3125. // Ignore proessing of specific tags.
  3126. $tags_to_ignore = 'code|pre|style|script|textarea';
  3127. $ignore_block_element = '';
  3128. for ( $i = 0; $i < $stop; $i++ ) {
  3129. $content = $textarr[ $i ];
  3130. // If we're in an ignore block, wait until we find its closing tag.
  3131. if ( '' === $ignore_block_element && preg_match( '/^<(' . $tags_to_ignore . ')[^>]*>/', $content, $matches ) ) {
  3132. $ignore_block_element = $matches[1];
  3133. }
  3134. // If it's not a tag and not in ignore block.
  3135. if ( '' === $ignore_block_element && strlen( $content ) > 0 && '<' !== $content[0] ) {
  3136. $content = preg_replace_callback( $wp_smiliessearch, 'translate_smiley', $content );
  3137. }
  3138. // Did we exit ignore block?
  3139. if ( '' !== $ignore_block_element && '</' . $ignore_block_element . '>' === $content ) {
  3140. $ignore_block_element = '';
  3141. }
  3142. $output .= $content;
  3143. }
  3144. } else {
  3145. // Return default text.
  3146. $output = $text;
  3147. }
  3148. return $output;
  3149. }
  3150. /**
  3151. * Verifies that an email is valid.
  3152. *
  3153. * Does not grok i18n domains. Not RFC compliant.
  3154. *
  3155. * @since 0.71
  3156. *
  3157. * @param string $email Email address to verify.
  3158. * @param bool $deprecated Deprecated.
  3159. * @return string|false Valid email address on success, false on failure.
  3160. */
  3161. function is_email( $email, $deprecated = false ) {
  3162. if ( ! empty( $deprecated ) ) {
  3163. _deprecated_argument( __FUNCTION__, '3.0.0' );
  3164. }
  3165. // Test for the minimum length the email can be.
  3166. if ( strlen( $email ) < 6 ) {
  3167. /**
  3168. * Filters whether an email address is valid.
  3169. *
  3170. * This filter is evaluated under several different contexts, such as 'email_too_short',
  3171. * 'email_no_at', 'local_invalid_chars', 'domain_period_sequence', 'domain_period_limits',
  3172. * 'domain_no_periods', 'sub_hyphen_limits', 'sub_invalid_chars', or no specific context.
  3173. *
  3174. * @since 2.8.0
  3175. *
  3176. * @param string|false $is_email The email address if successfully passed the is_email() checks, false otherwise.
  3177. * @param string $email The email address being checked.
  3178. * @param string $context Context under which the email was tested.
  3179. */
  3180. return apply_filters( 'is_email', false, $email, 'email_too_short' );
  3181. }
  3182. // Test for an @ character after the first position.
  3183. if ( strpos( $email, '@', 1 ) === false ) {
  3184. /** This filter is documented in wp-includes/formatting.php */
  3185. return apply_filters( 'is_email', false, $email, 'email_no_at' );
  3186. }
  3187. // Split out the local and domain parts.
  3188. list( $local, $domain ) = explode( '@', $email, 2 );
  3189. // LOCAL PART
  3190. // Test for invalid characters.
  3191. if ( ! preg_match( '/^[a-zA-Z0-9!#$%&\'*+\/=?^_`{|}~\.-]+$/', $local ) ) {
  3192. /** This filter is documented in wp-includes/formatting.php */
  3193. return apply_filters( 'is_email', false, $email, 'local_invalid_chars' );
  3194. }
  3195. // DOMAIN PART
  3196. // Test for sequences of periods.
  3197. if ( preg_match( '/\.{2,}/', $domain ) ) {
  3198. /** This filter is documented in wp-includes/formatting.php */
  3199. return apply_filters( 'is_email', false, $email, 'domain_period_sequence' );
  3200. }
  3201. // Test for leading and trailing periods and whitespace.
  3202. if ( trim( $domain, " \t\n\r\0\x0B." ) !== $domain ) {
  3203. /** This filter is documented in wp-includes/formatting.php */
  3204. return apply_filters( 'is_email', false, $email, 'domain_period_limits' );
  3205. }
  3206. // Split the domain into subs.
  3207. $subs = explode( '.', $domain );
  3208. // Assume the domain will have at least two subs.
  3209. if ( 2 > count( $subs ) ) {
  3210. /** This filter is documented in wp-includes/formatting.php */
  3211. return apply_filters( 'is_email', false, $email, 'domain_no_periods' );
  3212. }
  3213. // Loop through each sub.
  3214. foreach ( $subs as $sub ) {
  3215. // Test for leading and trailing hyphens and whitespace.
  3216. if ( trim( $sub, " \t\n\r\0\x0B-" ) !== $sub ) {
  3217. /** This filter is documented in wp-includes/formatting.php */
  3218. return apply_filters( 'is_email', false, $email, 'sub_hyphen_limits' );
  3219. }
  3220. // Test for invalid characters.
  3221. if ( ! preg_match( '/^[a-z0-9-]+$/i', $sub ) ) {
  3222. /** This filter is documented in wp-includes/formatting.php */
  3223. return apply_filters( 'is_email', false, $email, 'sub_invalid_chars' );
  3224. }
  3225. }
  3226. // Congratulations, your email made it!
  3227. /** This filter is documented in wp-includes/formatting.php */
  3228. return apply_filters( 'is_email', $email, $email, null );
  3229. }
  3230. /**
  3231. * Converts to ASCII from email subjects.
  3232. *
  3233. * @since 1.2.0
  3234. *
  3235. * @param string $string Subject line.
  3236. * @return string Converted string to ASCII.
  3237. */
  3238. function wp_iso_descrambler( $string ) {
  3239. /* this may only work with iso-8859-1, I'm afraid */
  3240. if ( ! preg_match( '#\=\?(.+)\?Q\?(.+)\?\=#i', $string, $matches ) ) {
  3241. return $string;
  3242. } else {
  3243. $subject = str_replace( '_', ' ', $matches[2] );
  3244. return preg_replace_callback( '#\=([0-9a-f]{2})#i', '_wp_iso_convert', $subject );
  3245. }
  3246. }
  3247. /**
  3248. * Helper function to convert hex encoded chars to ASCII.
  3249. *
  3250. * @since 3.1.0
  3251. * @access private
  3252. *
  3253. * @param array $match The preg_replace_callback matches array.
  3254. * @return string Converted chars.
  3255. */
  3256. function _wp_iso_convert( $match ) {
  3257. return chr( hexdec( strtolower( $match[1] ) ) );
  3258. }
  3259. /**
  3260. * Given a date in the timezone of the site, returns that date in UTC.
  3261. *
  3262. * Requires and returns a date in the Y-m-d H:i:s format.
  3263. * Return format can be overridden using the $format parameter.
  3264. *
  3265. * @since 1.2.0
  3266. *
  3267. * @param string $string The date to be converted, in the timezone of the site.
  3268. * @param string $format The format string for the returned date. Default 'Y-m-d H:i:s'.
  3269. * @return string Formatted version of the date, in UTC.
  3270. */
  3271. function get_gmt_from_date( $string, $format = 'Y-m-d H:i:s' ) {
  3272. $datetime = date_create( $string, wp_timezone() );
  3273. if ( false === $datetime ) {
  3274. return gmdate( $format, 0 );
  3275. }
  3276. return $datetime->setTimezone( new DateTimeZone( 'UTC' ) )->format( $format );
  3277. }
  3278. /**
  3279. * Given a date in UTC or GMT timezone, returns that date in the timezone of the site.
  3280. *
  3281. * Requires a date in the Y-m-d H:i:s format.
  3282. * Default return format of 'Y-m-d H:i:s' can be overridden using the `$format` parameter.
  3283. *
  3284. * @since 1.2.0
  3285. *
  3286. * @param string $string The date to be converted, in UTC or GMT timezone.
  3287. * @param string $format The format string for the returned date. Default 'Y-m-d H:i:s'.
  3288. * @return string Formatted version of the date, in the site's timezone.
  3289. */
  3290. function get_date_from_gmt( $string, $format = 'Y-m-d H:i:s' ) {
  3291. $datetime = date_create( $string, new DateTimeZone( 'UTC' ) );
  3292. if ( false === $datetime ) {
  3293. return gmdate( $format, 0 );
  3294. }
  3295. return $datetime->setTimezone( wp_timezone() )->format( $format );
  3296. }
  3297. /**
  3298. * Given an ISO 8601 timezone, returns its UTC offset in seconds.
  3299. *
  3300. * @since 1.5.0
  3301. *
  3302. * @param string $timezone Either 'Z' for 0 offset or '±hhmm'.
  3303. * @return int|float The offset in seconds.
  3304. */
  3305. function iso8601_timezone_to_offset( $timezone ) {
  3306. // $timezone is either 'Z' or '[+|-]hhmm'.
  3307. if ( 'Z' === $timezone ) {
  3308. $offset = 0;
  3309. } else {
  3310. $sign = ( '+' === substr( $timezone, 0, 1 ) ) ? 1 : -1;
  3311. $hours = (int) substr( $timezone, 1, 2 );
  3312. $minutes = (int) substr( $timezone, 3, 4 ) / 60;
  3313. $offset = $sign * HOUR_IN_SECONDS * ( $hours + $minutes );
  3314. }
  3315. return $offset;
  3316. }
  3317. /**
  3318. * 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].
  3319. *
  3320. * @since 1.5.0
  3321. *
  3322. * @param string $date_string Date and time in ISO 8601 format {@link https://en.wikipedia.org/wiki/ISO_8601}.
  3323. * @param string $timezone Optional. If set to 'gmt' returns the result in UTC. Default 'user'.
  3324. * @return string|false The date and time in MySQL DateTime format - Y-m-d H:i:s, or false on failure.
  3325. */
  3326. function iso8601_to_datetime( $date_string, $timezone = 'user' ) {
  3327. $timezone = strtolower( $timezone );
  3328. $wp_timezone = wp_timezone();
  3329. $datetime = date_create( $date_string, $wp_timezone ); // Timezone is ignored if input has one.
  3330. if ( false === $datetime ) {
  3331. return false;
  3332. }
  3333. if ( 'gmt' === $timezone ) {
  3334. return $datetime->setTimezone( new DateTimeZone( 'UTC' ) )->format( 'Y-m-d H:i:s' );
  3335. }
  3336. if ( 'user' === $timezone ) {
  3337. return $datetime->setTimezone( $wp_timezone )->format( 'Y-m-d H:i:s' );
  3338. }
  3339. return false;
  3340. }
  3341. /**
  3342. * Strips out all characters that are not allowable in an email.
  3343. *
  3344. * @since 1.5.0
  3345. *
  3346. * @param string $email Email address to filter.
  3347. * @return string Filtered email address.
  3348. */
  3349. function sanitize_email( $email ) {
  3350. // Test for the minimum length the email can be.
  3351. if ( strlen( $email ) < 6 ) {
  3352. /**
  3353. * Filters a sanitized email address.
  3354. *
  3355. * This filter is evaluated under several contexts, including 'email_too_short',
  3356. * 'email_no_at', 'local_invalid_chars', 'domain_period_sequence', 'domain_period_limits',
  3357. * 'domain_no_periods', 'domain_no_valid_subs', or no context.
  3358. *
  3359. * @since 2.8.0
  3360. *
  3361. * @param string $sanitized_email The sanitized email address.
  3362. * @param string $email The email address, as provided to sanitize_email().
  3363. * @param string|null $message A message to pass to the user. null if email is sanitized.
  3364. */
  3365. return apply_filters( 'sanitize_email', '', $email, 'email_too_short' );
  3366. }
  3367. // Test for an @ character after the first position.
  3368. if ( strpos( $email, '@', 1 ) === false ) {
  3369. /** This filter is documented in wp-includes/formatting.php */
  3370. return apply_filters( 'sanitize_email', '', $email, 'email_no_at' );
  3371. }
  3372. // Split out the local and domain parts.
  3373. list( $local, $domain ) = explode( '@', $email, 2 );
  3374. // LOCAL PART
  3375. // Test for invalid characters.
  3376. $local = preg_replace( '/[^a-zA-Z0-9!#$%&\'*+\/=?^_`{|}~\.-]/', '', $local );
  3377. if ( '' === $local ) {
  3378. /** This filter is documented in wp-includes/formatting.php */
  3379. return apply_filters( 'sanitize_email', '', $email, 'local_invalid_chars' );
  3380. }
  3381. // DOMAIN PART
  3382. // Test for sequences of periods.
  3383. $domain = preg_replace( '/\.{2,}/', '', $domain );
  3384. if ( '' === $domain ) {
  3385. /** This filter is documented in wp-includes/formatting.php */
  3386. return apply_filters( 'sanitize_email', '', $email, 'domain_period_sequence' );
  3387. }
  3388. // Test for leading and trailing periods and whitespace.
  3389. $domain = trim( $domain, " \t\n\r\0\x0B." );
  3390. if ( '' === $domain ) {
  3391. /** This filter is documented in wp-includes/formatting.php */
  3392. return apply_filters( 'sanitize_email', '', $email, 'domain_period_limits' );
  3393. }
  3394. // Split the domain into subs.
  3395. $subs = explode( '.', $domain );
  3396. // Assume the domain will have at least two subs.
  3397. if ( 2 > count( $subs ) ) {
  3398. /** This filter is documented in wp-includes/formatting.php */
  3399. return apply_filters( 'sanitize_email', '', $email, 'domain_no_periods' );
  3400. }
  3401. // Create an array that will contain valid subs.
  3402. $new_subs = array();
  3403. // Loop through each sub.
  3404. foreach ( $subs as $sub ) {
  3405. // Test for leading and trailing hyphens.
  3406. $sub = trim( $sub, " \t\n\r\0\x0B-" );
  3407. // Test for invalid characters.
  3408. $sub = preg_replace( '/[^a-z0-9-]+/i', '', $sub );
  3409. // If there's anything left, add it to the valid subs.
  3410. if ( '' !== $sub ) {
  3411. $new_subs[] = $sub;
  3412. }
  3413. }
  3414. // If there aren't 2 or more valid subs.
  3415. if ( 2 > count( $new_subs ) ) {
  3416. /** This filter is documented in wp-includes/formatting.php */
  3417. return apply_filters( 'sanitize_email', '', $email, 'domain_no_valid_subs' );
  3418. }
  3419. // Join valid subs into the new domain.
  3420. $domain = implode( '.', $new_subs );
  3421. // Put the email back together.
  3422. $sanitized_email = $local . '@' . $domain;
  3423. // Congratulations, your email made it!
  3424. /** This filter is documented in wp-includes/formatting.php */
  3425. return apply_filters( 'sanitize_email', $sanitized_email, $email, null );
  3426. }
  3427. /**
  3428. * Determines the difference between two timestamps.
  3429. *
  3430. * The difference is returned in a human readable format such as "1 hour",
  3431. * "5 mins", "2 days".
  3432. *
  3433. * @since 1.5.0
  3434. * @since 5.3.0 Added support for showing a difference in seconds.
  3435. *
  3436. * @param int $from Unix timestamp from which the difference begins.
  3437. * @param int $to Optional. Unix timestamp to end the time difference. Default becomes time() if not set.
  3438. * @return string Human readable time difference.
  3439. */
  3440. function human_time_diff( $from, $to = 0 ) {
  3441. if ( empty( $to ) ) {
  3442. $to = time();
  3443. }
  3444. $diff = (int) abs( $to - $from );
  3445. if ( $diff < MINUTE_IN_SECONDS ) {
  3446. $secs = $diff;
  3447. if ( $secs <= 1 ) {
  3448. $secs = 1;
  3449. }
  3450. /* translators: Time difference between two dates, in seconds. %s: Number of seconds. */
  3451. $since = sprintf( _n( '%s second', '%s seconds', $secs ), $secs );
  3452. } elseif ( $diff < HOUR_IN_SECONDS && $diff >= MINUTE_IN_SECONDS ) {
  3453. $mins = round( $diff / MINUTE_IN_SECONDS );
  3454. if ( $mins <= 1 ) {
  3455. $mins = 1;
  3456. }
  3457. /* translators: Time difference between two dates, in minutes (min=minute). %s: Number of minutes. */
  3458. $since = sprintf( _n( '%s min', '%s mins', $mins ), $mins );
  3459. } elseif ( $diff < DAY_IN_SECONDS && $diff >= HOUR_IN_SECONDS ) {
  3460. $hours = round( $diff / HOUR_IN_SECONDS );
  3461. if ( $hours <= 1 ) {
  3462. $hours = 1;
  3463. }
  3464. /* translators: Time difference between two dates, in hours. %s: Number of hours. */
  3465. $since = sprintf( _n( '%s hour', '%s hours', $hours ), $hours );
  3466. } elseif ( $diff < WEEK_IN_SECONDS && $diff >= DAY_IN_SECONDS ) {
  3467. $days = round( $diff / DAY_IN_SECONDS );
  3468. if ( $days <= 1 ) {
  3469. $days = 1;
  3470. }
  3471. /* translators: Time difference between two dates, in days. %s: Number of days. */
  3472. $since = sprintf( _n( '%s day', '%s days', $days ), $days );
  3473. } elseif ( $diff < MONTH_IN_SECONDS && $diff >= WEEK_IN_SECONDS ) {
  3474. $weeks = round( $diff / WEEK_IN_SECONDS );
  3475. if ( $weeks <= 1 ) {
  3476. $weeks = 1;
  3477. }
  3478. /* translators: Time difference between two dates, in weeks. %s: Number of weeks. */
  3479. $since = sprintf( _n( '%s week', '%s weeks', $weeks ), $weeks );
  3480. } elseif ( $diff < YEAR_IN_SECONDS && $diff >= MONTH_IN_SECONDS ) {
  3481. $months = round( $diff / MONTH_IN_SECONDS );
  3482. if ( $months <= 1 ) {
  3483. $months = 1;
  3484. }
  3485. /* translators: Time difference between two dates, in months. %s: Number of months. */
  3486. $since = sprintf( _n( '%s month', '%s months', $months ), $months );
  3487. } elseif ( $diff >= YEAR_IN_SECONDS ) {
  3488. $years = round( $diff / YEAR_IN_SECONDS );
  3489. if ( $years <= 1 ) {
  3490. $years = 1;
  3491. }
  3492. /* translators: Time difference between two dates, in years. %s: Number of years. */
  3493. $since = sprintf( _n( '%s year', '%s years', $years ), $years );
  3494. }
  3495. /**
  3496. * Filters the human readable difference between two timestamps.
  3497. *
  3498. * @since 4.0.0
  3499. *
  3500. * @param string $since The difference in human readable text.
  3501. * @param int $diff The difference in seconds.
  3502. * @param int $from Unix timestamp from which the difference begins.
  3503. * @param int $to Unix timestamp to end the time difference.
  3504. */
  3505. return apply_filters( 'human_time_diff', $since, $diff, $from, $to );
  3506. }
  3507. /**
  3508. * Generates an excerpt from the content, if needed.
  3509. *
  3510. * Returns a maximum of 55 words with an ellipsis appended if necessary.
  3511. *
  3512. * The 55 word limit can be modified by plugins/themes using the {@see 'excerpt_length'} filter
  3513. * The ' [&hellip;]' string can be modified by plugins/themes using the {@see 'excerpt_more'} filter
  3514. *
  3515. * @since 1.5.0
  3516. * @since 5.2.0 Added the `$post` parameter.
  3517. *
  3518. * @param string $text Optional. The excerpt. If set to empty, an excerpt is generated.
  3519. * @param WP_Post|object|int $post Optional. WP_Post instance or Post ID/object. Default null.
  3520. * @return string The excerpt.
  3521. */
  3522. function wp_trim_excerpt( $text = '', $post = null ) {
  3523. $raw_excerpt = $text;
  3524. if ( '' === trim( $text ) ) {
  3525. $post = get_post( $post );
  3526. $text = get_the_content( '', false, $post );
  3527. $text = strip_shortcodes( $text );
  3528. $text = excerpt_remove_blocks( $text );
  3529. /** This filter is documented in wp-includes/post-template.php */
  3530. $text = apply_filters( 'the_content', $text );
  3531. $text = str_replace( ']]>', ']]&gt;', $text );
  3532. /* translators: Maximum number of words used in a post excerpt. */
  3533. $excerpt_length = (int) _x( '55', 'excerpt_length' );
  3534. /**
  3535. * Filters the maximum number of words in a post excerpt.
  3536. *
  3537. * @since 2.7.0
  3538. *
  3539. * @param int $number The maximum number of words. Default 55.
  3540. */
  3541. $excerpt_length = (int) apply_filters( 'excerpt_length', $excerpt_length );
  3542. /**
  3543. * Filters the string in the "more" link displayed after a trimmed excerpt.
  3544. *
  3545. * @since 2.9.0
  3546. *
  3547. * @param string $more_string The string shown within the more link.
  3548. */
  3549. $excerpt_more = apply_filters( 'excerpt_more', ' ' . '[&hellip;]' );
  3550. $text = wp_trim_words( $text, $excerpt_length, $excerpt_more );
  3551. }
  3552. /**
  3553. * Filters the trimmed excerpt string.
  3554. *
  3555. * @since 2.8.0
  3556. *
  3557. * @param string $text The trimmed text.
  3558. * @param string $raw_excerpt The text prior to trimming.
  3559. */
  3560. return apply_filters( 'wp_trim_excerpt', $text, $raw_excerpt );
  3561. }
  3562. /**
  3563. * Trims text to a certain number of words.
  3564. *
  3565. * This function is localized. For languages that count 'words' by the individual
  3566. * character (such as East Asian languages), the $num_words argument will apply
  3567. * to the number of individual characters.
  3568. *
  3569. * @since 3.3.0
  3570. *
  3571. * @param string $text Text to trim.
  3572. * @param int $num_words Number of words. Default 55.
  3573. * @param string $more Optional. What to append if $text needs to be trimmed. Default '&hellip;'.
  3574. * @return string Trimmed text.
  3575. */
  3576. function wp_trim_words( $text, $num_words = 55, $more = null ) {
  3577. if ( null === $more ) {
  3578. $more = __( '&hellip;' );
  3579. }
  3580. $original_text = $text;
  3581. $text = wp_strip_all_tags( $text );
  3582. $num_words = (int) $num_words;
  3583. /*
  3584. * translators: If your word count is based on single characters (e.g. East Asian characters),
  3585. * enter 'characters_excluding_spaces' or 'characters_including_spaces'. Otherwise, enter 'words'.
  3586. * Do not translate into your own language.
  3587. */
  3588. if ( strpos( _x( 'words', 'Word count type. Do not translate!' ), 'characters' ) === 0 && preg_match( '/^utf\-?8$/i', get_option( 'blog_charset' ) ) ) {
  3589. $text = trim( preg_replace( "/[\n\r\t ]+/", ' ', $text ), ' ' );
  3590. preg_match_all( '/./u', $text, $words_array );
  3591. $words_array = array_slice( $words_array[0], 0, $num_words + 1 );
  3592. $sep = '';
  3593. } else {
  3594. $words_array = preg_split( "/[\n\r\t ]+/", $text, $num_words + 1, PREG_SPLIT_NO_EMPTY );
  3595. $sep = ' ';
  3596. }
  3597. if ( count( $words_array ) > $num_words ) {
  3598. array_pop( $words_array );
  3599. $text = implode( $sep, $words_array );
  3600. $text = $text . $more;
  3601. } else {
  3602. $text = implode( $sep, $words_array );
  3603. }
  3604. /**
  3605. * Filters the text content after words have been trimmed.
  3606. *
  3607. * @since 3.3.0
  3608. *
  3609. * @param string $text The trimmed text.
  3610. * @param int $num_words The number of words to trim the text to. Default 55.
  3611. * @param string $more An optional string to append to the end of the trimmed text, e.g. &hellip;.
  3612. * @param string $original_text The text before it was trimmed.
  3613. */
  3614. return apply_filters( 'wp_trim_words', $text, $num_words, $more, $original_text );
  3615. }
  3616. /**
  3617. * Converts named entities into numbered entities.
  3618. *
  3619. * @since 1.5.1
  3620. *
  3621. * @param string $text The text within which entities will be converted.
  3622. * @return string Text with converted entities.
  3623. */
  3624. function ent2ncr( $text ) {
  3625. /**
  3626. * Filters text before named entities are converted into numbered entities.
  3627. *
  3628. * A non-null string must be returned for the filter to be evaluated.
  3629. *
  3630. * @since 3.3.0
  3631. *
  3632. * @param string|null $converted_text The text to be converted. Default null.
  3633. * @param string $text The text prior to entity conversion.
  3634. */
  3635. $filtered = apply_filters( 'pre_ent2ncr', null, $text );
  3636. if ( null !== $filtered ) {
  3637. return $filtered;
  3638. }
  3639. $to_ncr = array(
  3640. '&quot;' => '&#34;',
  3641. '&amp;' => '&#38;',
  3642. '&lt;' => '&#60;',
  3643. '&gt;' => '&#62;',
  3644. '|' => '&#124;',
  3645. '&nbsp;' => '&#160;',
  3646. '&iexcl;' => '&#161;',
  3647. '&cent;' => '&#162;',
  3648. '&pound;' => '&#163;',
  3649. '&curren;' => '&#164;',
  3650. '&yen;' => '&#165;',
  3651. '&brvbar;' => '&#166;',
  3652. '&brkbar;' => '&#166;',
  3653. '&sect;' => '&#167;',
  3654. '&uml;' => '&#168;',
  3655. '&die;' => '&#168;',
  3656. '&copy;' => '&#169;',
  3657. '&ordf;' => '&#170;',
  3658. '&laquo;' => '&#171;',
  3659. '&not;' => '&#172;',
  3660. '&shy;' => '&#173;',
  3661. '&reg;' => '&#174;',
  3662. '&macr;' => '&#175;',
  3663. '&hibar;' => '&#175;',
  3664. '&deg;' => '&#176;',
  3665. '&plusmn;' => '&#177;',
  3666. '&sup2;' => '&#178;',
  3667. '&sup3;' => '&#179;',
  3668. '&acute;' => '&#180;',
  3669. '&micro;' => '&#181;',
  3670. '&para;' => '&#182;',
  3671. '&middot;' => '&#183;',
  3672. '&cedil;' => '&#184;',
  3673. '&sup1;' => '&#185;',
  3674. '&ordm;' => '&#186;',
  3675. '&raquo;' => '&#187;',
  3676. '&frac14;' => '&#188;',
  3677. '&frac12;' => '&#189;',
  3678. '&frac34;' => '&#190;',
  3679. '&iquest;' => '&#191;',
  3680. '&Agrave;' => '&#192;',
  3681. '&Aacute;' => '&#193;',
  3682. '&Acirc;' => '&#194;',
  3683. '&Atilde;' => '&#195;',
  3684. '&Auml;' => '&#196;',
  3685. '&Aring;' => '&#197;',
  3686. '&AElig;' => '&#198;',
  3687. '&Ccedil;' => '&#199;',
  3688. '&Egrave;' => '&#200;',
  3689. '&Eacute;' => '&#201;',
  3690. '&Ecirc;' => '&#202;',
  3691. '&Euml;' => '&#203;',
  3692. '&Igrave;' => '&#204;',
  3693. '&Iacute;' => '&#205;',
  3694. '&Icirc;' => '&#206;',
  3695. '&Iuml;' => '&#207;',
  3696. '&ETH;' => '&#208;',
  3697. '&Ntilde;' => '&#209;',
  3698. '&Ograve;' => '&#210;',
  3699. '&Oacute;' => '&#211;',
  3700. '&Ocirc;' => '&#212;',
  3701. '&Otilde;' => '&#213;',
  3702. '&Ouml;' => '&#214;',
  3703. '&times;' => '&#215;',
  3704. '&Oslash;' => '&#216;',
  3705. '&Ugrave;' => '&#217;',
  3706. '&Uacute;' => '&#218;',
  3707. '&Ucirc;' => '&#219;',
  3708. '&Uuml;' => '&#220;',
  3709. '&Yacute;' => '&#221;',
  3710. '&THORN;' => '&#222;',
  3711. '&szlig;' => '&#223;',
  3712. '&agrave;' => '&#224;',
  3713. '&aacute;' => '&#225;',
  3714. '&acirc;' => '&#226;',
  3715. '&atilde;' => '&#227;',
  3716. '&auml;' => '&#228;',
  3717. '&aring;' => '&#229;',
  3718. '&aelig;' => '&#230;',
  3719. '&ccedil;' => '&#231;',
  3720. '&egrave;' => '&#232;',
  3721. '&eacute;' => '&#233;',
  3722. '&ecirc;' => '&#234;',
  3723. '&euml;' => '&#235;',
  3724. '&igrave;' => '&#236;',
  3725. '&iacute;' => '&#237;',
  3726. '&icirc;' => '&#238;',
  3727. '&iuml;' => '&#239;',
  3728. '&eth;' => '&#240;',
  3729. '&ntilde;' => '&#241;',
  3730. '&ograve;' => '&#242;',
  3731. '&oacute;' => '&#243;',
  3732. '&ocirc;' => '&#244;',
  3733. '&otilde;' => '&#245;',
  3734. '&ouml;' => '&#246;',
  3735. '&divide;' => '&#247;',
  3736. '&oslash;' => '&#248;',
  3737. '&ugrave;' => '&#249;',
  3738. '&uacute;' => '&#250;',
  3739. '&ucirc;' => '&#251;',
  3740. '&uuml;' => '&#252;',
  3741. '&yacute;' => '&#253;',
  3742. '&thorn;' => '&#254;',
  3743. '&yuml;' => '&#255;',
  3744. '&OElig;' => '&#338;',
  3745. '&oelig;' => '&#339;',
  3746. '&Scaron;' => '&#352;',
  3747. '&scaron;' => '&#353;',
  3748. '&Yuml;' => '&#376;',
  3749. '&fnof;' => '&#402;',
  3750. '&circ;' => '&#710;',
  3751. '&tilde;' => '&#732;',
  3752. '&Alpha;' => '&#913;',
  3753. '&Beta;' => '&#914;',
  3754. '&Gamma;' => '&#915;',
  3755. '&Delta;' => '&#916;',
  3756. '&Epsilon;' => '&#917;',
  3757. '&Zeta;' => '&#918;',
  3758. '&Eta;' => '&#919;',
  3759. '&Theta;' => '&#920;',
  3760. '&Iota;' => '&#921;',
  3761. '&Kappa;' => '&#922;',
  3762. '&Lambda;' => '&#923;',
  3763. '&Mu;' => '&#924;',
  3764. '&Nu;' => '&#925;',
  3765. '&Xi;' => '&#926;',
  3766. '&Omicron;' => '&#927;',
  3767. '&Pi;' => '&#928;',
  3768. '&Rho;' => '&#929;',
  3769. '&Sigma;' => '&#931;',
  3770. '&Tau;' => '&#932;',
  3771. '&Upsilon;' => '&#933;',
  3772. '&Phi;' => '&#934;',
  3773. '&Chi;' => '&#935;',
  3774. '&Psi;' => '&#936;',
  3775. '&Omega;' => '&#937;',
  3776. '&alpha;' => '&#945;',
  3777. '&beta;' => '&#946;',
  3778. '&gamma;' => '&#947;',
  3779. '&delta;' => '&#948;',
  3780. '&epsilon;' => '&#949;',
  3781. '&zeta;' => '&#950;',
  3782. '&eta;' => '&#951;',
  3783. '&theta;' => '&#952;',
  3784. '&iota;' => '&#953;',
  3785. '&kappa;' => '&#954;',
  3786. '&lambda;' => '&#955;',
  3787. '&mu;' => '&#956;',
  3788. '&nu;' => '&#957;',
  3789. '&xi;' => '&#958;',
  3790. '&omicron;' => '&#959;',
  3791. '&pi;' => '&#960;',
  3792. '&rho;' => '&#961;',
  3793. '&sigmaf;' => '&#962;',
  3794. '&sigma;' => '&#963;',
  3795. '&tau;' => '&#964;',
  3796. '&upsilon;' => '&#965;',
  3797. '&phi;' => '&#966;',
  3798. '&chi;' => '&#967;',
  3799. '&psi;' => '&#968;',
  3800. '&omega;' => '&#969;',
  3801. '&thetasym;' => '&#977;',
  3802. '&upsih;' => '&#978;',
  3803. '&piv;' => '&#982;',
  3804. '&ensp;' => '&#8194;',
  3805. '&emsp;' => '&#8195;',
  3806. '&thinsp;' => '&#8201;',
  3807. '&zwnj;' => '&#8204;',
  3808. '&zwj;' => '&#8205;',
  3809. '&lrm;' => '&#8206;',
  3810. '&rlm;' => '&#8207;',
  3811. '&ndash;' => '&#8211;',
  3812. '&mdash;' => '&#8212;',
  3813. '&lsquo;' => '&#8216;',
  3814. '&rsquo;' => '&#8217;',
  3815. '&sbquo;' => '&#8218;',
  3816. '&ldquo;' => '&#8220;',
  3817. '&rdquo;' => '&#8221;',
  3818. '&bdquo;' => '&#8222;',
  3819. '&dagger;' => '&#8224;',
  3820. '&Dagger;' => '&#8225;',
  3821. '&bull;' => '&#8226;',
  3822. '&hellip;' => '&#8230;',
  3823. '&permil;' => '&#8240;',
  3824. '&prime;' => '&#8242;',
  3825. '&Prime;' => '&#8243;',
  3826. '&lsaquo;' => '&#8249;',
  3827. '&rsaquo;' => '&#8250;',
  3828. '&oline;' => '&#8254;',
  3829. '&frasl;' => '&#8260;',
  3830. '&euro;' => '&#8364;',
  3831. '&image;' => '&#8465;',
  3832. '&weierp;' => '&#8472;',
  3833. '&real;' => '&#8476;',
  3834. '&trade;' => '&#8482;',
  3835. '&alefsym;' => '&#8501;',
  3836. '&crarr;' => '&#8629;',
  3837. '&lArr;' => '&#8656;',
  3838. '&uArr;' => '&#8657;',
  3839. '&rArr;' => '&#8658;',
  3840. '&dArr;' => '&#8659;',
  3841. '&hArr;' => '&#8660;',
  3842. '&forall;' => '&#8704;',
  3843. '&part;' => '&#8706;',
  3844. '&exist;' => '&#8707;',
  3845. '&empty;' => '&#8709;',
  3846. '&nabla;' => '&#8711;',
  3847. '&isin;' => '&#8712;',
  3848. '&notin;' => '&#8713;',
  3849. '&ni;' => '&#8715;',
  3850. '&prod;' => '&#8719;',
  3851. '&sum;' => '&#8721;',
  3852. '&minus;' => '&#8722;',
  3853. '&lowast;' => '&#8727;',
  3854. '&radic;' => '&#8730;',
  3855. '&prop;' => '&#8733;',
  3856. '&infin;' => '&#8734;',
  3857. '&ang;' => '&#8736;',
  3858. '&and;' => '&#8743;',
  3859. '&or;' => '&#8744;',
  3860. '&cap;' => '&#8745;',
  3861. '&cup;' => '&#8746;',
  3862. '&int;' => '&#8747;',
  3863. '&there4;' => '&#8756;',
  3864. '&sim;' => '&#8764;',
  3865. '&cong;' => '&#8773;',
  3866. '&asymp;' => '&#8776;',
  3867. '&ne;' => '&#8800;',
  3868. '&equiv;' => '&#8801;',
  3869. '&le;' => '&#8804;',
  3870. '&ge;' => '&#8805;',
  3871. '&sub;' => '&#8834;',
  3872. '&sup;' => '&#8835;',
  3873. '&nsub;' => '&#8836;',
  3874. '&sube;' => '&#8838;',
  3875. '&supe;' => '&#8839;',
  3876. '&oplus;' => '&#8853;',
  3877. '&otimes;' => '&#8855;',
  3878. '&perp;' => '&#8869;',
  3879. '&sdot;' => '&#8901;',
  3880. '&lceil;' => '&#8968;',
  3881. '&rceil;' => '&#8969;',
  3882. '&lfloor;' => '&#8970;',
  3883. '&rfloor;' => '&#8971;',
  3884. '&lang;' => '&#9001;',
  3885. '&rang;' => '&#9002;',
  3886. '&larr;' => '&#8592;',
  3887. '&uarr;' => '&#8593;',
  3888. '&rarr;' => '&#8594;',
  3889. '&darr;' => '&#8595;',
  3890. '&harr;' => '&#8596;',
  3891. '&loz;' => '&#9674;',
  3892. '&spades;' => '&#9824;',
  3893. '&clubs;' => '&#9827;',
  3894. '&hearts;' => '&#9829;',
  3895. '&diams;' => '&#9830;',
  3896. );
  3897. return str_replace( array_keys( $to_ncr ), array_values( $to_ncr ), $text );
  3898. }
  3899. /**
  3900. * Formats text for the editor.
  3901. *
  3902. * Generally the browsers treat everything inside a textarea as text, but
  3903. * it is still a good idea to HTML entity encode `<`, `>` and `&` in the content.
  3904. *
  3905. * The filter {@see 'format_for_editor'} is applied here. If `$text` is empty the
  3906. * filter will be applied to an empty string.
  3907. *
  3908. * @since 4.3.0
  3909. *
  3910. * @see _WP_Editors::editor()
  3911. *
  3912. * @param string $text The text to be formatted.
  3913. * @param string $default_editor The default editor for the current user.
  3914. * It is usually either 'html' or 'tinymce'.
  3915. * @return string The formatted text after filter is applied.
  3916. */
  3917. function format_for_editor( $text, $default_editor = null ) {
  3918. if ( $text ) {
  3919. $text = htmlspecialchars( $text, ENT_NOQUOTES, get_option( 'blog_charset' ) );
  3920. }
  3921. /**
  3922. * Filters the text after it is formatted for the editor.
  3923. *
  3924. * @since 4.3.0
  3925. *
  3926. * @param string $text The formatted text.
  3927. * @param string $default_editor The default editor for the current user.
  3928. * It is usually either 'html' or 'tinymce'.
  3929. */
  3930. return apply_filters( 'format_for_editor', $text, $default_editor );
  3931. }
  3932. /**
  3933. * Performs a deep string replace operation to ensure the values in $search are no longer present.
  3934. *
  3935. * Repeats the replacement operation until it no longer replaces anything so as to remove "nested" values
  3936. * e.g. $subject = '%0%0%0DDD', $search ='%0D', $result ='' rather than the '%0%0DD' that
  3937. * str_replace would return
  3938. *
  3939. * @since 2.8.1
  3940. * @access private
  3941. *
  3942. * @param string|array $search The value being searched for, otherwise known as the needle.
  3943. * An array may be used to designate multiple needles.
  3944. * @param string $subject The string being searched and replaced on, otherwise known as the haystack.
  3945. * @return string The string with the replaced values.
  3946. */
  3947. function _deep_replace( $search, $subject ) {
  3948. $subject = (string) $subject;
  3949. $count = 1;
  3950. while ( $count ) {
  3951. $subject = str_replace( $search, '', $subject, $count );
  3952. }
  3953. return $subject;
  3954. }
  3955. /**
  3956. * Escapes data for use in a MySQL query.
  3957. *
  3958. * Usually you should prepare queries using wpdb::prepare().
  3959. * Sometimes, spot-escaping is required or useful. One example
  3960. * is preparing an array for use in an IN clause.
  3961. *
  3962. * NOTE: Since 4.8.3, '%' characters will be replaced with a placeholder string,
  3963. * this prevents certain SQLi attacks from taking place. This change in behaviour
  3964. * may cause issues for code that expects the return value of esc_sql() to be useable
  3965. * for other purposes.
  3966. *
  3967. * @since 2.8.0
  3968. *
  3969. * @global wpdb $wpdb WordPress database abstraction object.
  3970. *
  3971. * @param string|array $data Unescaped data.
  3972. * @return string|array Escaped data, in the same type as supplied.
  3973. */
  3974. function esc_sql( $data ) {
  3975. global $wpdb;
  3976. return $wpdb->_escape( $data );
  3977. }
  3978. /**
  3979. * Checks and cleans a URL.
  3980. *
  3981. * A number of characters are removed from the URL. If the URL is for displaying
  3982. * (the default behaviour) ampersands are also replaced. The {@see 'clean_url'} filter
  3983. * is applied to the returned cleaned URL.
  3984. *
  3985. * @since 2.8.0
  3986. *
  3987. * @param string $url The URL to be cleaned.
  3988. * @param string[] $protocols Optional. An array of acceptable protocols.
  3989. * Defaults to return value of wp_allowed_protocols().
  3990. * @param string $_context Private. Use sanitize_url() for database usage.
  3991. * @return string The cleaned URL after the {@see 'clean_url'} filter is applied.
  3992. * An empty string is returned if `$url` specifies a protocol other than
  3993. * those in `$protocols`, or if `$url` contains an empty string.
  3994. */
  3995. function esc_url( $url, $protocols = null, $_context = 'display' ) {
  3996. $original_url = $url;
  3997. if ( '' === $url ) {
  3998. return $url;
  3999. }
  4000. $url = str_replace( ' ', '%20', ltrim( $url ) );
  4001. $url = preg_replace( '|[^a-z0-9-~+_.?#=!&;,/:%@$\|*\'()\[\]\\x80-\\xff]|i', '', $url );
  4002. if ( '' === $url ) {
  4003. return $url;
  4004. }
  4005. if ( 0 !== stripos( $url, 'mailto:' ) ) {
  4006. $strip = array( '%0d', '%0a', '%0D', '%0A' );
  4007. $url = _deep_replace( $strip, $url );
  4008. }
  4009. $url = str_replace( ';//', '://', $url );
  4010. /*
  4011. * If the URL doesn't appear to contain a scheme, we presume
  4012. * it needs http:// prepended (unless it's a relative link
  4013. * starting with /, # or ?, or a PHP file).
  4014. */
  4015. if ( strpos( $url, ':' ) === false && ! in_array( $url[0], array( '/', '#', '?' ), true ) &&
  4016. ! preg_match( '/^[a-z0-9-]+?\.php/i', $url ) ) {
  4017. $url = 'http://' . $url;
  4018. }
  4019. // Replace ampersands and single quotes only when displaying.
  4020. if ( 'display' === $_context ) {
  4021. $url = wp_kses_normalize_entities( $url );
  4022. $url = str_replace( '&amp;', '&#038;', $url );
  4023. $url = str_replace( "'", '&#039;', $url );
  4024. }
  4025. if ( ( false !== strpos( $url, '[' ) ) || ( false !== strpos( $url, ']' ) ) ) {
  4026. $parsed = wp_parse_url( $url );
  4027. $front = '';
  4028. if ( isset( $parsed['scheme'] ) ) {
  4029. $front .= $parsed['scheme'] . '://';
  4030. } elseif ( '/' === $url[0] ) {
  4031. $front .= '//';
  4032. }
  4033. if ( isset( $parsed['user'] ) ) {
  4034. $front .= $parsed['user'];
  4035. }
  4036. if ( isset( $parsed['pass'] ) ) {
  4037. $front .= ':' . $parsed['pass'];
  4038. }
  4039. if ( isset( $parsed['user'] ) || isset( $parsed['pass'] ) ) {
  4040. $front .= '@';
  4041. }
  4042. if ( isset( $parsed['host'] ) ) {
  4043. $front .= $parsed['host'];
  4044. }
  4045. if ( isset( $parsed['port'] ) ) {
  4046. $front .= ':' . $parsed['port'];
  4047. }
  4048. $end_dirty = str_replace( $front, '', $url );
  4049. $end_clean = str_replace( array( '[', ']' ), array( '%5B', '%5D' ), $end_dirty );
  4050. $url = str_replace( $end_dirty, $end_clean, $url );
  4051. }
  4052. if ( '/' === $url[0] ) {
  4053. $good_protocol_url = $url;
  4054. } else {
  4055. if ( ! is_array( $protocols ) ) {
  4056. $protocols = wp_allowed_protocols();
  4057. }
  4058. $good_protocol_url = wp_kses_bad_protocol( $url, $protocols );
  4059. if ( strtolower( $good_protocol_url ) != strtolower( $url ) ) {
  4060. return '';
  4061. }
  4062. }
  4063. /**
  4064. * Filters a string cleaned and escaped for output as a URL.
  4065. *
  4066. * @since 2.3.0
  4067. *
  4068. * @param string $good_protocol_url The cleaned URL to be returned.
  4069. * @param string $original_url The URL prior to cleaning.
  4070. * @param string $_context If 'display', replace ampersands and single quotes only.
  4071. */
  4072. return apply_filters( 'clean_url', $good_protocol_url, $original_url, $_context );
  4073. }
  4074. /**
  4075. * Sanitizes a URL for database or redirect usage.
  4076. *
  4077. * This function is an alias for sanitize_url().
  4078. *
  4079. * @since 2.8.0
  4080. * @since 6.1.0 Turned into an alias for sanitize_url().
  4081. *
  4082. * @see sanitize_url()
  4083. *
  4084. * @param string $url The URL to be cleaned.
  4085. * @param string[] $protocols Optional. An array of acceptable protocols.
  4086. * Defaults to return value of wp_allowed_protocols().
  4087. * @return string The cleaned URL after sanitize_url() is run.
  4088. */
  4089. function esc_url_raw( $url, $protocols = null ) {
  4090. return sanitize_url( $url, $protocols );
  4091. }
  4092. /**
  4093. * Sanitizes a URL for database or redirect usage.
  4094. *
  4095. * @since 2.3.1
  4096. * @since 2.8.0 Deprecated in favor of esc_url_raw().
  4097. * @since 5.9.0 Restored (un-deprecated).
  4098. *
  4099. * @see esc_url()
  4100. *
  4101. * @param string $url The URL to be cleaned.
  4102. * @param string[] $protocols Optional. An array of acceptable protocols.
  4103. * Defaults to return value of wp_allowed_protocols().
  4104. * @return string The cleaned URL after esc_url() is run with the 'db' context.
  4105. */
  4106. function sanitize_url( $url, $protocols = null ) {
  4107. return esc_url( $url, $protocols, 'db' );
  4108. }
  4109. /**
  4110. * Converts entities, while preserving already-encoded entities.
  4111. *
  4112. * @link https://www.php.net/htmlentities Borrowed from the PHP Manual user notes.
  4113. *
  4114. * @since 1.2.2
  4115. *
  4116. * @param string $myHTML The text to be converted.
  4117. * @return string Converted text.
  4118. */
  4119. function htmlentities2( $myHTML ) {
  4120. $translation_table = get_html_translation_table( HTML_ENTITIES, ENT_QUOTES );
  4121. $translation_table[ chr( 38 ) ] = '&';
  4122. return preg_replace( '/&(?![A-Za-z]{0,4}\w{2,3};|#[0-9]{2,3};)/', '&amp;', strtr( $myHTML, $translation_table ) );
  4123. }
  4124. /**
  4125. * Escapes single quotes, `"`, `<`, `>`, `&`, and fixes line endings.
  4126. *
  4127. * Escapes text strings for echoing in JS. It is intended to be used for inline JS
  4128. * (in a tag attribute, for example `onclick="..."`). Note that the strings have to
  4129. * be in single quotes. The {@see 'js_escape'} filter is also applied here.
  4130. *
  4131. * @since 2.8.0
  4132. *
  4133. * @param string $text The text to be escaped.
  4134. * @return string Escaped text.
  4135. */
  4136. function esc_js( $text ) {
  4137. $safe_text = wp_check_invalid_utf8( $text );
  4138. $safe_text = _wp_specialchars( $safe_text, ENT_COMPAT );
  4139. $safe_text = preg_replace( '/&#(x)?0*(?(1)27|39);?/i', "'", stripslashes( $safe_text ) );
  4140. $safe_text = str_replace( "\r", '', $safe_text );
  4141. $safe_text = str_replace( "\n", '\\n', addslashes( $safe_text ) );
  4142. /**
  4143. * Filters a string cleaned and escaped for output in JavaScript.
  4144. *
  4145. * Text passed to esc_js() is stripped of invalid or special characters,
  4146. * and properly slashed for output.
  4147. *
  4148. * @since 2.0.6
  4149. *
  4150. * @param string $safe_text The text after it has been escaped.
  4151. * @param string $text The text prior to being escaped.
  4152. */
  4153. return apply_filters( 'js_escape', $safe_text, $text );
  4154. }
  4155. /**
  4156. * Escaping for HTML blocks.
  4157. *
  4158. * @since 2.8.0
  4159. *
  4160. * @param string $text
  4161. * @return string
  4162. */
  4163. function esc_html( $text ) {
  4164. $safe_text = wp_check_invalid_utf8( $text );
  4165. $safe_text = _wp_specialchars( $safe_text, ENT_QUOTES );
  4166. /**
  4167. * Filters a string cleaned and escaped for output in HTML.
  4168. *
  4169. * Text passed to esc_html() is stripped of invalid or special characters
  4170. * before output.
  4171. *
  4172. * @since 2.8.0
  4173. *
  4174. * @param string $safe_text The text after it has been escaped.
  4175. * @param string $text The text prior to being escaped.
  4176. */
  4177. return apply_filters( 'esc_html', $safe_text, $text );
  4178. }
  4179. /**
  4180. * Escaping for HTML attributes.
  4181. *
  4182. * @since 2.8.0
  4183. *
  4184. * @param string $text
  4185. * @return string
  4186. */
  4187. function esc_attr( $text ) {
  4188. $safe_text = wp_check_invalid_utf8( $text );
  4189. $safe_text = _wp_specialchars( $safe_text, ENT_QUOTES );
  4190. /**
  4191. * Filters a string cleaned and escaped for output in an HTML attribute.
  4192. *
  4193. * Text passed to esc_attr() is stripped of invalid or special characters
  4194. * before output.
  4195. *
  4196. * @since 2.0.6
  4197. *
  4198. * @param string $safe_text The text after it has been escaped.
  4199. * @param string $text The text prior to being escaped.
  4200. */
  4201. return apply_filters( 'attribute_escape', $safe_text, $text );
  4202. }
  4203. /**
  4204. * Escaping for textarea values.
  4205. *
  4206. * @since 3.1.0
  4207. *
  4208. * @param string $text
  4209. * @return string
  4210. */
  4211. function esc_textarea( $text ) {
  4212. $safe_text = htmlspecialchars( $text, ENT_QUOTES, get_option( 'blog_charset' ) );
  4213. /**
  4214. * Filters a string cleaned and escaped for output in a textarea element.
  4215. *
  4216. * @since 3.1.0
  4217. *
  4218. * @param string $safe_text The text after it has been escaped.
  4219. * @param string $text The text prior to being escaped.
  4220. */
  4221. return apply_filters( 'esc_textarea', $safe_text, $text );
  4222. }
  4223. /**
  4224. * Escaping for XML blocks.
  4225. *
  4226. * @since 5.5.0
  4227. *
  4228. * @param string $text Text to escape.
  4229. * @return string Escaped text.
  4230. */
  4231. function esc_xml( $text ) {
  4232. $safe_text = wp_check_invalid_utf8( $text );
  4233. $cdata_regex = '\<\!\[CDATA\[.*?\]\]\>';
  4234. $regex = <<<EOF
  4235. /
  4236. (?=.*?{$cdata_regex}) # lookahead that will match anything followed by a CDATA Section
  4237. (?<non_cdata_followed_by_cdata>(.*?)) # the "anything" matched by the lookahead
  4238. (?<cdata>({$cdata_regex})) # the CDATA Section matched by the lookahead
  4239. | # alternative
  4240. (?<non_cdata>(.*)) # non-CDATA Section
  4241. /sx
  4242. EOF;
  4243. $safe_text = (string) preg_replace_callback(
  4244. $regex,
  4245. static function( $matches ) {
  4246. if ( ! isset( $matches[0] ) ) {
  4247. return '';
  4248. }
  4249. if ( isset( $matches['non_cdata'] ) ) {
  4250. // escape HTML entities in the non-CDATA Section.
  4251. return _wp_specialchars( $matches['non_cdata'], ENT_XML1 );
  4252. }
  4253. // Return the CDATA Section unchanged, escape HTML entities in the rest.
  4254. return _wp_specialchars( $matches['non_cdata_followed_by_cdata'], ENT_XML1 ) . $matches['cdata'];
  4255. },
  4256. $safe_text
  4257. );
  4258. /**
  4259. * Filters a string cleaned and escaped for output in XML.
  4260. *
  4261. * Text passed to esc_xml() is stripped of invalid or special characters
  4262. * before output. HTML named character references are converted to their
  4263. * equivalent code points.
  4264. *
  4265. * @since 5.5.0
  4266. *
  4267. * @param string $safe_text The text after it has been escaped.
  4268. * @param string $text The text prior to being escaped.
  4269. */
  4270. return apply_filters( 'esc_xml', $safe_text, $text );
  4271. }
  4272. /**
  4273. * Escapes an HTML tag name.
  4274. *
  4275. * @since 2.5.0
  4276. *
  4277. * @param string $tag_name
  4278. * @return string
  4279. */
  4280. function tag_escape( $tag_name ) {
  4281. $safe_tag = strtolower( preg_replace( '/[^a-zA-Z0-9_:]/', '', $tag_name ) );
  4282. /**
  4283. * Filters a string cleaned and escaped for output as an HTML tag.
  4284. *
  4285. * @since 2.8.0
  4286. *
  4287. * @param string $safe_tag The tag name after it has been escaped.
  4288. * @param string $tag_name The text before it was escaped.
  4289. */
  4290. return apply_filters( 'tag_escape', $safe_tag, $tag_name );
  4291. }
  4292. /**
  4293. * Converts full URL paths to absolute paths.
  4294. *
  4295. * Removes the http or https protocols and the domain. Keeps the path '/' at the
  4296. * beginning, so it isn't a true relative link, but from the web root base.
  4297. *
  4298. * @since 2.1.0
  4299. * @since 4.1.0 Support was added for relative URLs.
  4300. *
  4301. * @param string $link Full URL path.
  4302. * @return string Absolute path.
  4303. */
  4304. function wp_make_link_relative( $link ) {
  4305. return preg_replace( '|^(https?:)?//[^/]+(/?.*)|i', '$2', $link );
  4306. }
  4307. /**
  4308. * Sanitizes various option values based on the nature of the option.
  4309. *
  4310. * This is basically a switch statement which will pass $value through a number
  4311. * of functions depending on the $option.
  4312. *
  4313. * @since 2.0.5
  4314. *
  4315. * @global wpdb $wpdb WordPress database abstraction object.
  4316. *
  4317. * @param string $option The name of the option.
  4318. * @param string $value The unsanitised value.
  4319. * @return string Sanitized value.
  4320. */
  4321. function sanitize_option( $option, $value ) {
  4322. global $wpdb;
  4323. $original_value = $value;
  4324. $error = null;
  4325. switch ( $option ) {
  4326. case 'admin_email':
  4327. case 'new_admin_email':
  4328. $value = $wpdb->strip_invalid_text_for_column( $wpdb->options, 'option_value', $value );
  4329. if ( is_wp_error( $value ) ) {
  4330. $error = $value->get_error_message();
  4331. } else {
  4332. $value = sanitize_email( $value );
  4333. if ( ! is_email( $value ) ) {
  4334. $error = __( 'The email address entered did not appear to be a valid email address. Please enter a valid email address.' );
  4335. }
  4336. }
  4337. break;
  4338. case 'thumbnail_size_w':
  4339. case 'thumbnail_size_h':
  4340. case 'medium_size_w':
  4341. case 'medium_size_h':
  4342. case 'medium_large_size_w':
  4343. case 'medium_large_size_h':
  4344. case 'large_size_w':
  4345. case 'large_size_h':
  4346. case 'mailserver_port':
  4347. case 'comment_max_links':
  4348. case 'page_on_front':
  4349. case 'page_for_posts':
  4350. case 'rss_excerpt_length':
  4351. case 'default_category':
  4352. case 'default_email_category':
  4353. case 'default_link_category':
  4354. case 'close_comments_days_old':
  4355. case 'comments_per_page':
  4356. case 'thread_comments_depth':
  4357. case 'users_can_register':
  4358. case 'start_of_week':
  4359. case 'site_icon':
  4360. case 'fileupload_maxk':
  4361. $value = absint( $value );
  4362. break;
  4363. case 'posts_per_page':
  4364. case 'posts_per_rss':
  4365. $value = (int) $value;
  4366. if ( empty( $value ) ) {
  4367. $value = 1;
  4368. }
  4369. if ( $value < -1 ) {
  4370. $value = abs( $value );
  4371. }
  4372. break;
  4373. case 'default_ping_status':
  4374. case 'default_comment_status':
  4375. // Options that if not there have 0 value but need to be something like "closed".
  4376. if ( '0' == $value || '' === $value ) {
  4377. $value = 'closed';
  4378. }
  4379. break;
  4380. case 'blogdescription':
  4381. case 'blogname':
  4382. $value = $wpdb->strip_invalid_text_for_column( $wpdb->options, 'option_value', $value );
  4383. if ( $value !== $original_value ) {
  4384. $value = $wpdb->strip_invalid_text_for_column( $wpdb->options, 'option_value', wp_encode_emoji( $original_value ) );
  4385. }
  4386. if ( is_wp_error( $value ) ) {
  4387. $error = $value->get_error_message();
  4388. } else {
  4389. $value = esc_html( $value );
  4390. }
  4391. break;
  4392. case 'blog_charset':
  4393. $value = preg_replace( '/[^a-zA-Z0-9_-]/', '', $value ); // Strips slashes.
  4394. break;
  4395. case 'blog_public':
  4396. // This is the value if the settings checkbox is not checked on POST. Don't rely on this.
  4397. if ( null === $value ) {
  4398. $value = 1;
  4399. } else {
  4400. $value = (int) $value;
  4401. }
  4402. break;
  4403. case 'date_format':
  4404. case 'time_format':
  4405. case 'mailserver_url':
  4406. case 'mailserver_login':
  4407. case 'mailserver_pass':
  4408. case 'upload_path':
  4409. $value = $wpdb->strip_invalid_text_for_column( $wpdb->options, 'option_value', $value );
  4410. if ( is_wp_error( $value ) ) {
  4411. $error = $value->get_error_message();
  4412. } else {
  4413. $value = strip_tags( $value );
  4414. $value = wp_kses_data( $value );
  4415. }
  4416. break;
  4417. case 'ping_sites':
  4418. $value = explode( "\n", $value );
  4419. $value = array_filter( array_map( 'trim', $value ) );
  4420. $value = array_filter( array_map( 'sanitize_url', $value ) );
  4421. $value = implode( "\n", $value );
  4422. break;
  4423. case 'gmt_offset':
  4424. $value = preg_replace( '/[^0-9:.-]/', '', $value ); // Strips slashes.
  4425. break;
  4426. case 'siteurl':
  4427. $value = $wpdb->strip_invalid_text_for_column( $wpdb->options, 'option_value', $value );
  4428. if ( is_wp_error( $value ) ) {
  4429. $error = $value->get_error_message();
  4430. } else {
  4431. if ( preg_match( '#http(s?)://(.+)#i', $value ) ) {
  4432. $value = sanitize_url( $value );
  4433. } else {
  4434. $error = __( 'The WordPress address you entered did not appear to be a valid URL. Please enter a valid URL.' );
  4435. }
  4436. }
  4437. break;
  4438. case 'home':
  4439. $value = $wpdb->strip_invalid_text_for_column( $wpdb->options, 'option_value', $value );
  4440. if ( is_wp_error( $value ) ) {
  4441. $error = $value->get_error_message();
  4442. } else {
  4443. if ( preg_match( '#http(s?)://(.+)#i', $value ) ) {
  4444. $value = sanitize_url( $value );
  4445. } else {
  4446. $error = __( 'The Site address you entered did not appear to be a valid URL. Please enter a valid URL.' );
  4447. }
  4448. }
  4449. break;
  4450. case 'WPLANG':
  4451. $allowed = get_available_languages();
  4452. if ( ! is_multisite() && defined( 'WPLANG' ) && '' !== WPLANG && 'en_US' !== WPLANG ) {
  4453. $allowed[] = WPLANG;
  4454. }
  4455. if ( ! in_array( $value, $allowed, true ) && ! empty( $value ) ) {
  4456. $value = get_option( $option );
  4457. }
  4458. break;
  4459. case 'illegal_names':
  4460. $value = $wpdb->strip_invalid_text_for_column( $wpdb->options, 'option_value', $value );
  4461. if ( is_wp_error( $value ) ) {
  4462. $error = $value->get_error_message();
  4463. } else {
  4464. if ( ! is_array( $value ) ) {
  4465. $value = explode( ' ', $value );
  4466. }
  4467. $value = array_values( array_filter( array_map( 'trim', $value ) ) );
  4468. if ( ! $value ) {
  4469. $value = '';
  4470. }
  4471. }
  4472. break;
  4473. case 'limited_email_domains':
  4474. case 'banned_email_domains':
  4475. $value = $wpdb->strip_invalid_text_for_column( $wpdb->options, 'option_value', $value );
  4476. if ( is_wp_error( $value ) ) {
  4477. $error = $value->get_error_message();
  4478. } else {
  4479. if ( ! is_array( $value ) ) {
  4480. $value = explode( "\n", $value );
  4481. }
  4482. $domains = array_values( array_filter( array_map( 'trim', $value ) ) );
  4483. $value = array();
  4484. foreach ( $domains as $domain ) {
  4485. if ( ! preg_match( '/(--|\.\.)/', $domain ) && preg_match( '|^([a-zA-Z0-9-\.])+$|', $domain ) ) {
  4486. $value[] = $domain;
  4487. }
  4488. }
  4489. if ( ! $value ) {
  4490. $value = '';
  4491. }
  4492. }
  4493. break;
  4494. case 'timezone_string':
  4495. $allowed_zones = timezone_identifiers_list( DateTimeZone::ALL_WITH_BC );
  4496. if ( ! in_array( $value, $allowed_zones, true ) && ! empty( $value ) ) {
  4497. $error = __( 'The timezone you have entered is not valid. Please select a valid timezone.' );
  4498. }
  4499. break;
  4500. case 'permalink_structure':
  4501. case 'category_base':
  4502. case 'tag_base':
  4503. $value = $wpdb->strip_invalid_text_for_column( $wpdb->options, 'option_value', $value );
  4504. if ( is_wp_error( $value ) ) {
  4505. $error = $value->get_error_message();
  4506. } else {
  4507. $value = sanitize_url( $value );
  4508. $value = str_replace( 'http://', '', $value );
  4509. }
  4510. if ( 'permalink_structure' === $option && null === $error
  4511. && '' !== $value && ! preg_match( '/%[^\/%]+%/', $value )
  4512. ) {
  4513. $error = sprintf(
  4514. /* translators: %s: Documentation URL. */
  4515. __( 'A structure tag is required when using custom permalinks. <a href="%s">Learn more</a>' ),
  4516. __( 'https://wordpress.org/support/article/using-permalinks/#choosing-your-permalink-structure' )
  4517. );
  4518. }
  4519. break;
  4520. case 'default_role':
  4521. if ( ! get_role( $value ) && get_role( 'subscriber' ) ) {
  4522. $value = 'subscriber';
  4523. }
  4524. break;
  4525. case 'moderation_keys':
  4526. case 'disallowed_keys':
  4527. $value = $wpdb->strip_invalid_text_for_column( $wpdb->options, 'option_value', $value );
  4528. if ( is_wp_error( $value ) ) {
  4529. $error = $value->get_error_message();
  4530. } else {
  4531. $value = explode( "\n", $value );
  4532. $value = array_filter( array_map( 'trim', $value ) );
  4533. $value = array_unique( $value );
  4534. $value = implode( "\n", $value );
  4535. }
  4536. break;
  4537. }
  4538. if ( null !== $error ) {
  4539. if ( '' === $error && is_wp_error( $value ) ) {
  4540. /* translators: 1: Option name, 2: Error code. */
  4541. $error = sprintf( __( 'Could not sanitize the %1$s option. Error code: %2$s' ), $option, $value->get_error_code() );
  4542. }
  4543. $value = get_option( $option );
  4544. if ( function_exists( 'add_settings_error' ) ) {
  4545. add_settings_error( $option, "invalid_{$option}", $error );
  4546. }
  4547. }
  4548. /**
  4549. * Filters an option value following sanitization.
  4550. *
  4551. * @since 2.3.0
  4552. * @since 4.3.0 Added the `$original_value` parameter.
  4553. *
  4554. * @param string $value The sanitized option value.
  4555. * @param string $option The option name.
  4556. * @param string $original_value The original value passed to the function.
  4557. */
  4558. return apply_filters( "sanitize_option_{$option}", $value, $option, $original_value );
  4559. }
  4560. /**
  4561. * Maps a function to all non-iterable elements of an array or an object.
  4562. *
  4563. * This is similar to `array_walk_recursive()` but acts upon objects too.
  4564. *
  4565. * @since 4.4.0
  4566. *
  4567. * @param mixed $value The array, object, or scalar.
  4568. * @param callable $callback The function to map onto $value.
  4569. * @return mixed The value with the callback applied to all non-arrays and non-objects inside it.
  4570. */
  4571. function map_deep( $value, $callback ) {
  4572. if ( is_array( $value ) ) {
  4573. foreach ( $value as $index => $item ) {
  4574. $value[ $index ] = map_deep( $item, $callback );
  4575. }
  4576. } elseif ( is_object( $value ) ) {
  4577. $object_vars = get_object_vars( $value );
  4578. foreach ( $object_vars as $property_name => $property_value ) {
  4579. $value->$property_name = map_deep( $property_value, $callback );
  4580. }
  4581. } else {
  4582. $value = call_user_func( $callback, $value );
  4583. }
  4584. return $value;
  4585. }
  4586. /**
  4587. * Parses a string into variables to be stored in an array.
  4588. *
  4589. * @since 2.2.1
  4590. *
  4591. * @param string $string The string to be parsed.
  4592. * @param array $array Variables will be stored in this array.
  4593. */
  4594. function wp_parse_str( $string, &$array ) {
  4595. parse_str( (string) $string, $array );
  4596. /**
  4597. * Filters the array of variables derived from a parsed string.
  4598. *
  4599. * @since 2.2.1
  4600. *
  4601. * @param array $array The array populated with variables.
  4602. */
  4603. $array = apply_filters( 'wp_parse_str', $array );
  4604. }
  4605. /**
  4606. * Converts lone less than signs.
  4607. *
  4608. * KSES already converts lone greater than signs.
  4609. *
  4610. * @since 2.3.0
  4611. *
  4612. * @param string $text Text to be converted.
  4613. * @return string Converted text.
  4614. */
  4615. function wp_pre_kses_less_than( $text ) {
  4616. return preg_replace_callback( '%<[^>]*?((?=<)|>|$)%', 'wp_pre_kses_less_than_callback', $text );
  4617. }
  4618. /**
  4619. * Callback function used by preg_replace.
  4620. *
  4621. * @since 2.3.0
  4622. *
  4623. * @param string[] $matches Populated by matches to preg_replace.
  4624. * @return string The text returned after esc_html if needed.
  4625. */
  4626. function wp_pre_kses_less_than_callback( $matches ) {
  4627. if ( false === strpos( $matches[0], '>' ) ) {
  4628. return esc_html( $matches[0] );
  4629. }
  4630. return $matches[0];
  4631. }
  4632. /**
  4633. * Removes non-allowable HTML from parsed block attribute values when filtering
  4634. * in the post context.
  4635. *
  4636. * @since 5.3.1
  4637. *
  4638. * @param string $string Content to be run through KSES.
  4639. * @param array[]|string $allowed_html An array of allowed HTML elements
  4640. * and attributes, or a context name
  4641. * such as 'post'.
  4642. * @param string[] $allowed_protocols Array of allowed URL protocols.
  4643. * @return string Filtered text to run through KSES.
  4644. */
  4645. function wp_pre_kses_block_attributes( $string, $allowed_html, $allowed_protocols ) {
  4646. /*
  4647. * `filter_block_content` is expected to call `wp_kses`. Temporarily remove
  4648. * the filter to avoid recursion.
  4649. */
  4650. remove_filter( 'pre_kses', 'wp_pre_kses_block_attributes', 10 );
  4651. $string = filter_block_content( $string, $allowed_html, $allowed_protocols );
  4652. add_filter( 'pre_kses', 'wp_pre_kses_block_attributes', 10, 3 );
  4653. return $string;
  4654. }
  4655. /**
  4656. * WordPress implementation of PHP sprintf() with filters.
  4657. *
  4658. * @since 2.5.0
  4659. * @since 5.3.0 Formalized the existing and already documented `...$args` parameter
  4660. * by adding it to the function signature.
  4661. *
  4662. * @link https://www.php.net/sprintf
  4663. *
  4664. * @param string $pattern The string which formatted args are inserted.
  4665. * @param mixed ...$args Arguments to be formatted into the $pattern string.
  4666. * @return string The formatted string.
  4667. */
  4668. function wp_sprintf( $pattern, ...$args ) {
  4669. $len = strlen( $pattern );
  4670. $start = 0;
  4671. $result = '';
  4672. $arg_index = 0;
  4673. while ( $len > $start ) {
  4674. // Last character: append and break.
  4675. if ( strlen( $pattern ) - 1 == $start ) {
  4676. $result .= substr( $pattern, -1 );
  4677. break;
  4678. }
  4679. // Literal %: append and continue.
  4680. if ( '%%' === substr( $pattern, $start, 2 ) ) {
  4681. $start += 2;
  4682. $result .= '%';
  4683. continue;
  4684. }
  4685. // Get fragment before next %.
  4686. $end = strpos( $pattern, '%', $start + 1 );
  4687. if ( false === $end ) {
  4688. $end = $len;
  4689. }
  4690. $fragment = substr( $pattern, $start, $end - $start );
  4691. // Fragment has a specifier.
  4692. if ( '%' === $pattern[ $start ] ) {
  4693. // Find numbered arguments or take the next one in order.
  4694. if ( preg_match( '/^%(\d+)\$/', $fragment, $matches ) ) {
  4695. $index = $matches[1] - 1; // 0-based array vs 1-based sprintf() arguments.
  4696. $arg = isset( $args[ $index ] ) ? $args[ $index ] : '';
  4697. $fragment = str_replace( "%{$matches[1]}$", '%', $fragment );
  4698. } else {
  4699. $arg = isset( $args[ $arg_index ] ) ? $args[ $arg_index ] : '';
  4700. ++$arg_index;
  4701. }
  4702. /**
  4703. * Filters a fragment from the pattern passed to wp_sprintf().
  4704. *
  4705. * If the fragment is unchanged, then sprintf() will be run on the fragment.
  4706. *
  4707. * @since 2.5.0
  4708. *
  4709. * @param string $fragment A fragment from the pattern.
  4710. * @param string $arg The argument.
  4711. */
  4712. $_fragment = apply_filters( 'wp_sprintf', $fragment, $arg );
  4713. if ( $_fragment != $fragment ) {
  4714. $fragment = $_fragment;
  4715. } else {
  4716. $fragment = sprintf( $fragment, (string) $arg );
  4717. }
  4718. }
  4719. // Append to result and move to next fragment.
  4720. $result .= $fragment;
  4721. $start = $end;
  4722. }
  4723. return $result;
  4724. }
  4725. /**
  4726. * Localizes list items before the rest of the content.
  4727. *
  4728. * The '%l' must be at the first characters can then contain the rest of the
  4729. * content. The list items will have ', ', ', and', and ' and ' added depending
  4730. * on the amount of list items in the $args parameter.
  4731. *
  4732. * @since 2.5.0
  4733. *
  4734. * @param string $pattern Content containing '%l' at the beginning.
  4735. * @param array $args List items to prepend to the content and replace '%l'.
  4736. * @return string Localized list items and rest of the content.
  4737. */
  4738. function wp_sprintf_l( $pattern, $args ) {
  4739. // Not a match.
  4740. if ( '%l' !== substr( $pattern, 0, 2 ) ) {
  4741. return $pattern;
  4742. }
  4743. // Nothing to work with.
  4744. if ( empty( $args ) ) {
  4745. return '';
  4746. }
  4747. /**
  4748. * Filters the translated delimiters used by wp_sprintf_l().
  4749. * Placeholders (%s) are included to assist translators and then
  4750. * removed before the array of strings reaches the filter.
  4751. *
  4752. * Please note: Ampersands and entities should be avoided here.
  4753. *
  4754. * @since 2.5.0
  4755. *
  4756. * @param array $delimiters An array of translated delimiters.
  4757. */
  4758. $l = apply_filters(
  4759. 'wp_sprintf_l',
  4760. array(
  4761. /* translators: Used to join items in a list with more than 2 items. */
  4762. 'between' => sprintf( __( '%1$s, %2$s' ), '', '' ),
  4763. /* translators: Used to join last two items in a list with more than 2 times. */
  4764. 'between_last_two' => sprintf( __( '%1$s, and %2$s' ), '', '' ),
  4765. /* translators: Used to join items in a list with only 2 items. */
  4766. 'between_only_two' => sprintf( __( '%1$s and %2$s' ), '', '' ),
  4767. )
  4768. );
  4769. $args = (array) $args;
  4770. $result = array_shift( $args );
  4771. if ( count( $args ) == 1 ) {
  4772. $result .= $l['between_only_two'] . array_shift( $args );
  4773. }
  4774. // Loop when more than two args.
  4775. $i = count( $args );
  4776. while ( $i ) {
  4777. $arg = array_shift( $args );
  4778. $i--;
  4779. if ( 0 == $i ) {
  4780. $result .= $l['between_last_two'] . $arg;
  4781. } else {
  4782. $result .= $l['between'] . $arg;
  4783. }
  4784. }
  4785. return $result . substr( $pattern, 2 );
  4786. }
  4787. /**
  4788. * Safely extracts not more than the first $count characters from HTML string.
  4789. *
  4790. * UTF-8, tags and entities safe prefix extraction. Entities inside will *NOT*
  4791. * be counted as one character. For example &amp; will be counted as 4, &lt; as
  4792. * 3, etc.
  4793. *
  4794. * @since 2.5.0
  4795. *
  4796. * @param string $str String to get the excerpt from.
  4797. * @param int $count Maximum number of characters to take.
  4798. * @param string $more Optional. What to append if $str needs to be trimmed. Defaults to empty string.
  4799. * @return string The excerpt.
  4800. */
  4801. function wp_html_excerpt( $str, $count, $more = null ) {
  4802. if ( null === $more ) {
  4803. $more = '';
  4804. }
  4805. $str = wp_strip_all_tags( $str, true );
  4806. $excerpt = mb_substr( $str, 0, $count );
  4807. // Remove part of an entity at the end.
  4808. $excerpt = preg_replace( '/&[^;\s]{0,6}$/', '', $excerpt );
  4809. if ( $str != $excerpt ) {
  4810. $excerpt = trim( $excerpt ) . $more;
  4811. }
  4812. return $excerpt;
  4813. }
  4814. /**
  4815. * Adds a base URL to relative links in passed content.
  4816. *
  4817. * By default it supports the 'src' and 'href' attributes. However this can be
  4818. * changed via the 3rd param.
  4819. *
  4820. * @since 2.7.0
  4821. *
  4822. * @global string $_links_add_base
  4823. *
  4824. * @param string $content String to search for links in.
  4825. * @param string $base The base URL to prefix to links.
  4826. * @param array $attrs The attributes which should be processed.
  4827. * @return string The processed content.
  4828. */
  4829. function links_add_base_url( $content, $base, $attrs = array( 'src', 'href' ) ) {
  4830. global $_links_add_base;
  4831. $_links_add_base = $base;
  4832. $attrs = implode( '|', (array) $attrs );
  4833. return preg_replace_callback( "!($attrs)=(['\"])(.+?)\\2!i", '_links_add_base', $content );
  4834. }
  4835. /**
  4836. * Callback to add a base URL to relative links in passed content.
  4837. *
  4838. * @since 2.7.0
  4839. * @access private
  4840. *
  4841. * @global string $_links_add_base
  4842. *
  4843. * @param string $m The matched link.
  4844. * @return string The processed link.
  4845. */
  4846. function _links_add_base( $m ) {
  4847. global $_links_add_base;
  4848. // 1 = attribute name 2 = quotation mark 3 = URL.
  4849. return $m[1] . '=' . $m[2] .
  4850. ( preg_match( '#^(\w{1,20}):#', $m[3], $protocol ) && in_array( $protocol[1], wp_allowed_protocols(), true ) ?
  4851. $m[3] :
  4852. WP_Http::make_absolute_url( $m[3], $_links_add_base )
  4853. )
  4854. . $m[2];
  4855. }
  4856. /**
  4857. * Adds a Target attribute to all links in passed content.
  4858. *
  4859. * This function by default only applies to `<a>` tags, however this can be
  4860. * modified by the 3rd param.
  4861. *
  4862. * *NOTE:* Any current target attributed will be stripped and replaced.
  4863. *
  4864. * @since 2.7.0
  4865. *
  4866. * @global string $_links_add_target
  4867. *
  4868. * @param string $content String to search for links in.
  4869. * @param string $target The Target to add to the links.
  4870. * @param string[] $tags An array of tags to apply to.
  4871. * @return string The processed content.
  4872. */
  4873. function links_add_target( $content, $target = '_blank', $tags = array( 'a' ) ) {
  4874. global $_links_add_target;
  4875. $_links_add_target = $target;
  4876. $tags = implode( '|', (array) $tags );
  4877. return preg_replace_callback( "!<($tags)((\s[^>]*)?)>!i", '_links_add_target', $content );
  4878. }
  4879. /**
  4880. * Callback to add a target attribute to all links in passed content.
  4881. *
  4882. * @since 2.7.0
  4883. * @access private
  4884. *
  4885. * @global string $_links_add_target
  4886. *
  4887. * @param string $m The matched link.
  4888. * @return string The processed link.
  4889. */
  4890. function _links_add_target( $m ) {
  4891. global $_links_add_target;
  4892. $tag = $m[1];
  4893. $link = preg_replace( '|( target=([\'"])(.*?)\2)|i', '', $m[2] );
  4894. return '<' . $tag . $link . ' target="' . esc_attr( $_links_add_target ) . '">';
  4895. }
  4896. /**
  4897. * Normalizes EOL characters and strips duplicate whitespace.
  4898. *
  4899. * @since 2.7.0
  4900. *
  4901. * @param string $str The string to normalize.
  4902. * @return string The normalized string.
  4903. */
  4904. function normalize_whitespace( $str ) {
  4905. $str = trim( $str );
  4906. $str = str_replace( "\r", "\n", $str );
  4907. $str = preg_replace( array( '/\n+/', '/[ \t]+/' ), array( "\n", ' ' ), $str );
  4908. return $str;
  4909. }
  4910. /**
  4911. * Properly strips all HTML tags including script and style
  4912. *
  4913. * This differs from strip_tags() because it removes the contents of
  4914. * the `<script>` and `<style>` tags. E.g. `strip_tags( '<script>something</script>' )`
  4915. * will return 'something'. wp_strip_all_tags will return ''
  4916. *
  4917. * @since 2.9.0
  4918. *
  4919. * @param string $string String containing HTML tags
  4920. * @param bool $remove_breaks Optional. Whether to remove left over line breaks and white space chars
  4921. * @return string The processed string.
  4922. */
  4923. function wp_strip_all_tags( $string, $remove_breaks = false ) {
  4924. $string = preg_replace( '@<(script|style)[^>]*?>.*?</\\1>@si', '', $string );
  4925. $string = strip_tags( $string );
  4926. if ( $remove_breaks ) {
  4927. $string = preg_replace( '/[\r\n\t ]+/', ' ', $string );
  4928. }
  4929. return trim( $string );
  4930. }
  4931. /**
  4932. * Sanitizes a string from user input or from the database.
  4933. *
  4934. * - Checks for invalid UTF-8,
  4935. * - Converts single `<` characters to entities
  4936. * - Strips all tags
  4937. * - Removes line breaks, tabs, and extra whitespace
  4938. * - Strips octets
  4939. *
  4940. * @since 2.9.0
  4941. *
  4942. * @see sanitize_textarea_field()
  4943. * @see wp_check_invalid_utf8()
  4944. * @see wp_strip_all_tags()
  4945. *
  4946. * @param string $str String to sanitize.
  4947. * @return string Sanitized string.
  4948. */
  4949. function sanitize_text_field( $str ) {
  4950. $filtered = _sanitize_text_fields( $str, false );
  4951. /**
  4952. * Filters a sanitized text field string.
  4953. *
  4954. * @since 2.9.0
  4955. *
  4956. * @param string $filtered The sanitized string.
  4957. * @param string $str The string prior to being sanitized.
  4958. */
  4959. return apply_filters( 'sanitize_text_field', $filtered, $str );
  4960. }
  4961. /**
  4962. * Sanitizes a multiline string from user input or from the database.
  4963. *
  4964. * The function is like sanitize_text_field(), but preserves
  4965. * new lines (\n) and other whitespace, which are legitimate
  4966. * input in textarea elements.
  4967. *
  4968. * @see sanitize_text_field()
  4969. *
  4970. * @since 4.7.0
  4971. *
  4972. * @param string $str String to sanitize.
  4973. * @return string Sanitized string.
  4974. */
  4975. function sanitize_textarea_field( $str ) {
  4976. $filtered = _sanitize_text_fields( $str, true );
  4977. /**
  4978. * Filters a sanitized textarea field string.
  4979. *
  4980. * @since 4.7.0
  4981. *
  4982. * @param string $filtered The sanitized string.
  4983. * @param string $str The string prior to being sanitized.
  4984. */
  4985. return apply_filters( 'sanitize_textarea_field', $filtered, $str );
  4986. }
  4987. /**
  4988. * Internal helper function to sanitize a string from user input or from the database.
  4989. *
  4990. * @since 4.7.0
  4991. * @access private
  4992. *
  4993. * @param string $str String to sanitize.
  4994. * @param bool $keep_newlines Optional. Whether to keep newlines. Default: false.
  4995. * @return string Sanitized string.
  4996. */
  4997. function _sanitize_text_fields( $str, $keep_newlines = false ) {
  4998. if ( is_object( $str ) || is_array( $str ) ) {
  4999. return '';
  5000. }
  5001. $str = (string) $str;
  5002. $filtered = wp_check_invalid_utf8( $str );
  5003. if ( strpos( $filtered, '<' ) !== false ) {
  5004. $filtered = wp_pre_kses_less_than( $filtered );
  5005. // This will strip extra whitespace for us.
  5006. $filtered = wp_strip_all_tags( $filtered, false );
  5007. // Use HTML entities in a special case to make sure no later
  5008. // newline stripping stage could lead to a functional tag.
  5009. $filtered = str_replace( "<\n", "&lt;\n", $filtered );
  5010. }
  5011. if ( ! $keep_newlines ) {
  5012. $filtered = preg_replace( '/[\r\n\t ]+/', ' ', $filtered );
  5013. }
  5014. $filtered = trim( $filtered );
  5015. $found = false;
  5016. while ( preg_match( '/%[a-f0-9]{2}/i', $filtered, $match ) ) {
  5017. $filtered = str_replace( $match[0], '', $filtered );
  5018. $found = true;
  5019. }
  5020. if ( $found ) {
  5021. // Strip out the whitespace that may now exist after removing the octets.
  5022. $filtered = trim( preg_replace( '/ +/', ' ', $filtered ) );
  5023. }
  5024. return $filtered;
  5025. }
  5026. /**
  5027. * i18n-friendly version of basename().
  5028. *
  5029. * @since 3.1.0
  5030. *
  5031. * @param string $path A path.
  5032. * @param string $suffix If the filename ends in suffix this will also be cut off.
  5033. * @return string
  5034. */
  5035. function wp_basename( $path, $suffix = '' ) {
  5036. return urldecode( basename( str_replace( array( '%2F', '%5C' ), '/', urlencode( $path ) ), $suffix ) );
  5037. }
  5038. // phpcs:disable WordPress.WP.CapitalPDangit.Misspelled, WordPress.NamingConventions.ValidFunctionName.FunctionNameInvalid -- 8-)
  5039. /**
  5040. * Forever eliminate "Wordpress" from the planet (or at least the little bit we can influence).
  5041. *
  5042. * Violating our coding standards for a good function name.
  5043. *
  5044. * @since 3.0.0
  5045. *
  5046. * @param string $text The text to be modified.
  5047. * @return string The modified text.
  5048. */
  5049. function capital_P_dangit( $text ) {
  5050. // Simple replacement for titles.
  5051. $current_filter = current_filter();
  5052. if ( 'the_title' === $current_filter || 'wp_title' === $current_filter ) {
  5053. return str_replace( 'Wordpress', 'WordPress', $text );
  5054. }
  5055. // Still here? Use the more judicious replacement.
  5056. static $dblq = false;
  5057. if ( false === $dblq ) {
  5058. $dblq = _x( '&#8220;', 'opening curly double quote' );
  5059. }
  5060. return str_replace(
  5061. array( ' Wordpress', '&#8216;Wordpress', $dblq . 'Wordpress', '>Wordpress', '(Wordpress' ),
  5062. array( ' WordPress', '&#8216;WordPress', $dblq . 'WordPress', '>WordPress', '(WordPress' ),
  5063. $text
  5064. );
  5065. }
  5066. // phpcs:enable
  5067. /**
  5068. * Sanitizes a mime type
  5069. *
  5070. * @since 3.1.3
  5071. *
  5072. * @param string $mime_type Mime type.
  5073. * @return string Sanitized mime type.
  5074. */
  5075. function sanitize_mime_type( $mime_type ) {
  5076. $sani_mime_type = preg_replace( '/[^-+*.a-zA-Z0-9\/]/', '', $mime_type );
  5077. /**
  5078. * Filters a mime type following sanitization.
  5079. *
  5080. * @since 3.1.3
  5081. *
  5082. * @param string $sani_mime_type The sanitized mime type.
  5083. * @param string $mime_type The mime type prior to sanitization.
  5084. */
  5085. return apply_filters( 'sanitize_mime_type', $sani_mime_type, $mime_type );
  5086. }
  5087. /**
  5088. * Sanitizes space or carriage return separated URLs that are used to send trackbacks.
  5089. *
  5090. * @since 3.4.0
  5091. *
  5092. * @param string $to_ping Space or carriage return separated URLs
  5093. * @return string URLs starting with the http or https protocol, separated by a carriage return.
  5094. */
  5095. function sanitize_trackback_urls( $to_ping ) {
  5096. $urls_to_ping = preg_split( '/[\r\n\t ]/', trim( $to_ping ), -1, PREG_SPLIT_NO_EMPTY );
  5097. foreach ( $urls_to_ping as $k => $url ) {
  5098. if ( ! preg_match( '#^https?://.#i', $url ) ) {
  5099. unset( $urls_to_ping[ $k ] );
  5100. }
  5101. }
  5102. $urls_to_ping = array_map( 'sanitize_url', $urls_to_ping );
  5103. $urls_to_ping = implode( "\n", $urls_to_ping );
  5104. /**
  5105. * Filters a list of trackback URLs following sanitization.
  5106. *
  5107. * The string returned here consists of a space or carriage return-delimited list
  5108. * of trackback URLs.
  5109. *
  5110. * @since 3.4.0
  5111. *
  5112. * @param string $urls_to_ping Sanitized space or carriage return separated URLs.
  5113. * @param string $to_ping Space or carriage return separated URLs before sanitization.
  5114. */
  5115. return apply_filters( 'sanitize_trackback_urls', $urls_to_ping, $to_ping );
  5116. }
  5117. /**
  5118. * Adds slashes to a string or recursively adds slashes to strings within an array.
  5119. *
  5120. * This should be used when preparing data for core API that expects slashed data.
  5121. * This should not be used to escape data going directly into an SQL query.
  5122. *
  5123. * @since 3.6.0
  5124. * @since 5.5.0 Non-string values are left untouched.
  5125. *
  5126. * @param string|array $value String or array of data to slash.
  5127. * @return string|array Slashed `$value`, in the same type as supplied.
  5128. */
  5129. function wp_slash( $value ) {
  5130. if ( is_array( $value ) ) {
  5131. $value = array_map( 'wp_slash', $value );
  5132. }
  5133. if ( is_string( $value ) ) {
  5134. return addslashes( $value );
  5135. }
  5136. return $value;
  5137. }
  5138. /**
  5139. * Removes slashes from a string or recursively removes slashes from strings within an array.
  5140. *
  5141. * This should be used to remove slashes from data passed to core API that
  5142. * expects data to be unslashed.
  5143. *
  5144. * @since 3.6.0
  5145. *
  5146. * @param string|array $value String or array of data to unslash.
  5147. * @return string|array Unslashed `$value`, in the same type as supplied.
  5148. */
  5149. function wp_unslash( $value ) {
  5150. return stripslashes_deep( $value );
  5151. }
  5152. /**
  5153. * Extracts and returns the first URL from passed content.
  5154. *
  5155. * @since 3.6.0
  5156. *
  5157. * @param string $content A string which might contain a URL.
  5158. * @return string|false The found URL.
  5159. */
  5160. function get_url_in_content( $content ) {
  5161. if ( empty( $content ) ) {
  5162. return false;
  5163. }
  5164. if ( preg_match( '/<a\s[^>]*?href=([\'"])(.+?)\1/is', $content, $matches ) ) {
  5165. return sanitize_url( $matches[2] );
  5166. }
  5167. return false;
  5168. }
  5169. /**
  5170. * Returns the regexp for common whitespace characters.
  5171. *
  5172. * By default, spaces include new lines, tabs, nbsp entities, and the UTF-8 nbsp.
  5173. * This is designed to replace the PCRE \s sequence. In ticket #22692, that
  5174. * sequence was found to be unreliable due to random inclusion of the A0 byte.
  5175. *
  5176. * @since 4.0.0
  5177. *
  5178. * @return string The spaces regexp.
  5179. */
  5180. function wp_spaces_regexp() {
  5181. static $spaces = '';
  5182. if ( empty( $spaces ) ) {
  5183. /**
  5184. * Filters the regexp for common whitespace characters.
  5185. *
  5186. * This string is substituted for the \s sequence as needed in regular
  5187. * expressions. For websites not written in English, different characters
  5188. * may represent whitespace. For websites not encoded in UTF-8, the 0xC2 0xA0
  5189. * sequence may not be in use.
  5190. *
  5191. * @since 4.0.0
  5192. *
  5193. * @param string $spaces Regexp pattern for matching common whitespace characters.
  5194. */
  5195. $spaces = apply_filters( 'wp_spaces_regexp', '[\r\n\t ]|\xC2\xA0|&nbsp;' );
  5196. }
  5197. return $spaces;
  5198. }
  5199. /**
  5200. * Prints the important emoji-related styles.
  5201. *
  5202. * @since 4.2.0
  5203. */
  5204. function print_emoji_styles() {
  5205. static $printed = false;
  5206. if ( $printed ) {
  5207. return;
  5208. }
  5209. $printed = true;
  5210. $type_attr = current_theme_supports( 'html5', 'style' ) ? '' : ' type="text/css"';
  5211. ?>
  5212. <style<?php echo $type_attr; ?>>
  5213. img.wp-smiley,
  5214. img.emoji {
  5215. display: inline !important;
  5216. border: none !important;
  5217. box-shadow: none !important;
  5218. height: 1em !important;
  5219. width: 1em !important;
  5220. margin: 0 0.07em !important;
  5221. vertical-align: -0.1em !important;
  5222. background: none !important;
  5223. padding: 0 !important;
  5224. }
  5225. </style>
  5226. <?php
  5227. }
  5228. /**
  5229. * Prints the inline Emoji detection script if it is not already printed.
  5230. *
  5231. * @since 4.2.0
  5232. */
  5233. function print_emoji_detection_script() {
  5234. static $printed = false;
  5235. if ( $printed ) {
  5236. return;
  5237. }
  5238. $printed = true;
  5239. _print_emoji_detection_script();
  5240. }
  5241. /**
  5242. * Prints inline Emoji detection script.
  5243. *
  5244. * @ignore
  5245. * @since 4.6.0
  5246. * @access private
  5247. */
  5248. function _print_emoji_detection_script() {
  5249. $settings = array(
  5250. /**
  5251. * Filters the URL where emoji png images are hosted.
  5252. *
  5253. * @since 4.2.0
  5254. *
  5255. * @param string $url The emoji base URL for png images.
  5256. */
  5257. 'baseUrl' => apply_filters( 'emoji_url', 'https://s.w.org/images/core/emoji/14.0.0/72x72/' ),
  5258. /**
  5259. * Filters the extension of the emoji png files.
  5260. *
  5261. * @since 4.2.0
  5262. *
  5263. * @param string $extension The emoji extension for png files. Default .png.
  5264. */
  5265. 'ext' => apply_filters( 'emoji_ext', '.png' ),
  5266. /**
  5267. * Filters the URL where emoji SVG images are hosted.
  5268. *
  5269. * @since 4.6.0
  5270. *
  5271. * @param string $url The emoji base URL for svg images.
  5272. */
  5273. 'svgUrl' => apply_filters( 'emoji_svg_url', 'https://s.w.org/images/core/emoji/14.0.0/svg/' ),
  5274. /**
  5275. * Filters the extension of the emoji SVG files.
  5276. *
  5277. * @since 4.6.0
  5278. *
  5279. * @param string $extension The emoji extension for svg files. Default .svg.
  5280. */
  5281. 'svgExt' => apply_filters( 'emoji_svg_ext', '.svg' ),
  5282. );
  5283. $version = 'ver=' . get_bloginfo( 'version' );
  5284. if ( SCRIPT_DEBUG ) {
  5285. $settings['source'] = array(
  5286. /** This filter is documented in wp-includes/class-wp-scripts.php */
  5287. 'wpemoji' => apply_filters( 'script_loader_src', includes_url( "js/wp-emoji.js?$version" ), 'wpemoji' ),
  5288. /** This filter is documented in wp-includes/class-wp-scripts.php */
  5289. 'twemoji' => apply_filters( 'script_loader_src', includes_url( "js/twemoji.js?$version" ), 'twemoji' ),
  5290. );
  5291. } else {
  5292. $settings['source'] = array(
  5293. /** This filter is documented in wp-includes/class-wp-scripts.php */
  5294. 'concatemoji' => apply_filters( 'script_loader_src', includes_url( "js/wp-emoji-release.min.js?$version" ), 'concatemoji' ),
  5295. );
  5296. }
  5297. wp_print_inline_script_tag(
  5298. sprintf( 'window._wpemojiSettings = %s;', wp_json_encode( $settings ) ) . "\n" .
  5299. file_get_contents( sprintf( ABSPATH . WPINC . '/js/wp-emoji-loader' . wp_scripts_get_suffix() . '.js' ) )
  5300. );
  5301. }
  5302. /**
  5303. * Converts emoji characters to their equivalent HTML entity.
  5304. *
  5305. * This allows us to store emoji in a DB using the utf8 character set.
  5306. *
  5307. * @since 4.2.0
  5308. *
  5309. * @param string $content The content to encode.
  5310. * @return string The encoded content.
  5311. */
  5312. function wp_encode_emoji( $content ) {
  5313. $emoji = _wp_emoji_list( 'partials' );
  5314. foreach ( $emoji as $emojum ) {
  5315. $emoji_char = html_entity_decode( $emojum );
  5316. if ( false !== strpos( $content, $emoji_char ) ) {
  5317. $content = preg_replace( "/$emoji_char/", $emojum, $content );
  5318. }
  5319. }
  5320. return $content;
  5321. }
  5322. /**
  5323. * Converts emoji to a static img element.
  5324. *
  5325. * @since 4.2.0
  5326. *
  5327. * @param string $text The content to encode.
  5328. * @return string The encoded content.
  5329. */
  5330. function wp_staticize_emoji( $text ) {
  5331. if ( false === strpos( $text, '&#x' ) ) {
  5332. if ( ( function_exists( 'mb_check_encoding' ) && mb_check_encoding( $text, 'ASCII' ) ) || ! preg_match( '/[^\x00-\x7F]/', $text ) ) {
  5333. // The text doesn't contain anything that might be emoji, so we can return early.
  5334. return $text;
  5335. } else {
  5336. $encoded_text = wp_encode_emoji( $text );
  5337. if ( $encoded_text === $text ) {
  5338. return $encoded_text;
  5339. }
  5340. $text = $encoded_text;
  5341. }
  5342. }
  5343. $emoji = _wp_emoji_list( 'entities' );
  5344. // Quickly narrow down the list of emoji that might be in the text and need replacing.
  5345. $possible_emoji = array();
  5346. foreach ( $emoji as $emojum ) {
  5347. if ( false !== strpos( $text, $emojum ) ) {
  5348. $possible_emoji[ $emojum ] = html_entity_decode( $emojum );
  5349. }
  5350. }
  5351. if ( ! $possible_emoji ) {
  5352. return $text;
  5353. }
  5354. /** This filter is documented in wp-includes/formatting.php */
  5355. $cdn_url = apply_filters( 'emoji_url', 'https://s.w.org/images/core/emoji/14.0.0/72x72/' );
  5356. /** This filter is documented in wp-includes/formatting.php */
  5357. $ext = apply_filters( 'emoji_ext', '.png' );
  5358. $output = '';
  5359. /*
  5360. * HTML loop taken from smiley function, which was taken from texturize function.
  5361. * It'll never be consolidated.
  5362. *
  5363. * First, capture the tags as well as in between.
  5364. */
  5365. $textarr = preg_split( '/(<.*>)/U', $text, -1, PREG_SPLIT_DELIM_CAPTURE );
  5366. $stop = count( $textarr );
  5367. // Ignore processing of specific tags.
  5368. $tags_to_ignore = 'code|pre|style|script|textarea';
  5369. $ignore_block_element = '';
  5370. for ( $i = 0; $i < $stop; $i++ ) {
  5371. $content = $textarr[ $i ];
  5372. // If we're in an ignore block, wait until we find its closing tag.
  5373. if ( '' === $ignore_block_element && preg_match( '/^<(' . $tags_to_ignore . ')>/', $content, $matches ) ) {
  5374. $ignore_block_element = $matches[1];
  5375. }
  5376. // If it's not a tag and not in ignore block.
  5377. if ( '' === $ignore_block_element && strlen( $content ) > 0 && '<' !== $content[0] && false !== strpos( $content, '&#x' ) ) {
  5378. foreach ( $possible_emoji as $emojum => $emoji_char ) {
  5379. if ( false === strpos( $content, $emojum ) ) {
  5380. continue;
  5381. }
  5382. $file = str_replace( ';&#x', '-', $emojum );
  5383. $file = str_replace( array( '&#x', ';' ), '', $file );
  5384. $entity = sprintf( '<img src="%s" alt="%s" class="wp-smiley" style="height: 1em; max-height: 1em;" />', $cdn_url . $file . $ext, $emoji_char );
  5385. $content = str_replace( $emojum, $entity, $content );
  5386. }
  5387. }
  5388. // Did we exit ignore block?
  5389. if ( '' !== $ignore_block_element && '</' . $ignore_block_element . '>' === $content ) {
  5390. $ignore_block_element = '';
  5391. }
  5392. $output .= $content;
  5393. }
  5394. // Finally, remove any stray U+FE0F characters.
  5395. $output = str_replace( '&#xfe0f;', '', $output );
  5396. return $output;
  5397. }
  5398. /**
  5399. * Converts emoji in emails into static images.
  5400. *
  5401. * @since 4.2.0
  5402. *
  5403. * @param array $mail The email data array.
  5404. * @return array The email data array, with emoji in the message staticized.
  5405. */
  5406. function wp_staticize_emoji_for_email( $mail ) {
  5407. if ( ! isset( $mail['message'] ) ) {
  5408. return $mail;
  5409. }
  5410. /*
  5411. * We can only transform the emoji into images if it's a `text/html` email.
  5412. * To do that, here's a cut down version of the same process that happens
  5413. * in wp_mail() - get the `Content-Type` from the headers, if there is one,
  5414. * then pass it through the {@see 'wp_mail_content_type'} filter, in case
  5415. * a plugin is handling changing the `Content-Type`.
  5416. */
  5417. $headers = array();
  5418. if ( isset( $mail['headers'] ) ) {
  5419. if ( is_array( $mail['headers'] ) ) {
  5420. $headers = $mail['headers'];
  5421. } else {
  5422. $headers = explode( "\n", str_replace( "\r\n", "\n", $mail['headers'] ) );
  5423. }
  5424. }
  5425. foreach ( $headers as $header ) {
  5426. if ( strpos( $header, ':' ) === false ) {
  5427. continue;
  5428. }
  5429. // Explode them out.
  5430. list( $name, $content ) = explode( ':', trim( $header ), 2 );
  5431. // Cleanup crew.
  5432. $name = trim( $name );
  5433. $content = trim( $content );
  5434. if ( 'content-type' === strtolower( $name ) ) {
  5435. if ( strpos( $content, ';' ) !== false ) {
  5436. list( $type, $charset ) = explode( ';', $content );
  5437. $content_type = trim( $type );
  5438. } else {
  5439. $content_type = trim( $content );
  5440. }
  5441. break;
  5442. }
  5443. }
  5444. // Set Content-Type if we don't have a content-type from the input headers.
  5445. if ( ! isset( $content_type ) ) {
  5446. $content_type = 'text/plain';
  5447. }
  5448. /** This filter is documented in wp-includes/pluggable.php */
  5449. $content_type = apply_filters( 'wp_mail_content_type', $content_type );
  5450. if ( 'text/html' === $content_type ) {
  5451. $mail['message'] = wp_staticize_emoji( $mail['message'] );
  5452. }
  5453. return $mail;
  5454. }
  5455. /**
  5456. * Returns arrays of emoji data.
  5457. *
  5458. * These arrays are automatically built from the regex in twemoji.js - if they need to be updated,
  5459. * you should update the regex there, then run the `npm run grunt precommit:emoji` job.
  5460. *
  5461. * @since 4.9.0
  5462. * @access private
  5463. *
  5464. * @param string $type Optional. Which array type to return. Accepts 'partials' or 'entities', default 'entities'.
  5465. * @return array An array to match all emoji that WordPress recognises.
  5466. */
  5467. function _wp_emoji_list( $type = 'entities' ) {
  5468. // Do not remove the START/END comments - they're used to find where to insert the arrays.
  5469. // START: emoji arrays
  5470. $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;', '&#x1faf1;&#x1f3fb;&#x200d;&#x1faf2;&#x1f3fc;', '&#x1faf1;&#x1f3fb;&#x200d;&#x1faf2;&#x1f3fd;', '&#x1faf1;&#x1f3fb;&#x200d;&#x1faf2;&#x1f3fe;', '&#x1faf1;&#x1f3fb;&#x200d;&#x1faf2;&#x1f3ff;', '&#x1faf1;&#x1f3fc;&#x200d;&#x1faf2;&#x1f3fb;', '&#x1faf1;&#x1f3fc;&#x200d;&#x1faf2;&#x1f3fd;', '&#x1faf1;&#x1f3fc;&#x200d;&#x1faf2;&#x1f3fe;', '&#x1faf1;&#x1f3fc;&#x200d;&#x1faf2;&#x1f3ff;', '&#x1faf1;&#x1f3fd;&#x200d;&#x1faf2;&#x1f3fb;', '&#x1faf1;&#x1f3fd;&#x200d;&#x1faf2;&#x1f3fc;', '&#x1faf1;&#x1f3fd;&#x200d;&#x1faf2;&#x1f3fe;', '&#x1faf1;&#x1f3fd;&#x200d;&#x1faf2;&#x1f3ff;', '&#x1faf1;&#x1f3fe;&#x200d;&#x1faf2;&#x1f3fb;', '&#x1faf1;&#x1f3fe;&#x200d;&#x1faf2;&#x1f3fc;', '&#x1faf1;&#x1f3fe;&#x200d;&#x1faf2;&#x1f3fd;', '&#x1faf1;&#x1f3fe;&#x200d;&#x1faf2;&#x1f3ff;', '&#x1faf1;&#x1f3ff;&#x200d;&#x1faf2;&#x1f3fb;', '&#x1faf1;&#x1f3ff;&#x200d;&#x1faf2;&#x1f3fc;', '&#x1faf1;&#x1f3ff;&#x200d;&#x1faf2;&#x1f3fd;', '&#x1faf1;&#x1f3ff;&#x200d;&#x1faf2;&#x1f3fe;', '&#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;', '&#x1f91d;&#x1f3fb;', '&#x1f91d;&#x1f3fc;', '&#x1f91d;&#x1f3fd;', '&#x1f91d;&#x1f3fe;', '&#x1f91d;&#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;', '&#x1fac3;&#x1f3fb;', '&#x1fac3;&#x1f3fc;', '&#x1fac3;&#x1f3fd;', '&#x1fac3;&#x1f3fe;', '&#x1fac3;&#x1f3ff;', '&#x1fac4;&#x1f3fb;', '&#x1fac4;&#x1f3fc;', '&#x1fac4;&#x1f3fd;', '&#x1fac4;&#x1f3fe;', '&#x1fac4;&#x1f3ff;', '&#x1fac5;&#x1f3fb;', '&#x1fac5;&#x1f3fc;', '&#x1fac5;&#x1f3fd;', '&#x1fac5;&#x1f3fe;', '&#x1fac5;&#x1f3ff;', '&#x1faf0;&#x1f3fb;', '&#x1faf0;&#x1f3fc;', '&#x1faf0;&#x1f3fd;', '&#x1faf0;&#x1f3fe;', '&#x1faf0;&#x1f3ff;', '&#x1faf1;&#x1f3fb;', '&#x1faf1;&#x1f3fc;', '&#x1faf1;&#x1f3fd;', '&#x1faf1;&#x1f3fe;', '&#x1faf1;&#x1f3ff;', '&#x1faf2;&#x1f3fb;', '&#x1faf2;&#x1f3fc;', '&#x1faf2;&#x1f3fd;', '&#x1faf2;&#x1f3fe;', '&#x1faf2;&#x1f3ff;', '&#x1faf3;&#x1f3fb;', '&#x1faf3;&#x1f3fc;', '&#x1faf3;&#x1f3fd;', '&#x1faf3;&#x1f3fe;', '&#x1faf3;&#x1f3ff;', '&#x1faf4;&#x1f3fb;', '&#x1faf4;&#x1f3fc;', '&#x1faf4;&#x1f3fd;', '&#x1faf4;&#x1f3fe;', '&#x1faf4;&#x1f3ff;', '&#x1faf5;&#x1f3fb;', '&#x1faf5;&#x1f3fc;', '&#x1faf5;&#x1f3fd;', '&#x1faf5;&#x1f3fe;', '&#x1faf5;&#x1f3ff;', '&#x1faf6;&#x1f3fb;', '&#x1faf6;&#x1f3fc;', '&#x1faf6;&#x1f3fd;', '&#x1faf6;&#x1f3fe;', '&#x1faf6;&#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;', '&#x1f6dd;', '&#x1f6de;', '&#x1f6df;', '&#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;', '&#x1f7f0;', '&#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;', '&#x1f979;', '&#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;', '&#x1f9cc;', '&#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;', '&#x1fa7b;', '&#x1fa7c;', '&#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;', '&#x1faa9;', '&#x1faaa;', '&#x1faab;', '&#x1faac;', '&#x1fab0;', '&#x1fab1;', '&#x1fab2;', '&#x1fab3;', '&#x1fab4;', '&#x1fab5;', '&#x1fab6;', '&#x1fab7;', '&#x1fab8;', '&#x1fab9;', '&#x1faba;', '&#x1fac0;', '&#x1fac1;', '&#x1fac2;', '&#x1fac3;', '&#x1fac4;', '&#x1fac5;', '&#x1fad0;', '&#x1fad1;', '&#x1fad2;', '&#x1fad3;', '&#x1fad4;', '&#x1fad5;', '&#x1fad6;', '&#x1fad7;', '&#x1fad8;', '&#x1fad9;', '&#x1fae0;', '&#x1fae1;', '&#x1fae2;', '&#x1fae3;', '&#x1fae4;', '&#x1fae5;', '&#x1fae6;', '&#x1fae7;', '&#x1faf0;', '&#x1faf1;', '&#x1faf2;', '&#x1faf3;', '&#x1faf4;', '&#x1faf5;', '&#x1faf6;', '&#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;' );
  5471. $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;', '&#x1f6dd;', '&#x1f6de;', '&#x1f6df;', '&#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;', '&#x1f7f0;', '&#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;', '&#x1f979;', '&#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;', '&#x1f9cc;', '&#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;', '&#x1fa7b;', '&#x1fa7c;', '&#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;', '&#x1faa9;', '&#x1faaa;', '&#x1faab;', '&#x1faac;', '&#x1fab0;', '&#x1fab1;', '&#x1fab2;', '&#x1fab3;', '&#x1fab4;', '&#x1fab5;', '&#x1fab6;', '&#x1fab7;', '&#x1fab8;', '&#x1fab9;', '&#x1faba;', '&#x1fac0;', '&#x1fac1;', '&#x1fac2;', '&#x1fac3;', '&#x1fac4;', '&#x1fac5;', '&#x1fad0;', '&#x1fad1;', '&#x1fad2;', '&#x1fad3;', '&#x1fad4;', '&#x1fad5;', '&#x1fad6;', '&#x1fad7;', '&#x1fad8;', '&#x1fad9;', '&#x1fae0;', '&#x1fae1;', '&#x1fae2;', '&#x1fae3;', '&#x1fae4;', '&#x1fae5;', '&#x1fae6;', '&#x1fae7;', '&#x1faf0;', '&#x1faf1;', '&#x1faf2;', '&#x1faf3;', '&#x1faf4;', '&#x1faf5;', '&#x1faf6;', '&#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;' );
  5472. // END: emoji arrays
  5473. if ( 'entities' === $type ) {
  5474. return $entities;
  5475. }
  5476. return $partials;
  5477. }
  5478. /**
  5479. * Shortens a URL, to be used as link text.
  5480. *
  5481. * @since 1.2.0
  5482. * @since 4.4.0 Moved to wp-includes/formatting.php from wp-admin/includes/misc.php and added $length param.
  5483. *
  5484. * @param string $url URL to shorten.
  5485. * @param int $length Optional. Maximum length of the shortened URL. Default 35 characters.
  5486. * @return string Shortened URL.
  5487. */
  5488. function url_shorten( $url, $length = 35 ) {
  5489. $stripped = str_replace( array( 'https://', 'http://', 'www.' ), '', $url );
  5490. $short_url = untrailingslashit( $stripped );
  5491. if ( strlen( $short_url ) > $length ) {
  5492. $short_url = substr( $short_url, 0, $length - 3 ) . '&hellip;';
  5493. }
  5494. return $short_url;
  5495. }
  5496. /**
  5497. * Sanitizes a hex color.
  5498. *
  5499. * Returns either '', a 3 or 6 digit hex color (with #), or nothing.
  5500. * For sanitizing values without a #, see sanitize_hex_color_no_hash().
  5501. *
  5502. * @since 3.4.0
  5503. *
  5504. * @param string $color
  5505. * @return string|void
  5506. */
  5507. function sanitize_hex_color( $color ) {
  5508. if ( '' === $color ) {
  5509. return '';
  5510. }
  5511. // 3 or 6 hex digits, or the empty string.
  5512. if ( preg_match( '|^#([A-Fa-f0-9]{3}){1,2}$|', $color ) ) {
  5513. return $color;
  5514. }
  5515. }
  5516. /**
  5517. * Sanitizes a hex color without a hash. Use sanitize_hex_color() when possible.
  5518. *
  5519. * Saving hex colors without a hash puts the burden of adding the hash on the
  5520. * UI, which makes it difficult to use or upgrade to other color types such as
  5521. * rgba, hsl, rgb, and HTML color names.
  5522. *
  5523. * Returns either '', a 3 or 6 digit hex color (without a #), or null.
  5524. *
  5525. * @since 3.4.0
  5526. *
  5527. * @param string $color
  5528. * @return string|null
  5529. */
  5530. function sanitize_hex_color_no_hash( $color ) {
  5531. $color = ltrim( $color, '#' );
  5532. if ( '' === $color ) {
  5533. return '';
  5534. }
  5535. return sanitize_hex_color( '#' . $color ) ? $color : null;
  5536. }
  5537. /**
  5538. * Ensures that any hex color is properly hashed.
  5539. * Otherwise, returns value untouched.
  5540. *
  5541. * This method should only be necessary if using sanitize_hex_color_no_hash().
  5542. *
  5543. * @since 3.4.0
  5544. *
  5545. * @param string $color
  5546. * @return string
  5547. */
  5548. function maybe_hash_hex_color( $color ) {
  5549. $unhashed = sanitize_hex_color_no_hash( $color );
  5550. if ( $unhashed ) {
  5551. return '#' . $unhashed;
  5552. }
  5553. return $color;
  5554. }