Mixin.php 118 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089
  1. <?php
  2. namespace Webmozart\Assert;
  3. use ArrayAccess;
  4. use Closure;
  5. use Countable;
  6. use Throwable;
  7. /**
  8. * This trait provides nurllOr*, all* and allNullOr* variants of assertion base methods.
  9. * Do not use this trait directly: it will change, and is not designed for reuse.
  10. */
  11. trait Mixin
  12. {
  13. /**
  14. * @psalm-pure
  15. * @psalm-assert string|null $value
  16. *
  17. * @param mixed $value
  18. * @param string $message
  19. *
  20. * @throws InvalidArgumentException
  21. *
  22. * @return void
  23. */
  24. public static function nullOrString($value, $message = '')
  25. {
  26. null === $value || static::string($value, $message);
  27. }
  28. /**
  29. * @psalm-pure
  30. * @psalm-assert iterable<string> $value
  31. *
  32. * @param mixed $value
  33. * @param string $message
  34. *
  35. * @throws InvalidArgumentException
  36. *
  37. * @return void
  38. */
  39. public static function allString($value, $message = '')
  40. {
  41. static::isIterable($value);
  42. foreach ($value as $entry) {
  43. static::string($entry, $message);
  44. }
  45. }
  46. /**
  47. * @psalm-pure
  48. * @psalm-assert iterable<string|null> $value
  49. *
  50. * @param mixed $value
  51. * @param string $message
  52. *
  53. * @throws InvalidArgumentException
  54. *
  55. * @return void
  56. */
  57. public static function allNullOrString($value, $message = '')
  58. {
  59. static::isIterable($value);
  60. foreach ($value as $entry) {
  61. null === $entry || static::string($entry, $message);
  62. }
  63. }
  64. /**
  65. * @psalm-pure
  66. * @psalm-assert non-empty-string|null $value
  67. *
  68. * @param mixed $value
  69. * @param string $message
  70. *
  71. * @throws InvalidArgumentException
  72. *
  73. * @return void
  74. */
  75. public static function nullOrStringNotEmpty($value, $message = '')
  76. {
  77. null === $value || static::stringNotEmpty($value, $message);
  78. }
  79. /**
  80. * @psalm-pure
  81. * @psalm-assert iterable<non-empty-string> $value
  82. *
  83. * @param mixed $value
  84. * @param string $message
  85. *
  86. * @throws InvalidArgumentException
  87. *
  88. * @return void
  89. */
  90. public static function allStringNotEmpty($value, $message = '')
  91. {
  92. static::isIterable($value);
  93. foreach ($value as $entry) {
  94. static::stringNotEmpty($entry, $message);
  95. }
  96. }
  97. /**
  98. * @psalm-pure
  99. * @psalm-assert iterable<non-empty-string|null> $value
  100. *
  101. * @param mixed $value
  102. * @param string $message
  103. *
  104. * @throws InvalidArgumentException
  105. *
  106. * @return void
  107. */
  108. public static function allNullOrStringNotEmpty($value, $message = '')
  109. {
  110. static::isIterable($value);
  111. foreach ($value as $entry) {
  112. null === $entry || static::stringNotEmpty($entry, $message);
  113. }
  114. }
  115. /**
  116. * @psalm-pure
  117. * @psalm-assert int|null $value
  118. *
  119. * @param mixed $value
  120. * @param string $message
  121. *
  122. * @throws InvalidArgumentException
  123. *
  124. * @return void
  125. */
  126. public static function nullOrInteger($value, $message = '')
  127. {
  128. null === $value || static::integer($value, $message);
  129. }
  130. /**
  131. * @psalm-pure
  132. * @psalm-assert iterable<int> $value
  133. *
  134. * @param mixed $value
  135. * @param string $message
  136. *
  137. * @throws InvalidArgumentException
  138. *
  139. * @return void
  140. */
  141. public static function allInteger($value, $message = '')
  142. {
  143. static::isIterable($value);
  144. foreach ($value as $entry) {
  145. static::integer($entry, $message);
  146. }
  147. }
  148. /**
  149. * @psalm-pure
  150. * @psalm-assert iterable<int|null> $value
  151. *
  152. * @param mixed $value
  153. * @param string $message
  154. *
  155. * @throws InvalidArgumentException
  156. *
  157. * @return void
  158. */
  159. public static function allNullOrInteger($value, $message = '')
  160. {
  161. static::isIterable($value);
  162. foreach ($value as $entry) {
  163. null === $entry || static::integer($entry, $message);
  164. }
  165. }
  166. /**
  167. * @psalm-pure
  168. * @psalm-assert numeric|null $value
  169. *
  170. * @param mixed $value
  171. * @param string $message
  172. *
  173. * @throws InvalidArgumentException
  174. *
  175. * @return void
  176. */
  177. public static function nullOrIntegerish($value, $message = '')
  178. {
  179. null === $value || static::integerish($value, $message);
  180. }
  181. /**
  182. * @psalm-pure
  183. * @psalm-assert iterable<numeric> $value
  184. *
  185. * @param mixed $value
  186. * @param string $message
  187. *
  188. * @throws InvalidArgumentException
  189. *
  190. * @return void
  191. */
  192. public static function allIntegerish($value, $message = '')
  193. {
  194. static::isIterable($value);
  195. foreach ($value as $entry) {
  196. static::integerish($entry, $message);
  197. }
  198. }
  199. /**
  200. * @psalm-pure
  201. * @psalm-assert iterable<numeric|null> $value
  202. *
  203. * @param mixed $value
  204. * @param string $message
  205. *
  206. * @throws InvalidArgumentException
  207. *
  208. * @return void
  209. */
  210. public static function allNullOrIntegerish($value, $message = '')
  211. {
  212. static::isIterable($value);
  213. foreach ($value as $entry) {
  214. null === $entry || static::integerish($entry, $message);
  215. }
  216. }
  217. /**
  218. * @psalm-pure
  219. * @psalm-assert positive-int|null $value
  220. *
  221. * @param mixed $value
  222. * @param string $message
  223. *
  224. * @throws InvalidArgumentException
  225. *
  226. * @return void
  227. */
  228. public static function nullOrPositiveInteger($value, $message = '')
  229. {
  230. null === $value || static::positiveInteger($value, $message);
  231. }
  232. /**
  233. * @psalm-pure
  234. * @psalm-assert iterable<positive-int> $value
  235. *
  236. * @param mixed $value
  237. * @param string $message
  238. *
  239. * @throws InvalidArgumentException
  240. *
  241. * @return void
  242. */
  243. public static function allPositiveInteger($value, $message = '')
  244. {
  245. static::isIterable($value);
  246. foreach ($value as $entry) {
  247. static::positiveInteger($entry, $message);
  248. }
  249. }
  250. /**
  251. * @psalm-pure
  252. * @psalm-assert iterable<positive-int|null> $value
  253. *
  254. * @param mixed $value
  255. * @param string $message
  256. *
  257. * @throws InvalidArgumentException
  258. *
  259. * @return void
  260. */
  261. public static function allNullOrPositiveInteger($value, $message = '')
  262. {
  263. static::isIterable($value);
  264. foreach ($value as $entry) {
  265. null === $entry || static::positiveInteger($entry, $message);
  266. }
  267. }
  268. /**
  269. * @psalm-pure
  270. * @psalm-assert float|null $value
  271. *
  272. * @param mixed $value
  273. * @param string $message
  274. *
  275. * @throws InvalidArgumentException
  276. *
  277. * @return void
  278. */
  279. public static function nullOrFloat($value, $message = '')
  280. {
  281. null === $value || static::float($value, $message);
  282. }
  283. /**
  284. * @psalm-pure
  285. * @psalm-assert iterable<float> $value
  286. *
  287. * @param mixed $value
  288. * @param string $message
  289. *
  290. * @throws InvalidArgumentException
  291. *
  292. * @return void
  293. */
  294. public static function allFloat($value, $message = '')
  295. {
  296. static::isIterable($value);
  297. foreach ($value as $entry) {
  298. static::float($entry, $message);
  299. }
  300. }
  301. /**
  302. * @psalm-pure
  303. * @psalm-assert iterable<float|null> $value
  304. *
  305. * @param mixed $value
  306. * @param string $message
  307. *
  308. * @throws InvalidArgumentException
  309. *
  310. * @return void
  311. */
  312. public static function allNullOrFloat($value, $message = '')
  313. {
  314. static::isIterable($value);
  315. foreach ($value as $entry) {
  316. null === $entry || static::float($entry, $message);
  317. }
  318. }
  319. /**
  320. * @psalm-pure
  321. * @psalm-assert numeric|null $value
  322. *
  323. * @param mixed $value
  324. * @param string $message
  325. *
  326. * @throws InvalidArgumentException
  327. *
  328. * @return void
  329. */
  330. public static function nullOrNumeric($value, $message = '')
  331. {
  332. null === $value || static::numeric($value, $message);
  333. }
  334. /**
  335. * @psalm-pure
  336. * @psalm-assert iterable<numeric> $value
  337. *
  338. * @param mixed $value
  339. * @param string $message
  340. *
  341. * @throws InvalidArgumentException
  342. *
  343. * @return void
  344. */
  345. public static function allNumeric($value, $message = '')
  346. {
  347. static::isIterable($value);
  348. foreach ($value as $entry) {
  349. static::numeric($entry, $message);
  350. }
  351. }
  352. /**
  353. * @psalm-pure
  354. * @psalm-assert iterable<numeric|null> $value
  355. *
  356. * @param mixed $value
  357. * @param string $message
  358. *
  359. * @throws InvalidArgumentException
  360. *
  361. * @return void
  362. */
  363. public static function allNullOrNumeric($value, $message = '')
  364. {
  365. static::isIterable($value);
  366. foreach ($value as $entry) {
  367. null === $entry || static::numeric($entry, $message);
  368. }
  369. }
  370. /**
  371. * @psalm-pure
  372. * @psalm-assert positive-int|0|null $value
  373. *
  374. * @param mixed $value
  375. * @param string $message
  376. *
  377. * @throws InvalidArgumentException
  378. *
  379. * @return void
  380. */
  381. public static function nullOrNatural($value, $message = '')
  382. {
  383. null === $value || static::natural($value, $message);
  384. }
  385. /**
  386. * @psalm-pure
  387. * @psalm-assert iterable<positive-int|0> $value
  388. *
  389. * @param mixed $value
  390. * @param string $message
  391. *
  392. * @throws InvalidArgumentException
  393. *
  394. * @return void
  395. */
  396. public static function allNatural($value, $message = '')
  397. {
  398. static::isIterable($value);
  399. foreach ($value as $entry) {
  400. static::natural($entry, $message);
  401. }
  402. }
  403. /**
  404. * @psalm-pure
  405. * @psalm-assert iterable<positive-int|0|null> $value
  406. *
  407. * @param mixed $value
  408. * @param string $message
  409. *
  410. * @throws InvalidArgumentException
  411. *
  412. * @return void
  413. */
  414. public static function allNullOrNatural($value, $message = '')
  415. {
  416. static::isIterable($value);
  417. foreach ($value as $entry) {
  418. null === $entry || static::natural($entry, $message);
  419. }
  420. }
  421. /**
  422. * @psalm-pure
  423. * @psalm-assert bool|null $value
  424. *
  425. * @param mixed $value
  426. * @param string $message
  427. *
  428. * @throws InvalidArgumentException
  429. *
  430. * @return void
  431. */
  432. public static function nullOrBoolean($value, $message = '')
  433. {
  434. null === $value || static::boolean($value, $message);
  435. }
  436. /**
  437. * @psalm-pure
  438. * @psalm-assert iterable<bool> $value
  439. *
  440. * @param mixed $value
  441. * @param string $message
  442. *
  443. * @throws InvalidArgumentException
  444. *
  445. * @return void
  446. */
  447. public static function allBoolean($value, $message = '')
  448. {
  449. static::isIterable($value);
  450. foreach ($value as $entry) {
  451. static::boolean($entry, $message);
  452. }
  453. }
  454. /**
  455. * @psalm-pure
  456. * @psalm-assert iterable<bool|null> $value
  457. *
  458. * @param mixed $value
  459. * @param string $message
  460. *
  461. * @throws InvalidArgumentException
  462. *
  463. * @return void
  464. */
  465. public static function allNullOrBoolean($value, $message = '')
  466. {
  467. static::isIterable($value);
  468. foreach ($value as $entry) {
  469. null === $entry || static::boolean($entry, $message);
  470. }
  471. }
  472. /**
  473. * @psalm-pure
  474. * @psalm-assert scalar|null $value
  475. *
  476. * @param mixed $value
  477. * @param string $message
  478. *
  479. * @throws InvalidArgumentException
  480. *
  481. * @return void
  482. */
  483. public static function nullOrScalar($value, $message = '')
  484. {
  485. null === $value || static::scalar($value, $message);
  486. }
  487. /**
  488. * @psalm-pure
  489. * @psalm-assert iterable<scalar> $value
  490. *
  491. * @param mixed $value
  492. * @param string $message
  493. *
  494. * @throws InvalidArgumentException
  495. *
  496. * @return void
  497. */
  498. public static function allScalar($value, $message = '')
  499. {
  500. static::isIterable($value);
  501. foreach ($value as $entry) {
  502. static::scalar($entry, $message);
  503. }
  504. }
  505. /**
  506. * @psalm-pure
  507. * @psalm-assert iterable<scalar|null> $value
  508. *
  509. * @param mixed $value
  510. * @param string $message
  511. *
  512. * @throws InvalidArgumentException
  513. *
  514. * @return void
  515. */
  516. public static function allNullOrScalar($value, $message = '')
  517. {
  518. static::isIterable($value);
  519. foreach ($value as $entry) {
  520. null === $entry || static::scalar($entry, $message);
  521. }
  522. }
  523. /**
  524. * @psalm-pure
  525. * @psalm-assert object|null $value
  526. *
  527. * @param mixed $value
  528. * @param string $message
  529. *
  530. * @throws InvalidArgumentException
  531. *
  532. * @return void
  533. */
  534. public static function nullOrObject($value, $message = '')
  535. {
  536. null === $value || static::object($value, $message);
  537. }
  538. /**
  539. * @psalm-pure
  540. * @psalm-assert iterable<object> $value
  541. *
  542. * @param mixed $value
  543. * @param string $message
  544. *
  545. * @throws InvalidArgumentException
  546. *
  547. * @return void
  548. */
  549. public static function allObject($value, $message = '')
  550. {
  551. static::isIterable($value);
  552. foreach ($value as $entry) {
  553. static::object($entry, $message);
  554. }
  555. }
  556. /**
  557. * @psalm-pure
  558. * @psalm-assert iterable<object|null> $value
  559. *
  560. * @param mixed $value
  561. * @param string $message
  562. *
  563. * @throws InvalidArgumentException
  564. *
  565. * @return void
  566. */
  567. public static function allNullOrObject($value, $message = '')
  568. {
  569. static::isIterable($value);
  570. foreach ($value as $entry) {
  571. null === $entry || static::object($entry, $message);
  572. }
  573. }
  574. /**
  575. * @psalm-pure
  576. * @psalm-assert resource|null $value
  577. *
  578. * @param mixed $value
  579. * @param string|null $type type of resource this should be. @see https://www.php.net/manual/en/function.get-resource-type.php
  580. * @param string $message
  581. *
  582. * @throws InvalidArgumentException
  583. *
  584. * @return void
  585. */
  586. public static function nullOrResource($value, $type = null, $message = '')
  587. {
  588. null === $value || static::resource($value, $type, $message);
  589. }
  590. /**
  591. * @psalm-pure
  592. * @psalm-assert iterable<resource> $value
  593. *
  594. * @param mixed $value
  595. * @param string|null $type type of resource this should be. @see https://www.php.net/manual/en/function.get-resource-type.php
  596. * @param string $message
  597. *
  598. * @throws InvalidArgumentException
  599. *
  600. * @return void
  601. */
  602. public static function allResource($value, $type = null, $message = '')
  603. {
  604. static::isIterable($value);
  605. foreach ($value as $entry) {
  606. static::resource($entry, $type, $message);
  607. }
  608. }
  609. /**
  610. * @psalm-pure
  611. * @psalm-assert iterable<resource|null> $value
  612. *
  613. * @param mixed $value
  614. * @param string|null $type type of resource this should be. @see https://www.php.net/manual/en/function.get-resource-type.php
  615. * @param string $message
  616. *
  617. * @throws InvalidArgumentException
  618. *
  619. * @return void
  620. */
  621. public static function allNullOrResource($value, $type = null, $message = '')
  622. {
  623. static::isIterable($value);
  624. foreach ($value as $entry) {
  625. null === $entry || static::resource($entry, $type, $message);
  626. }
  627. }
  628. /**
  629. * @psalm-pure
  630. * @psalm-assert callable|null $value
  631. *
  632. * @param mixed $value
  633. * @param string $message
  634. *
  635. * @throws InvalidArgumentException
  636. *
  637. * @return void
  638. */
  639. public static function nullOrIsCallable($value, $message = '')
  640. {
  641. null === $value || static::isCallable($value, $message);
  642. }
  643. /**
  644. * @psalm-pure
  645. * @psalm-assert iterable<callable> $value
  646. *
  647. * @param mixed $value
  648. * @param string $message
  649. *
  650. * @throws InvalidArgumentException
  651. *
  652. * @return void
  653. */
  654. public static function allIsCallable($value, $message = '')
  655. {
  656. static::isIterable($value);
  657. foreach ($value as $entry) {
  658. static::isCallable($entry, $message);
  659. }
  660. }
  661. /**
  662. * @psalm-pure
  663. * @psalm-assert iterable<callable|null> $value
  664. *
  665. * @param mixed $value
  666. * @param string $message
  667. *
  668. * @throws InvalidArgumentException
  669. *
  670. * @return void
  671. */
  672. public static function allNullOrIsCallable($value, $message = '')
  673. {
  674. static::isIterable($value);
  675. foreach ($value as $entry) {
  676. null === $entry || static::isCallable($entry, $message);
  677. }
  678. }
  679. /**
  680. * @psalm-pure
  681. * @psalm-assert array|null $value
  682. *
  683. * @param mixed $value
  684. * @param string $message
  685. *
  686. * @throws InvalidArgumentException
  687. *
  688. * @return void
  689. */
  690. public static function nullOrIsArray($value, $message = '')
  691. {
  692. null === $value || static::isArray($value, $message);
  693. }
  694. /**
  695. * @psalm-pure
  696. * @psalm-assert iterable<array> $value
  697. *
  698. * @param mixed $value
  699. * @param string $message
  700. *
  701. * @throws InvalidArgumentException
  702. *
  703. * @return void
  704. */
  705. public static function allIsArray($value, $message = '')
  706. {
  707. static::isIterable($value);
  708. foreach ($value as $entry) {
  709. static::isArray($entry, $message);
  710. }
  711. }
  712. /**
  713. * @psalm-pure
  714. * @psalm-assert iterable<array|null> $value
  715. *
  716. * @param mixed $value
  717. * @param string $message
  718. *
  719. * @throws InvalidArgumentException
  720. *
  721. * @return void
  722. */
  723. public static function allNullOrIsArray($value, $message = '')
  724. {
  725. static::isIterable($value);
  726. foreach ($value as $entry) {
  727. null === $entry || static::isArray($entry, $message);
  728. }
  729. }
  730. /**
  731. * @psalm-pure
  732. * @psalm-assert iterable|null $value
  733. *
  734. * @deprecated use "isIterable" or "isInstanceOf" instead
  735. *
  736. * @param mixed $value
  737. * @param string $message
  738. *
  739. * @throws InvalidArgumentException
  740. *
  741. * @return void
  742. */
  743. public static function nullOrIsTraversable($value, $message = '')
  744. {
  745. null === $value || static::isTraversable($value, $message);
  746. }
  747. /**
  748. * @psalm-pure
  749. * @psalm-assert iterable<iterable> $value
  750. *
  751. * @deprecated use "isIterable" or "isInstanceOf" instead
  752. *
  753. * @param mixed $value
  754. * @param string $message
  755. *
  756. * @throws InvalidArgumentException
  757. *
  758. * @return void
  759. */
  760. public static function allIsTraversable($value, $message = '')
  761. {
  762. static::isIterable($value);
  763. foreach ($value as $entry) {
  764. static::isTraversable($entry, $message);
  765. }
  766. }
  767. /**
  768. * @psalm-pure
  769. * @psalm-assert iterable<iterable|null> $value
  770. *
  771. * @deprecated use "isIterable" or "isInstanceOf" instead
  772. *
  773. * @param mixed $value
  774. * @param string $message
  775. *
  776. * @throws InvalidArgumentException
  777. *
  778. * @return void
  779. */
  780. public static function allNullOrIsTraversable($value, $message = '')
  781. {
  782. static::isIterable($value);
  783. foreach ($value as $entry) {
  784. null === $entry || static::isTraversable($entry, $message);
  785. }
  786. }
  787. /**
  788. * @psalm-pure
  789. * @psalm-assert array|ArrayAccess|null $value
  790. *
  791. * @param mixed $value
  792. * @param string $message
  793. *
  794. * @throws InvalidArgumentException
  795. *
  796. * @return void
  797. */
  798. public static function nullOrIsArrayAccessible($value, $message = '')
  799. {
  800. null === $value || static::isArrayAccessible($value, $message);
  801. }
  802. /**
  803. * @psalm-pure
  804. * @psalm-assert iterable<array|ArrayAccess> $value
  805. *
  806. * @param mixed $value
  807. * @param string $message
  808. *
  809. * @throws InvalidArgumentException
  810. *
  811. * @return void
  812. */
  813. public static function allIsArrayAccessible($value, $message = '')
  814. {
  815. static::isIterable($value);
  816. foreach ($value as $entry) {
  817. static::isArrayAccessible($entry, $message);
  818. }
  819. }
  820. /**
  821. * @psalm-pure
  822. * @psalm-assert iterable<array|ArrayAccess|null> $value
  823. *
  824. * @param mixed $value
  825. * @param string $message
  826. *
  827. * @throws InvalidArgumentException
  828. *
  829. * @return void
  830. */
  831. public static function allNullOrIsArrayAccessible($value, $message = '')
  832. {
  833. static::isIterable($value);
  834. foreach ($value as $entry) {
  835. null === $entry || static::isArrayAccessible($entry, $message);
  836. }
  837. }
  838. /**
  839. * @psalm-pure
  840. * @psalm-assert countable|null $value
  841. *
  842. * @param mixed $value
  843. * @param string $message
  844. *
  845. * @throws InvalidArgumentException
  846. *
  847. * @return void
  848. */
  849. public static function nullOrIsCountable($value, $message = '')
  850. {
  851. null === $value || static::isCountable($value, $message);
  852. }
  853. /**
  854. * @psalm-pure
  855. * @psalm-assert iterable<countable> $value
  856. *
  857. * @param mixed $value
  858. * @param string $message
  859. *
  860. * @throws InvalidArgumentException
  861. *
  862. * @return void
  863. */
  864. public static function allIsCountable($value, $message = '')
  865. {
  866. static::isIterable($value);
  867. foreach ($value as $entry) {
  868. static::isCountable($entry, $message);
  869. }
  870. }
  871. /**
  872. * @psalm-pure
  873. * @psalm-assert iterable<countable|null> $value
  874. *
  875. * @param mixed $value
  876. * @param string $message
  877. *
  878. * @throws InvalidArgumentException
  879. *
  880. * @return void
  881. */
  882. public static function allNullOrIsCountable($value, $message = '')
  883. {
  884. static::isIterable($value);
  885. foreach ($value as $entry) {
  886. null === $entry || static::isCountable($entry, $message);
  887. }
  888. }
  889. /**
  890. * @psalm-pure
  891. * @psalm-assert iterable|null $value
  892. *
  893. * @param mixed $value
  894. * @param string $message
  895. *
  896. * @throws InvalidArgumentException
  897. *
  898. * @return void
  899. */
  900. public static function nullOrIsIterable($value, $message = '')
  901. {
  902. null === $value || static::isIterable($value, $message);
  903. }
  904. /**
  905. * @psalm-pure
  906. * @psalm-assert iterable<iterable> $value
  907. *
  908. * @param mixed $value
  909. * @param string $message
  910. *
  911. * @throws InvalidArgumentException
  912. *
  913. * @return void
  914. */
  915. public static function allIsIterable($value, $message = '')
  916. {
  917. static::isIterable($value);
  918. foreach ($value as $entry) {
  919. static::isIterable($entry, $message);
  920. }
  921. }
  922. /**
  923. * @psalm-pure
  924. * @psalm-assert iterable<iterable|null> $value
  925. *
  926. * @param mixed $value
  927. * @param string $message
  928. *
  929. * @throws InvalidArgumentException
  930. *
  931. * @return void
  932. */
  933. public static function allNullOrIsIterable($value, $message = '')
  934. {
  935. static::isIterable($value);
  936. foreach ($value as $entry) {
  937. null === $entry || static::isIterable($entry, $message);
  938. }
  939. }
  940. /**
  941. * @psalm-pure
  942. * @psalm-template ExpectedType of object
  943. * @psalm-param class-string<ExpectedType> $class
  944. * @psalm-assert ExpectedType|null $value
  945. *
  946. * @param mixed $value
  947. * @param string|object $class
  948. * @param string $message
  949. *
  950. * @throws InvalidArgumentException
  951. *
  952. * @return void
  953. */
  954. public static function nullOrIsInstanceOf($value, $class, $message = '')
  955. {
  956. null === $value || static::isInstanceOf($value, $class, $message);
  957. }
  958. /**
  959. * @psalm-pure
  960. * @psalm-template ExpectedType of object
  961. * @psalm-param class-string<ExpectedType> $class
  962. * @psalm-assert iterable<ExpectedType> $value
  963. *
  964. * @param mixed $value
  965. * @param string|object $class
  966. * @param string $message
  967. *
  968. * @throws InvalidArgumentException
  969. *
  970. * @return void
  971. */
  972. public static function allIsInstanceOf($value, $class, $message = '')
  973. {
  974. static::isIterable($value);
  975. foreach ($value as $entry) {
  976. static::isInstanceOf($entry, $class, $message);
  977. }
  978. }
  979. /**
  980. * @psalm-pure
  981. * @psalm-template ExpectedType of object
  982. * @psalm-param class-string<ExpectedType> $class
  983. * @psalm-assert iterable<ExpectedType|null> $value
  984. *
  985. * @param mixed $value
  986. * @param string|object $class
  987. * @param string $message
  988. *
  989. * @throws InvalidArgumentException
  990. *
  991. * @return void
  992. */
  993. public static function allNullOrIsInstanceOf($value, $class, $message = '')
  994. {
  995. static::isIterable($value);
  996. foreach ($value as $entry) {
  997. null === $entry || static::isInstanceOf($entry, $class, $message);
  998. }
  999. }
  1000. /**
  1001. * @psalm-pure
  1002. * @psalm-template ExpectedType of object
  1003. * @psalm-param class-string<ExpectedType> $class
  1004. *
  1005. * @param mixed $value
  1006. * @param string|object $class
  1007. * @param string $message
  1008. *
  1009. * @throws InvalidArgumentException
  1010. *
  1011. * @return void
  1012. */
  1013. public static function nullOrNotInstanceOf($value, $class, $message = '')
  1014. {
  1015. null === $value || static::notInstanceOf($value, $class, $message);
  1016. }
  1017. /**
  1018. * @psalm-pure
  1019. * @psalm-template ExpectedType of object
  1020. * @psalm-param class-string<ExpectedType> $class
  1021. *
  1022. * @param mixed $value
  1023. * @param string|object $class
  1024. * @param string $message
  1025. *
  1026. * @throws InvalidArgumentException
  1027. *
  1028. * @return void
  1029. */
  1030. public static function allNotInstanceOf($value, $class, $message = '')
  1031. {
  1032. static::isIterable($value);
  1033. foreach ($value as $entry) {
  1034. static::notInstanceOf($entry, $class, $message);
  1035. }
  1036. }
  1037. /**
  1038. * @psalm-pure
  1039. * @psalm-template ExpectedType of object
  1040. * @psalm-param class-string<ExpectedType> $class
  1041. * @psalm-assert iterable<!ExpectedType|null> $value
  1042. *
  1043. * @param mixed $value
  1044. * @param string|object $class
  1045. * @param string $message
  1046. *
  1047. * @throws InvalidArgumentException
  1048. *
  1049. * @return void
  1050. */
  1051. public static function allNullOrNotInstanceOf($value, $class, $message = '')
  1052. {
  1053. static::isIterable($value);
  1054. foreach ($value as $entry) {
  1055. null === $entry || static::notInstanceOf($entry, $class, $message);
  1056. }
  1057. }
  1058. /**
  1059. * @psalm-pure
  1060. * @psalm-param array<class-string> $classes
  1061. *
  1062. * @param mixed $value
  1063. * @param array<object|string> $classes
  1064. * @param string $message
  1065. *
  1066. * @throws InvalidArgumentException
  1067. *
  1068. * @return void
  1069. */
  1070. public static function nullOrIsInstanceOfAny($value, $classes, $message = '')
  1071. {
  1072. null === $value || static::isInstanceOfAny($value, $classes, $message);
  1073. }
  1074. /**
  1075. * @psalm-pure
  1076. * @psalm-param array<class-string> $classes
  1077. *
  1078. * @param mixed $value
  1079. * @param array<object|string> $classes
  1080. * @param string $message
  1081. *
  1082. * @throws InvalidArgumentException
  1083. *
  1084. * @return void
  1085. */
  1086. public static function allIsInstanceOfAny($value, $classes, $message = '')
  1087. {
  1088. static::isIterable($value);
  1089. foreach ($value as $entry) {
  1090. static::isInstanceOfAny($entry, $classes, $message);
  1091. }
  1092. }
  1093. /**
  1094. * @psalm-pure
  1095. * @psalm-param array<class-string> $classes
  1096. *
  1097. * @param mixed $value
  1098. * @param array<object|string> $classes
  1099. * @param string $message
  1100. *
  1101. * @throws InvalidArgumentException
  1102. *
  1103. * @return void
  1104. */
  1105. public static function allNullOrIsInstanceOfAny($value, $classes, $message = '')
  1106. {
  1107. static::isIterable($value);
  1108. foreach ($value as $entry) {
  1109. null === $entry || static::isInstanceOfAny($entry, $classes, $message);
  1110. }
  1111. }
  1112. /**
  1113. * @psalm-pure
  1114. * @psalm-template ExpectedType of object
  1115. * @psalm-param class-string<ExpectedType> $class
  1116. * @psalm-assert ExpectedType|class-string<ExpectedType>|null $value
  1117. *
  1118. * @param object|string|null $value
  1119. * @param string $class
  1120. * @param string $message
  1121. *
  1122. * @throws InvalidArgumentException
  1123. *
  1124. * @return void
  1125. */
  1126. public static function nullOrIsAOf($value, $class, $message = '')
  1127. {
  1128. null === $value || static::isAOf($value, $class, $message);
  1129. }
  1130. /**
  1131. * @psalm-pure
  1132. * @psalm-template ExpectedType of object
  1133. * @psalm-param class-string<ExpectedType> $class
  1134. * @psalm-assert iterable<ExpectedType|class-string<ExpectedType>> $value
  1135. *
  1136. * @param iterable<object|string> $value
  1137. * @param string $class
  1138. * @param string $message
  1139. *
  1140. * @throws InvalidArgumentException
  1141. *
  1142. * @return void
  1143. */
  1144. public static function allIsAOf($value, $class, $message = '')
  1145. {
  1146. static::isIterable($value);
  1147. foreach ($value as $entry) {
  1148. static::isAOf($entry, $class, $message);
  1149. }
  1150. }
  1151. /**
  1152. * @psalm-pure
  1153. * @psalm-template ExpectedType of object
  1154. * @psalm-param class-string<ExpectedType> $class
  1155. * @psalm-assert iterable<ExpectedType|class-string<ExpectedType>|null> $value
  1156. *
  1157. * @param iterable<object|string|null> $value
  1158. * @param string $class
  1159. * @param string $message
  1160. *
  1161. * @throws InvalidArgumentException
  1162. *
  1163. * @return void
  1164. */
  1165. public static function allNullOrIsAOf($value, $class, $message = '')
  1166. {
  1167. static::isIterable($value);
  1168. foreach ($value as $entry) {
  1169. null === $entry || static::isAOf($entry, $class, $message);
  1170. }
  1171. }
  1172. /**
  1173. * @psalm-pure
  1174. * @psalm-template UnexpectedType of object
  1175. * @psalm-param class-string<UnexpectedType> $class
  1176. *
  1177. * @param object|string|null $value
  1178. * @param string $class
  1179. * @param string $message
  1180. *
  1181. * @throws InvalidArgumentException
  1182. *
  1183. * @return void
  1184. */
  1185. public static function nullOrIsNotA($value, $class, $message = '')
  1186. {
  1187. null === $value || static::isNotA($value, $class, $message);
  1188. }
  1189. /**
  1190. * @psalm-pure
  1191. * @psalm-template UnexpectedType of object
  1192. * @psalm-param class-string<UnexpectedType> $class
  1193. *
  1194. * @param iterable<object|string> $value
  1195. * @param string $class
  1196. * @param string $message
  1197. *
  1198. * @throws InvalidArgumentException
  1199. *
  1200. * @return void
  1201. */
  1202. public static function allIsNotA($value, $class, $message = '')
  1203. {
  1204. static::isIterable($value);
  1205. foreach ($value as $entry) {
  1206. static::isNotA($entry, $class, $message);
  1207. }
  1208. }
  1209. /**
  1210. * @psalm-pure
  1211. * @psalm-template UnexpectedType of object
  1212. * @psalm-param class-string<UnexpectedType> $class
  1213. * @psalm-assert iterable<!UnexpectedType|null> $value
  1214. * @psalm-assert iterable<!class-string<UnexpectedType>|null> $value
  1215. *
  1216. * @param iterable<object|string|null> $value
  1217. * @param string $class
  1218. * @param string $message
  1219. *
  1220. * @throws InvalidArgumentException
  1221. *
  1222. * @return void
  1223. */
  1224. public static function allNullOrIsNotA($value, $class, $message = '')
  1225. {
  1226. static::isIterable($value);
  1227. foreach ($value as $entry) {
  1228. null === $entry || static::isNotA($entry, $class, $message);
  1229. }
  1230. }
  1231. /**
  1232. * @psalm-pure
  1233. * @psalm-param array<class-string> $classes
  1234. *
  1235. * @param object|string|null $value
  1236. * @param string[] $classes
  1237. * @param string $message
  1238. *
  1239. * @throws InvalidArgumentException
  1240. *
  1241. * @return void
  1242. */
  1243. public static function nullOrIsAnyOf($value, $classes, $message = '')
  1244. {
  1245. null === $value || static::isAnyOf($value, $classes, $message);
  1246. }
  1247. /**
  1248. * @psalm-pure
  1249. * @psalm-param array<class-string> $classes
  1250. *
  1251. * @param iterable<object|string> $value
  1252. * @param string[] $classes
  1253. * @param string $message
  1254. *
  1255. * @throws InvalidArgumentException
  1256. *
  1257. * @return void
  1258. */
  1259. public static function allIsAnyOf($value, $classes, $message = '')
  1260. {
  1261. static::isIterable($value);
  1262. foreach ($value as $entry) {
  1263. static::isAnyOf($entry, $classes, $message);
  1264. }
  1265. }
  1266. /**
  1267. * @psalm-pure
  1268. * @psalm-param array<class-string> $classes
  1269. *
  1270. * @param iterable<object|string|null> $value
  1271. * @param string[] $classes
  1272. * @param string $message
  1273. *
  1274. * @throws InvalidArgumentException
  1275. *
  1276. * @return void
  1277. */
  1278. public static function allNullOrIsAnyOf($value, $classes, $message = '')
  1279. {
  1280. static::isIterable($value);
  1281. foreach ($value as $entry) {
  1282. null === $entry || static::isAnyOf($entry, $classes, $message);
  1283. }
  1284. }
  1285. /**
  1286. * @psalm-pure
  1287. * @psalm-assert empty $value
  1288. *
  1289. * @param mixed $value
  1290. * @param string $message
  1291. *
  1292. * @throws InvalidArgumentException
  1293. *
  1294. * @return void
  1295. */
  1296. public static function nullOrIsEmpty($value, $message = '')
  1297. {
  1298. null === $value || static::isEmpty($value, $message);
  1299. }
  1300. /**
  1301. * @psalm-pure
  1302. * @psalm-assert iterable<empty> $value
  1303. *
  1304. * @param mixed $value
  1305. * @param string $message
  1306. *
  1307. * @throws InvalidArgumentException
  1308. *
  1309. * @return void
  1310. */
  1311. public static function allIsEmpty($value, $message = '')
  1312. {
  1313. static::isIterable($value);
  1314. foreach ($value as $entry) {
  1315. static::isEmpty($entry, $message);
  1316. }
  1317. }
  1318. /**
  1319. * @psalm-pure
  1320. * @psalm-assert iterable<empty|null> $value
  1321. *
  1322. * @param mixed $value
  1323. * @param string $message
  1324. *
  1325. * @throws InvalidArgumentException
  1326. *
  1327. * @return void
  1328. */
  1329. public static function allNullOrIsEmpty($value, $message = '')
  1330. {
  1331. static::isIterable($value);
  1332. foreach ($value as $entry) {
  1333. null === $entry || static::isEmpty($entry, $message);
  1334. }
  1335. }
  1336. /**
  1337. * @psalm-pure
  1338. *
  1339. * @param mixed $value
  1340. * @param string $message
  1341. *
  1342. * @throws InvalidArgumentException
  1343. *
  1344. * @return void
  1345. */
  1346. public static function nullOrNotEmpty($value, $message = '')
  1347. {
  1348. null === $value || static::notEmpty($value, $message);
  1349. }
  1350. /**
  1351. * @psalm-pure
  1352. *
  1353. * @param mixed $value
  1354. * @param string $message
  1355. *
  1356. * @throws InvalidArgumentException
  1357. *
  1358. * @return void
  1359. */
  1360. public static function allNotEmpty($value, $message = '')
  1361. {
  1362. static::isIterable($value);
  1363. foreach ($value as $entry) {
  1364. static::notEmpty($entry, $message);
  1365. }
  1366. }
  1367. /**
  1368. * @psalm-pure
  1369. * @psalm-assert iterable<!empty|null> $value
  1370. *
  1371. * @param mixed $value
  1372. * @param string $message
  1373. *
  1374. * @throws InvalidArgumentException
  1375. *
  1376. * @return void
  1377. */
  1378. public static function allNullOrNotEmpty($value, $message = '')
  1379. {
  1380. static::isIterable($value);
  1381. foreach ($value as $entry) {
  1382. null === $entry || static::notEmpty($entry, $message);
  1383. }
  1384. }
  1385. /**
  1386. * @psalm-pure
  1387. * @psalm-assert iterable<null> $value
  1388. *
  1389. * @param mixed $value
  1390. * @param string $message
  1391. *
  1392. * @throws InvalidArgumentException
  1393. *
  1394. * @return void
  1395. */
  1396. public static function allNull($value, $message = '')
  1397. {
  1398. static::isIterable($value);
  1399. foreach ($value as $entry) {
  1400. static::null($entry, $message);
  1401. }
  1402. }
  1403. /**
  1404. * @psalm-pure
  1405. *
  1406. * @param mixed $value
  1407. * @param string $message
  1408. *
  1409. * @throws InvalidArgumentException
  1410. *
  1411. * @return void
  1412. */
  1413. public static function allNotNull($value, $message = '')
  1414. {
  1415. static::isIterable($value);
  1416. foreach ($value as $entry) {
  1417. static::notNull($entry, $message);
  1418. }
  1419. }
  1420. /**
  1421. * @psalm-pure
  1422. * @psalm-assert true|null $value
  1423. *
  1424. * @param mixed $value
  1425. * @param string $message
  1426. *
  1427. * @throws InvalidArgumentException
  1428. *
  1429. * @return void
  1430. */
  1431. public static function nullOrTrue($value, $message = '')
  1432. {
  1433. null === $value || static::true($value, $message);
  1434. }
  1435. /**
  1436. * @psalm-pure
  1437. * @psalm-assert iterable<true> $value
  1438. *
  1439. * @param mixed $value
  1440. * @param string $message
  1441. *
  1442. * @throws InvalidArgumentException
  1443. *
  1444. * @return void
  1445. */
  1446. public static function allTrue($value, $message = '')
  1447. {
  1448. static::isIterable($value);
  1449. foreach ($value as $entry) {
  1450. static::true($entry, $message);
  1451. }
  1452. }
  1453. /**
  1454. * @psalm-pure
  1455. * @psalm-assert iterable<true|null> $value
  1456. *
  1457. * @param mixed $value
  1458. * @param string $message
  1459. *
  1460. * @throws InvalidArgumentException
  1461. *
  1462. * @return void
  1463. */
  1464. public static function allNullOrTrue($value, $message = '')
  1465. {
  1466. static::isIterable($value);
  1467. foreach ($value as $entry) {
  1468. null === $entry || static::true($entry, $message);
  1469. }
  1470. }
  1471. /**
  1472. * @psalm-pure
  1473. * @psalm-assert false|null $value
  1474. *
  1475. * @param mixed $value
  1476. * @param string $message
  1477. *
  1478. * @throws InvalidArgumentException
  1479. *
  1480. * @return void
  1481. */
  1482. public static function nullOrFalse($value, $message = '')
  1483. {
  1484. null === $value || static::false($value, $message);
  1485. }
  1486. /**
  1487. * @psalm-pure
  1488. * @psalm-assert iterable<false> $value
  1489. *
  1490. * @param mixed $value
  1491. * @param string $message
  1492. *
  1493. * @throws InvalidArgumentException
  1494. *
  1495. * @return void
  1496. */
  1497. public static function allFalse($value, $message = '')
  1498. {
  1499. static::isIterable($value);
  1500. foreach ($value as $entry) {
  1501. static::false($entry, $message);
  1502. }
  1503. }
  1504. /**
  1505. * @psalm-pure
  1506. * @psalm-assert iterable<false|null> $value
  1507. *
  1508. * @param mixed $value
  1509. * @param string $message
  1510. *
  1511. * @throws InvalidArgumentException
  1512. *
  1513. * @return void
  1514. */
  1515. public static function allNullOrFalse($value, $message = '')
  1516. {
  1517. static::isIterable($value);
  1518. foreach ($value as $entry) {
  1519. null === $entry || static::false($entry, $message);
  1520. }
  1521. }
  1522. /**
  1523. * @psalm-pure
  1524. *
  1525. * @param mixed $value
  1526. * @param string $message
  1527. *
  1528. * @throws InvalidArgumentException
  1529. *
  1530. * @return void
  1531. */
  1532. public static function nullOrNotFalse($value, $message = '')
  1533. {
  1534. null === $value || static::notFalse($value, $message);
  1535. }
  1536. /**
  1537. * @psalm-pure
  1538. *
  1539. * @param mixed $value
  1540. * @param string $message
  1541. *
  1542. * @throws InvalidArgumentException
  1543. *
  1544. * @return void
  1545. */
  1546. public static function allNotFalse($value, $message = '')
  1547. {
  1548. static::isIterable($value);
  1549. foreach ($value as $entry) {
  1550. static::notFalse($entry, $message);
  1551. }
  1552. }
  1553. /**
  1554. * @psalm-pure
  1555. * @psalm-assert iterable<!false|null> $value
  1556. *
  1557. * @param mixed $value
  1558. * @param string $message
  1559. *
  1560. * @throws InvalidArgumentException
  1561. *
  1562. * @return void
  1563. */
  1564. public static function allNullOrNotFalse($value, $message = '')
  1565. {
  1566. static::isIterable($value);
  1567. foreach ($value as $entry) {
  1568. null === $entry || static::notFalse($entry, $message);
  1569. }
  1570. }
  1571. /**
  1572. * @param mixed $value
  1573. * @param string $message
  1574. *
  1575. * @throws InvalidArgumentException
  1576. *
  1577. * @return void
  1578. */
  1579. public static function nullOrIp($value, $message = '')
  1580. {
  1581. null === $value || static::ip($value, $message);
  1582. }
  1583. /**
  1584. * @param mixed $value
  1585. * @param string $message
  1586. *
  1587. * @throws InvalidArgumentException
  1588. *
  1589. * @return void
  1590. */
  1591. public static function allIp($value, $message = '')
  1592. {
  1593. static::isIterable($value);
  1594. foreach ($value as $entry) {
  1595. static::ip($entry, $message);
  1596. }
  1597. }
  1598. /**
  1599. * @param mixed $value
  1600. * @param string $message
  1601. *
  1602. * @throws InvalidArgumentException
  1603. *
  1604. * @return void
  1605. */
  1606. public static function allNullOrIp($value, $message = '')
  1607. {
  1608. static::isIterable($value);
  1609. foreach ($value as $entry) {
  1610. null === $entry || static::ip($entry, $message);
  1611. }
  1612. }
  1613. /**
  1614. * @param mixed $value
  1615. * @param string $message
  1616. *
  1617. * @throws InvalidArgumentException
  1618. *
  1619. * @return void
  1620. */
  1621. public static function nullOrIpv4($value, $message = '')
  1622. {
  1623. null === $value || static::ipv4($value, $message);
  1624. }
  1625. /**
  1626. * @param mixed $value
  1627. * @param string $message
  1628. *
  1629. * @throws InvalidArgumentException
  1630. *
  1631. * @return void
  1632. */
  1633. public static function allIpv4($value, $message = '')
  1634. {
  1635. static::isIterable($value);
  1636. foreach ($value as $entry) {
  1637. static::ipv4($entry, $message);
  1638. }
  1639. }
  1640. /**
  1641. * @param mixed $value
  1642. * @param string $message
  1643. *
  1644. * @throws InvalidArgumentException
  1645. *
  1646. * @return void
  1647. */
  1648. public static function allNullOrIpv4($value, $message = '')
  1649. {
  1650. static::isIterable($value);
  1651. foreach ($value as $entry) {
  1652. null === $entry || static::ipv4($entry, $message);
  1653. }
  1654. }
  1655. /**
  1656. * @param mixed $value
  1657. * @param string $message
  1658. *
  1659. * @throws InvalidArgumentException
  1660. *
  1661. * @return void
  1662. */
  1663. public static function nullOrIpv6($value, $message = '')
  1664. {
  1665. null === $value || static::ipv6($value, $message);
  1666. }
  1667. /**
  1668. * @param mixed $value
  1669. * @param string $message
  1670. *
  1671. * @throws InvalidArgumentException
  1672. *
  1673. * @return void
  1674. */
  1675. public static function allIpv6($value, $message = '')
  1676. {
  1677. static::isIterable($value);
  1678. foreach ($value as $entry) {
  1679. static::ipv6($entry, $message);
  1680. }
  1681. }
  1682. /**
  1683. * @param mixed $value
  1684. * @param string $message
  1685. *
  1686. * @throws InvalidArgumentException
  1687. *
  1688. * @return void
  1689. */
  1690. public static function allNullOrIpv6($value, $message = '')
  1691. {
  1692. static::isIterable($value);
  1693. foreach ($value as $entry) {
  1694. null === $entry || static::ipv6($entry, $message);
  1695. }
  1696. }
  1697. /**
  1698. * @param mixed $value
  1699. * @param string $message
  1700. *
  1701. * @throws InvalidArgumentException
  1702. *
  1703. * @return void
  1704. */
  1705. public static function nullOrEmail($value, $message = '')
  1706. {
  1707. null === $value || static::email($value, $message);
  1708. }
  1709. /**
  1710. * @param mixed $value
  1711. * @param string $message
  1712. *
  1713. * @throws InvalidArgumentException
  1714. *
  1715. * @return void
  1716. */
  1717. public static function allEmail($value, $message = '')
  1718. {
  1719. static::isIterable($value);
  1720. foreach ($value as $entry) {
  1721. static::email($entry, $message);
  1722. }
  1723. }
  1724. /**
  1725. * @param mixed $value
  1726. * @param string $message
  1727. *
  1728. * @throws InvalidArgumentException
  1729. *
  1730. * @return void
  1731. */
  1732. public static function allNullOrEmail($value, $message = '')
  1733. {
  1734. static::isIterable($value);
  1735. foreach ($value as $entry) {
  1736. null === $entry || static::email($entry, $message);
  1737. }
  1738. }
  1739. /**
  1740. * @param array|null $values
  1741. * @param string $message
  1742. *
  1743. * @throws InvalidArgumentException
  1744. *
  1745. * @return void
  1746. */
  1747. public static function nullOrUniqueValues($values, $message = '')
  1748. {
  1749. null === $values || static::uniqueValues($values, $message);
  1750. }
  1751. /**
  1752. * @param iterable<array> $values
  1753. * @param string $message
  1754. *
  1755. * @throws InvalidArgumentException
  1756. *
  1757. * @return void
  1758. */
  1759. public static function allUniqueValues($values, $message = '')
  1760. {
  1761. static::isIterable($values);
  1762. foreach ($values as $entry) {
  1763. static::uniqueValues($entry, $message);
  1764. }
  1765. }
  1766. /**
  1767. * @param iterable<array|null> $values
  1768. * @param string $message
  1769. *
  1770. * @throws InvalidArgumentException
  1771. *
  1772. * @return void
  1773. */
  1774. public static function allNullOrUniqueValues($values, $message = '')
  1775. {
  1776. static::isIterable($values);
  1777. foreach ($values as $entry) {
  1778. null === $entry || static::uniqueValues($entry, $message);
  1779. }
  1780. }
  1781. /**
  1782. * @param mixed $value
  1783. * @param mixed $expect
  1784. * @param string $message
  1785. *
  1786. * @throws InvalidArgumentException
  1787. *
  1788. * @return void
  1789. */
  1790. public static function nullOrEq($value, $expect, $message = '')
  1791. {
  1792. null === $value || static::eq($value, $expect, $message);
  1793. }
  1794. /**
  1795. * @param mixed $value
  1796. * @param mixed $expect
  1797. * @param string $message
  1798. *
  1799. * @throws InvalidArgumentException
  1800. *
  1801. * @return void
  1802. */
  1803. public static function allEq($value, $expect, $message = '')
  1804. {
  1805. static::isIterable($value);
  1806. foreach ($value as $entry) {
  1807. static::eq($entry, $expect, $message);
  1808. }
  1809. }
  1810. /**
  1811. * @param mixed $value
  1812. * @param mixed $expect
  1813. * @param string $message
  1814. *
  1815. * @throws InvalidArgumentException
  1816. *
  1817. * @return void
  1818. */
  1819. public static function allNullOrEq($value, $expect, $message = '')
  1820. {
  1821. static::isIterable($value);
  1822. foreach ($value as $entry) {
  1823. null === $entry || static::eq($entry, $expect, $message);
  1824. }
  1825. }
  1826. /**
  1827. * @param mixed $value
  1828. * @param mixed $expect
  1829. * @param string $message
  1830. *
  1831. * @throws InvalidArgumentException
  1832. *
  1833. * @return void
  1834. */
  1835. public static function nullOrNotEq($value, $expect, $message = '')
  1836. {
  1837. null === $value || static::notEq($value, $expect, $message);
  1838. }
  1839. /**
  1840. * @param mixed $value
  1841. * @param mixed $expect
  1842. * @param string $message
  1843. *
  1844. * @throws InvalidArgumentException
  1845. *
  1846. * @return void
  1847. */
  1848. public static function allNotEq($value, $expect, $message = '')
  1849. {
  1850. static::isIterable($value);
  1851. foreach ($value as $entry) {
  1852. static::notEq($entry, $expect, $message);
  1853. }
  1854. }
  1855. /**
  1856. * @param mixed $value
  1857. * @param mixed $expect
  1858. * @param string $message
  1859. *
  1860. * @throws InvalidArgumentException
  1861. *
  1862. * @return void
  1863. */
  1864. public static function allNullOrNotEq($value, $expect, $message = '')
  1865. {
  1866. static::isIterable($value);
  1867. foreach ($value as $entry) {
  1868. null === $entry || static::notEq($entry, $expect, $message);
  1869. }
  1870. }
  1871. /**
  1872. * @psalm-pure
  1873. *
  1874. * @param mixed $value
  1875. * @param mixed $expect
  1876. * @param string $message
  1877. *
  1878. * @throws InvalidArgumentException
  1879. *
  1880. * @return void
  1881. */
  1882. public static function nullOrSame($value, $expect, $message = '')
  1883. {
  1884. null === $value || static::same($value, $expect, $message);
  1885. }
  1886. /**
  1887. * @psalm-pure
  1888. *
  1889. * @param mixed $value
  1890. * @param mixed $expect
  1891. * @param string $message
  1892. *
  1893. * @throws InvalidArgumentException
  1894. *
  1895. * @return void
  1896. */
  1897. public static function allSame($value, $expect, $message = '')
  1898. {
  1899. static::isIterable($value);
  1900. foreach ($value as $entry) {
  1901. static::same($entry, $expect, $message);
  1902. }
  1903. }
  1904. /**
  1905. * @psalm-pure
  1906. *
  1907. * @param mixed $value
  1908. * @param mixed $expect
  1909. * @param string $message
  1910. *
  1911. * @throws InvalidArgumentException
  1912. *
  1913. * @return void
  1914. */
  1915. public static function allNullOrSame($value, $expect, $message = '')
  1916. {
  1917. static::isIterable($value);
  1918. foreach ($value as $entry) {
  1919. null === $entry || static::same($entry, $expect, $message);
  1920. }
  1921. }
  1922. /**
  1923. * @psalm-pure
  1924. *
  1925. * @param mixed $value
  1926. * @param mixed $expect
  1927. * @param string $message
  1928. *
  1929. * @throws InvalidArgumentException
  1930. *
  1931. * @return void
  1932. */
  1933. public static function nullOrNotSame($value, $expect, $message = '')
  1934. {
  1935. null === $value || static::notSame($value, $expect, $message);
  1936. }
  1937. /**
  1938. * @psalm-pure
  1939. *
  1940. * @param mixed $value
  1941. * @param mixed $expect
  1942. * @param string $message
  1943. *
  1944. * @throws InvalidArgumentException
  1945. *
  1946. * @return void
  1947. */
  1948. public static function allNotSame($value, $expect, $message = '')
  1949. {
  1950. static::isIterable($value);
  1951. foreach ($value as $entry) {
  1952. static::notSame($entry, $expect, $message);
  1953. }
  1954. }
  1955. /**
  1956. * @psalm-pure
  1957. *
  1958. * @param mixed $value
  1959. * @param mixed $expect
  1960. * @param string $message
  1961. *
  1962. * @throws InvalidArgumentException
  1963. *
  1964. * @return void
  1965. */
  1966. public static function allNullOrNotSame($value, $expect, $message = '')
  1967. {
  1968. static::isIterable($value);
  1969. foreach ($value as $entry) {
  1970. null === $entry || static::notSame($entry, $expect, $message);
  1971. }
  1972. }
  1973. /**
  1974. * @psalm-pure
  1975. *
  1976. * @param mixed $value
  1977. * @param mixed $limit
  1978. * @param string $message
  1979. *
  1980. * @throws InvalidArgumentException
  1981. *
  1982. * @return void
  1983. */
  1984. public static function nullOrGreaterThan($value, $limit, $message = '')
  1985. {
  1986. null === $value || static::greaterThan($value, $limit, $message);
  1987. }
  1988. /**
  1989. * @psalm-pure
  1990. *
  1991. * @param mixed $value
  1992. * @param mixed $limit
  1993. * @param string $message
  1994. *
  1995. * @throws InvalidArgumentException
  1996. *
  1997. * @return void
  1998. */
  1999. public static function allGreaterThan($value, $limit, $message = '')
  2000. {
  2001. static::isIterable($value);
  2002. foreach ($value as $entry) {
  2003. static::greaterThan($entry, $limit, $message);
  2004. }
  2005. }
  2006. /**
  2007. * @psalm-pure
  2008. *
  2009. * @param mixed $value
  2010. * @param mixed $limit
  2011. * @param string $message
  2012. *
  2013. * @throws InvalidArgumentException
  2014. *
  2015. * @return void
  2016. */
  2017. public static function allNullOrGreaterThan($value, $limit, $message = '')
  2018. {
  2019. static::isIterable($value);
  2020. foreach ($value as $entry) {
  2021. null === $entry || static::greaterThan($entry, $limit, $message);
  2022. }
  2023. }
  2024. /**
  2025. * @psalm-pure
  2026. *
  2027. * @param mixed $value
  2028. * @param mixed $limit
  2029. * @param string $message
  2030. *
  2031. * @throws InvalidArgumentException
  2032. *
  2033. * @return void
  2034. */
  2035. public static function nullOrGreaterThanEq($value, $limit, $message = '')
  2036. {
  2037. null === $value || static::greaterThanEq($value, $limit, $message);
  2038. }
  2039. /**
  2040. * @psalm-pure
  2041. *
  2042. * @param mixed $value
  2043. * @param mixed $limit
  2044. * @param string $message
  2045. *
  2046. * @throws InvalidArgumentException
  2047. *
  2048. * @return void
  2049. */
  2050. public static function allGreaterThanEq($value, $limit, $message = '')
  2051. {
  2052. static::isIterable($value);
  2053. foreach ($value as $entry) {
  2054. static::greaterThanEq($entry, $limit, $message);
  2055. }
  2056. }
  2057. /**
  2058. * @psalm-pure
  2059. *
  2060. * @param mixed $value
  2061. * @param mixed $limit
  2062. * @param string $message
  2063. *
  2064. * @throws InvalidArgumentException
  2065. *
  2066. * @return void
  2067. */
  2068. public static function allNullOrGreaterThanEq($value, $limit, $message = '')
  2069. {
  2070. static::isIterable($value);
  2071. foreach ($value as $entry) {
  2072. null === $entry || static::greaterThanEq($entry, $limit, $message);
  2073. }
  2074. }
  2075. /**
  2076. * @psalm-pure
  2077. *
  2078. * @param mixed $value
  2079. * @param mixed $limit
  2080. * @param string $message
  2081. *
  2082. * @throws InvalidArgumentException
  2083. *
  2084. * @return void
  2085. */
  2086. public static function nullOrLessThan($value, $limit, $message = '')
  2087. {
  2088. null === $value || static::lessThan($value, $limit, $message);
  2089. }
  2090. /**
  2091. * @psalm-pure
  2092. *
  2093. * @param mixed $value
  2094. * @param mixed $limit
  2095. * @param string $message
  2096. *
  2097. * @throws InvalidArgumentException
  2098. *
  2099. * @return void
  2100. */
  2101. public static function allLessThan($value, $limit, $message = '')
  2102. {
  2103. static::isIterable($value);
  2104. foreach ($value as $entry) {
  2105. static::lessThan($entry, $limit, $message);
  2106. }
  2107. }
  2108. /**
  2109. * @psalm-pure
  2110. *
  2111. * @param mixed $value
  2112. * @param mixed $limit
  2113. * @param string $message
  2114. *
  2115. * @throws InvalidArgumentException
  2116. *
  2117. * @return void
  2118. */
  2119. public static function allNullOrLessThan($value, $limit, $message = '')
  2120. {
  2121. static::isIterable($value);
  2122. foreach ($value as $entry) {
  2123. null === $entry || static::lessThan($entry, $limit, $message);
  2124. }
  2125. }
  2126. /**
  2127. * @psalm-pure
  2128. *
  2129. * @param mixed $value
  2130. * @param mixed $limit
  2131. * @param string $message
  2132. *
  2133. * @throws InvalidArgumentException
  2134. *
  2135. * @return void
  2136. */
  2137. public static function nullOrLessThanEq($value, $limit, $message = '')
  2138. {
  2139. null === $value || static::lessThanEq($value, $limit, $message);
  2140. }
  2141. /**
  2142. * @psalm-pure
  2143. *
  2144. * @param mixed $value
  2145. * @param mixed $limit
  2146. * @param string $message
  2147. *
  2148. * @throws InvalidArgumentException
  2149. *
  2150. * @return void
  2151. */
  2152. public static function allLessThanEq($value, $limit, $message = '')
  2153. {
  2154. static::isIterable($value);
  2155. foreach ($value as $entry) {
  2156. static::lessThanEq($entry, $limit, $message);
  2157. }
  2158. }
  2159. /**
  2160. * @psalm-pure
  2161. *
  2162. * @param mixed $value
  2163. * @param mixed $limit
  2164. * @param string $message
  2165. *
  2166. * @throws InvalidArgumentException
  2167. *
  2168. * @return void
  2169. */
  2170. public static function allNullOrLessThanEq($value, $limit, $message = '')
  2171. {
  2172. static::isIterable($value);
  2173. foreach ($value as $entry) {
  2174. null === $entry || static::lessThanEq($entry, $limit, $message);
  2175. }
  2176. }
  2177. /**
  2178. * @psalm-pure
  2179. *
  2180. * @param mixed $value
  2181. * @param mixed $min
  2182. * @param mixed $max
  2183. * @param string $message
  2184. *
  2185. * @throws InvalidArgumentException
  2186. *
  2187. * @return void
  2188. */
  2189. public static function nullOrRange($value, $min, $max, $message = '')
  2190. {
  2191. null === $value || static::range($value, $min, $max, $message);
  2192. }
  2193. /**
  2194. * @psalm-pure
  2195. *
  2196. * @param mixed $value
  2197. * @param mixed $min
  2198. * @param mixed $max
  2199. * @param string $message
  2200. *
  2201. * @throws InvalidArgumentException
  2202. *
  2203. * @return void
  2204. */
  2205. public static function allRange($value, $min, $max, $message = '')
  2206. {
  2207. static::isIterable($value);
  2208. foreach ($value as $entry) {
  2209. static::range($entry, $min, $max, $message);
  2210. }
  2211. }
  2212. /**
  2213. * @psalm-pure
  2214. *
  2215. * @param mixed $value
  2216. * @param mixed $min
  2217. * @param mixed $max
  2218. * @param string $message
  2219. *
  2220. * @throws InvalidArgumentException
  2221. *
  2222. * @return void
  2223. */
  2224. public static function allNullOrRange($value, $min, $max, $message = '')
  2225. {
  2226. static::isIterable($value);
  2227. foreach ($value as $entry) {
  2228. null === $entry || static::range($entry, $min, $max, $message);
  2229. }
  2230. }
  2231. /**
  2232. * @psalm-pure
  2233. *
  2234. * @param mixed $value
  2235. * @param array $values
  2236. * @param string $message
  2237. *
  2238. * @throws InvalidArgumentException
  2239. *
  2240. * @return void
  2241. */
  2242. public static function nullOrOneOf($value, $values, $message = '')
  2243. {
  2244. null === $value || static::oneOf($value, $values, $message);
  2245. }
  2246. /**
  2247. * @psalm-pure
  2248. *
  2249. * @param mixed $value
  2250. * @param array $values
  2251. * @param string $message
  2252. *
  2253. * @throws InvalidArgumentException
  2254. *
  2255. * @return void
  2256. */
  2257. public static function allOneOf($value, $values, $message = '')
  2258. {
  2259. static::isIterable($value);
  2260. foreach ($value as $entry) {
  2261. static::oneOf($entry, $values, $message);
  2262. }
  2263. }
  2264. /**
  2265. * @psalm-pure
  2266. *
  2267. * @param mixed $value
  2268. * @param array $values
  2269. * @param string $message
  2270. *
  2271. * @throws InvalidArgumentException
  2272. *
  2273. * @return void
  2274. */
  2275. public static function allNullOrOneOf($value, $values, $message = '')
  2276. {
  2277. static::isIterable($value);
  2278. foreach ($value as $entry) {
  2279. null === $entry || static::oneOf($entry, $values, $message);
  2280. }
  2281. }
  2282. /**
  2283. * @psalm-pure
  2284. *
  2285. * @param mixed $value
  2286. * @param array $values
  2287. * @param string $message
  2288. *
  2289. * @throws InvalidArgumentException
  2290. *
  2291. * @return void
  2292. */
  2293. public static function nullOrInArray($value, $values, $message = '')
  2294. {
  2295. null === $value || static::inArray($value, $values, $message);
  2296. }
  2297. /**
  2298. * @psalm-pure
  2299. *
  2300. * @param mixed $value
  2301. * @param array $values
  2302. * @param string $message
  2303. *
  2304. * @throws InvalidArgumentException
  2305. *
  2306. * @return void
  2307. */
  2308. public static function allInArray($value, $values, $message = '')
  2309. {
  2310. static::isIterable($value);
  2311. foreach ($value as $entry) {
  2312. static::inArray($entry, $values, $message);
  2313. }
  2314. }
  2315. /**
  2316. * @psalm-pure
  2317. *
  2318. * @param mixed $value
  2319. * @param array $values
  2320. * @param string $message
  2321. *
  2322. * @throws InvalidArgumentException
  2323. *
  2324. * @return void
  2325. */
  2326. public static function allNullOrInArray($value, $values, $message = '')
  2327. {
  2328. static::isIterable($value);
  2329. foreach ($value as $entry) {
  2330. null === $entry || static::inArray($entry, $values, $message);
  2331. }
  2332. }
  2333. /**
  2334. * @psalm-pure
  2335. *
  2336. * @param string|null $value
  2337. * @param string $subString
  2338. * @param string $message
  2339. *
  2340. * @throws InvalidArgumentException
  2341. *
  2342. * @return void
  2343. */
  2344. public static function nullOrContains($value, $subString, $message = '')
  2345. {
  2346. null === $value || static::contains($value, $subString, $message);
  2347. }
  2348. /**
  2349. * @psalm-pure
  2350. *
  2351. * @param iterable<string> $value
  2352. * @param string $subString
  2353. * @param string $message
  2354. *
  2355. * @throws InvalidArgumentException
  2356. *
  2357. * @return void
  2358. */
  2359. public static function allContains($value, $subString, $message = '')
  2360. {
  2361. static::isIterable($value);
  2362. foreach ($value as $entry) {
  2363. static::contains($entry, $subString, $message);
  2364. }
  2365. }
  2366. /**
  2367. * @psalm-pure
  2368. *
  2369. * @param iterable<string|null> $value
  2370. * @param string $subString
  2371. * @param string $message
  2372. *
  2373. * @throws InvalidArgumentException
  2374. *
  2375. * @return void
  2376. */
  2377. public static function allNullOrContains($value, $subString, $message = '')
  2378. {
  2379. static::isIterable($value);
  2380. foreach ($value as $entry) {
  2381. null === $entry || static::contains($entry, $subString, $message);
  2382. }
  2383. }
  2384. /**
  2385. * @psalm-pure
  2386. *
  2387. * @param string|null $value
  2388. * @param string $subString
  2389. * @param string $message
  2390. *
  2391. * @throws InvalidArgumentException
  2392. *
  2393. * @return void
  2394. */
  2395. public static function nullOrNotContains($value, $subString, $message = '')
  2396. {
  2397. null === $value || static::notContains($value, $subString, $message);
  2398. }
  2399. /**
  2400. * @psalm-pure
  2401. *
  2402. * @param iterable<string> $value
  2403. * @param string $subString
  2404. * @param string $message
  2405. *
  2406. * @throws InvalidArgumentException
  2407. *
  2408. * @return void
  2409. */
  2410. public static function allNotContains($value, $subString, $message = '')
  2411. {
  2412. static::isIterable($value);
  2413. foreach ($value as $entry) {
  2414. static::notContains($entry, $subString, $message);
  2415. }
  2416. }
  2417. /**
  2418. * @psalm-pure
  2419. *
  2420. * @param iterable<string|null> $value
  2421. * @param string $subString
  2422. * @param string $message
  2423. *
  2424. * @throws InvalidArgumentException
  2425. *
  2426. * @return void
  2427. */
  2428. public static function allNullOrNotContains($value, $subString, $message = '')
  2429. {
  2430. static::isIterable($value);
  2431. foreach ($value as $entry) {
  2432. null === $entry || static::notContains($entry, $subString, $message);
  2433. }
  2434. }
  2435. /**
  2436. * @psalm-pure
  2437. *
  2438. * @param string|null $value
  2439. * @param string $message
  2440. *
  2441. * @throws InvalidArgumentException
  2442. *
  2443. * @return void
  2444. */
  2445. public static function nullOrNotWhitespaceOnly($value, $message = '')
  2446. {
  2447. null === $value || static::notWhitespaceOnly($value, $message);
  2448. }
  2449. /**
  2450. * @psalm-pure
  2451. *
  2452. * @param iterable<string> $value
  2453. * @param string $message
  2454. *
  2455. * @throws InvalidArgumentException
  2456. *
  2457. * @return void
  2458. */
  2459. public static function allNotWhitespaceOnly($value, $message = '')
  2460. {
  2461. static::isIterable($value);
  2462. foreach ($value as $entry) {
  2463. static::notWhitespaceOnly($entry, $message);
  2464. }
  2465. }
  2466. /**
  2467. * @psalm-pure
  2468. *
  2469. * @param iterable<string|null> $value
  2470. * @param string $message
  2471. *
  2472. * @throws InvalidArgumentException
  2473. *
  2474. * @return void
  2475. */
  2476. public static function allNullOrNotWhitespaceOnly($value, $message = '')
  2477. {
  2478. static::isIterable($value);
  2479. foreach ($value as $entry) {
  2480. null === $entry || static::notWhitespaceOnly($entry, $message);
  2481. }
  2482. }
  2483. /**
  2484. * @psalm-pure
  2485. *
  2486. * @param string|null $value
  2487. * @param string $prefix
  2488. * @param string $message
  2489. *
  2490. * @throws InvalidArgumentException
  2491. *
  2492. * @return void
  2493. */
  2494. public static function nullOrStartsWith($value, $prefix, $message = '')
  2495. {
  2496. null === $value || static::startsWith($value, $prefix, $message);
  2497. }
  2498. /**
  2499. * @psalm-pure
  2500. *
  2501. * @param iterable<string> $value
  2502. * @param string $prefix
  2503. * @param string $message
  2504. *
  2505. * @throws InvalidArgumentException
  2506. *
  2507. * @return void
  2508. */
  2509. public static function allStartsWith($value, $prefix, $message = '')
  2510. {
  2511. static::isIterable($value);
  2512. foreach ($value as $entry) {
  2513. static::startsWith($entry, $prefix, $message);
  2514. }
  2515. }
  2516. /**
  2517. * @psalm-pure
  2518. *
  2519. * @param iterable<string|null> $value
  2520. * @param string $prefix
  2521. * @param string $message
  2522. *
  2523. * @throws InvalidArgumentException
  2524. *
  2525. * @return void
  2526. */
  2527. public static function allNullOrStartsWith($value, $prefix, $message = '')
  2528. {
  2529. static::isIterable($value);
  2530. foreach ($value as $entry) {
  2531. null === $entry || static::startsWith($entry, $prefix, $message);
  2532. }
  2533. }
  2534. /**
  2535. * @psalm-pure
  2536. *
  2537. * @param string|null $value
  2538. * @param string $prefix
  2539. * @param string $message
  2540. *
  2541. * @throws InvalidArgumentException
  2542. *
  2543. * @return void
  2544. */
  2545. public static function nullOrNotStartsWith($value, $prefix, $message = '')
  2546. {
  2547. null === $value || static::notStartsWith($value, $prefix, $message);
  2548. }
  2549. /**
  2550. * @psalm-pure
  2551. *
  2552. * @param iterable<string> $value
  2553. * @param string $prefix
  2554. * @param string $message
  2555. *
  2556. * @throws InvalidArgumentException
  2557. *
  2558. * @return void
  2559. */
  2560. public static function allNotStartsWith($value, $prefix, $message = '')
  2561. {
  2562. static::isIterable($value);
  2563. foreach ($value as $entry) {
  2564. static::notStartsWith($entry, $prefix, $message);
  2565. }
  2566. }
  2567. /**
  2568. * @psalm-pure
  2569. *
  2570. * @param iterable<string|null> $value
  2571. * @param string $prefix
  2572. * @param string $message
  2573. *
  2574. * @throws InvalidArgumentException
  2575. *
  2576. * @return void
  2577. */
  2578. public static function allNullOrNotStartsWith($value, $prefix, $message = '')
  2579. {
  2580. static::isIterable($value);
  2581. foreach ($value as $entry) {
  2582. null === $entry || static::notStartsWith($entry, $prefix, $message);
  2583. }
  2584. }
  2585. /**
  2586. * @psalm-pure
  2587. *
  2588. * @param mixed $value
  2589. * @param string $message
  2590. *
  2591. * @throws InvalidArgumentException
  2592. *
  2593. * @return void
  2594. */
  2595. public static function nullOrStartsWithLetter($value, $message = '')
  2596. {
  2597. null === $value || static::startsWithLetter($value, $message);
  2598. }
  2599. /**
  2600. * @psalm-pure
  2601. *
  2602. * @param mixed $value
  2603. * @param string $message
  2604. *
  2605. * @throws InvalidArgumentException
  2606. *
  2607. * @return void
  2608. */
  2609. public static function allStartsWithLetter($value, $message = '')
  2610. {
  2611. static::isIterable($value);
  2612. foreach ($value as $entry) {
  2613. static::startsWithLetter($entry, $message);
  2614. }
  2615. }
  2616. /**
  2617. * @psalm-pure
  2618. *
  2619. * @param mixed $value
  2620. * @param string $message
  2621. *
  2622. * @throws InvalidArgumentException
  2623. *
  2624. * @return void
  2625. */
  2626. public static function allNullOrStartsWithLetter($value, $message = '')
  2627. {
  2628. static::isIterable($value);
  2629. foreach ($value as $entry) {
  2630. null === $entry || static::startsWithLetter($entry, $message);
  2631. }
  2632. }
  2633. /**
  2634. * @psalm-pure
  2635. *
  2636. * @param string|null $value
  2637. * @param string $suffix
  2638. * @param string $message
  2639. *
  2640. * @throws InvalidArgumentException
  2641. *
  2642. * @return void
  2643. */
  2644. public static function nullOrEndsWith($value, $suffix, $message = '')
  2645. {
  2646. null === $value || static::endsWith($value, $suffix, $message);
  2647. }
  2648. /**
  2649. * @psalm-pure
  2650. *
  2651. * @param iterable<string> $value
  2652. * @param string $suffix
  2653. * @param string $message
  2654. *
  2655. * @throws InvalidArgumentException
  2656. *
  2657. * @return void
  2658. */
  2659. public static function allEndsWith($value, $suffix, $message = '')
  2660. {
  2661. static::isIterable($value);
  2662. foreach ($value as $entry) {
  2663. static::endsWith($entry, $suffix, $message);
  2664. }
  2665. }
  2666. /**
  2667. * @psalm-pure
  2668. *
  2669. * @param iterable<string|null> $value
  2670. * @param string $suffix
  2671. * @param string $message
  2672. *
  2673. * @throws InvalidArgumentException
  2674. *
  2675. * @return void
  2676. */
  2677. public static function allNullOrEndsWith($value, $suffix, $message = '')
  2678. {
  2679. static::isIterable($value);
  2680. foreach ($value as $entry) {
  2681. null === $entry || static::endsWith($entry, $suffix, $message);
  2682. }
  2683. }
  2684. /**
  2685. * @psalm-pure
  2686. *
  2687. * @param string|null $value
  2688. * @param string $suffix
  2689. * @param string $message
  2690. *
  2691. * @throws InvalidArgumentException
  2692. *
  2693. * @return void
  2694. */
  2695. public static function nullOrNotEndsWith($value, $suffix, $message = '')
  2696. {
  2697. null === $value || static::notEndsWith($value, $suffix, $message);
  2698. }
  2699. /**
  2700. * @psalm-pure
  2701. *
  2702. * @param iterable<string> $value
  2703. * @param string $suffix
  2704. * @param string $message
  2705. *
  2706. * @throws InvalidArgumentException
  2707. *
  2708. * @return void
  2709. */
  2710. public static function allNotEndsWith($value, $suffix, $message = '')
  2711. {
  2712. static::isIterable($value);
  2713. foreach ($value as $entry) {
  2714. static::notEndsWith($entry, $suffix, $message);
  2715. }
  2716. }
  2717. /**
  2718. * @psalm-pure
  2719. *
  2720. * @param iterable<string|null> $value
  2721. * @param string $suffix
  2722. * @param string $message
  2723. *
  2724. * @throws InvalidArgumentException
  2725. *
  2726. * @return void
  2727. */
  2728. public static function allNullOrNotEndsWith($value, $suffix, $message = '')
  2729. {
  2730. static::isIterable($value);
  2731. foreach ($value as $entry) {
  2732. null === $entry || static::notEndsWith($entry, $suffix, $message);
  2733. }
  2734. }
  2735. /**
  2736. * @psalm-pure
  2737. *
  2738. * @param string|null $value
  2739. * @param string $pattern
  2740. * @param string $message
  2741. *
  2742. * @throws InvalidArgumentException
  2743. *
  2744. * @return void
  2745. */
  2746. public static function nullOrRegex($value, $pattern, $message = '')
  2747. {
  2748. null === $value || static::regex($value, $pattern, $message);
  2749. }
  2750. /**
  2751. * @psalm-pure
  2752. *
  2753. * @param iterable<string> $value
  2754. * @param string $pattern
  2755. * @param string $message
  2756. *
  2757. * @throws InvalidArgumentException
  2758. *
  2759. * @return void
  2760. */
  2761. public static function allRegex($value, $pattern, $message = '')
  2762. {
  2763. static::isIterable($value);
  2764. foreach ($value as $entry) {
  2765. static::regex($entry, $pattern, $message);
  2766. }
  2767. }
  2768. /**
  2769. * @psalm-pure
  2770. *
  2771. * @param iterable<string|null> $value
  2772. * @param string $pattern
  2773. * @param string $message
  2774. *
  2775. * @throws InvalidArgumentException
  2776. *
  2777. * @return void
  2778. */
  2779. public static function allNullOrRegex($value, $pattern, $message = '')
  2780. {
  2781. static::isIterable($value);
  2782. foreach ($value as $entry) {
  2783. null === $entry || static::regex($entry, $pattern, $message);
  2784. }
  2785. }
  2786. /**
  2787. * @psalm-pure
  2788. *
  2789. * @param string|null $value
  2790. * @param string $pattern
  2791. * @param string $message
  2792. *
  2793. * @throws InvalidArgumentException
  2794. *
  2795. * @return void
  2796. */
  2797. public static function nullOrNotRegex($value, $pattern, $message = '')
  2798. {
  2799. null === $value || static::notRegex($value, $pattern, $message);
  2800. }
  2801. /**
  2802. * @psalm-pure
  2803. *
  2804. * @param iterable<string> $value
  2805. * @param string $pattern
  2806. * @param string $message
  2807. *
  2808. * @throws InvalidArgumentException
  2809. *
  2810. * @return void
  2811. */
  2812. public static function allNotRegex($value, $pattern, $message = '')
  2813. {
  2814. static::isIterable($value);
  2815. foreach ($value as $entry) {
  2816. static::notRegex($entry, $pattern, $message);
  2817. }
  2818. }
  2819. /**
  2820. * @psalm-pure
  2821. *
  2822. * @param iterable<string|null> $value
  2823. * @param string $pattern
  2824. * @param string $message
  2825. *
  2826. * @throws InvalidArgumentException
  2827. *
  2828. * @return void
  2829. */
  2830. public static function allNullOrNotRegex($value, $pattern, $message = '')
  2831. {
  2832. static::isIterable($value);
  2833. foreach ($value as $entry) {
  2834. null === $entry || static::notRegex($entry, $pattern, $message);
  2835. }
  2836. }
  2837. /**
  2838. * @psalm-pure
  2839. *
  2840. * @param mixed $value
  2841. * @param string $message
  2842. *
  2843. * @throws InvalidArgumentException
  2844. *
  2845. * @return void
  2846. */
  2847. public static function nullOrUnicodeLetters($value, $message = '')
  2848. {
  2849. null === $value || static::unicodeLetters($value, $message);
  2850. }
  2851. /**
  2852. * @psalm-pure
  2853. *
  2854. * @param mixed $value
  2855. * @param string $message
  2856. *
  2857. * @throws InvalidArgumentException
  2858. *
  2859. * @return void
  2860. */
  2861. public static function allUnicodeLetters($value, $message = '')
  2862. {
  2863. static::isIterable($value);
  2864. foreach ($value as $entry) {
  2865. static::unicodeLetters($entry, $message);
  2866. }
  2867. }
  2868. /**
  2869. * @psalm-pure
  2870. *
  2871. * @param mixed $value
  2872. * @param string $message
  2873. *
  2874. * @throws InvalidArgumentException
  2875. *
  2876. * @return void
  2877. */
  2878. public static function allNullOrUnicodeLetters($value, $message = '')
  2879. {
  2880. static::isIterable($value);
  2881. foreach ($value as $entry) {
  2882. null === $entry || static::unicodeLetters($entry, $message);
  2883. }
  2884. }
  2885. /**
  2886. * @psalm-pure
  2887. *
  2888. * @param mixed $value
  2889. * @param string $message
  2890. *
  2891. * @throws InvalidArgumentException
  2892. *
  2893. * @return void
  2894. */
  2895. public static function nullOrAlpha($value, $message = '')
  2896. {
  2897. null === $value || static::alpha($value, $message);
  2898. }
  2899. /**
  2900. * @psalm-pure
  2901. *
  2902. * @param mixed $value
  2903. * @param string $message
  2904. *
  2905. * @throws InvalidArgumentException
  2906. *
  2907. * @return void
  2908. */
  2909. public static function allAlpha($value, $message = '')
  2910. {
  2911. static::isIterable($value);
  2912. foreach ($value as $entry) {
  2913. static::alpha($entry, $message);
  2914. }
  2915. }
  2916. /**
  2917. * @psalm-pure
  2918. *
  2919. * @param mixed $value
  2920. * @param string $message
  2921. *
  2922. * @throws InvalidArgumentException
  2923. *
  2924. * @return void
  2925. */
  2926. public static function allNullOrAlpha($value, $message = '')
  2927. {
  2928. static::isIterable($value);
  2929. foreach ($value as $entry) {
  2930. null === $entry || static::alpha($entry, $message);
  2931. }
  2932. }
  2933. /**
  2934. * @psalm-pure
  2935. *
  2936. * @param string|null $value
  2937. * @param string $message
  2938. *
  2939. * @throws InvalidArgumentException
  2940. *
  2941. * @return void
  2942. */
  2943. public static function nullOrDigits($value, $message = '')
  2944. {
  2945. null === $value || static::digits($value, $message);
  2946. }
  2947. /**
  2948. * @psalm-pure
  2949. *
  2950. * @param iterable<string> $value
  2951. * @param string $message
  2952. *
  2953. * @throws InvalidArgumentException
  2954. *
  2955. * @return void
  2956. */
  2957. public static function allDigits($value, $message = '')
  2958. {
  2959. static::isIterable($value);
  2960. foreach ($value as $entry) {
  2961. static::digits($entry, $message);
  2962. }
  2963. }
  2964. /**
  2965. * @psalm-pure
  2966. *
  2967. * @param iterable<string|null> $value
  2968. * @param string $message
  2969. *
  2970. * @throws InvalidArgumentException
  2971. *
  2972. * @return void
  2973. */
  2974. public static function allNullOrDigits($value, $message = '')
  2975. {
  2976. static::isIterable($value);
  2977. foreach ($value as $entry) {
  2978. null === $entry || static::digits($entry, $message);
  2979. }
  2980. }
  2981. /**
  2982. * @psalm-pure
  2983. *
  2984. * @param string|null $value
  2985. * @param string $message
  2986. *
  2987. * @throws InvalidArgumentException
  2988. *
  2989. * @return void
  2990. */
  2991. public static function nullOrAlnum($value, $message = '')
  2992. {
  2993. null === $value || static::alnum($value, $message);
  2994. }
  2995. /**
  2996. * @psalm-pure
  2997. *
  2998. * @param iterable<string> $value
  2999. * @param string $message
  3000. *
  3001. * @throws InvalidArgumentException
  3002. *
  3003. * @return void
  3004. */
  3005. public static function allAlnum($value, $message = '')
  3006. {
  3007. static::isIterable($value);
  3008. foreach ($value as $entry) {
  3009. static::alnum($entry, $message);
  3010. }
  3011. }
  3012. /**
  3013. * @psalm-pure
  3014. *
  3015. * @param iterable<string|null> $value
  3016. * @param string $message
  3017. *
  3018. * @throws InvalidArgumentException
  3019. *
  3020. * @return void
  3021. */
  3022. public static function allNullOrAlnum($value, $message = '')
  3023. {
  3024. static::isIterable($value);
  3025. foreach ($value as $entry) {
  3026. null === $entry || static::alnum($entry, $message);
  3027. }
  3028. }
  3029. /**
  3030. * @psalm-pure
  3031. * @psalm-assert lowercase-string|null $value
  3032. *
  3033. * @param string|null $value
  3034. * @param string $message
  3035. *
  3036. * @throws InvalidArgumentException
  3037. *
  3038. * @return void
  3039. */
  3040. public static function nullOrLower($value, $message = '')
  3041. {
  3042. null === $value || static::lower($value, $message);
  3043. }
  3044. /**
  3045. * @psalm-pure
  3046. * @psalm-assert iterable<lowercase-string> $value
  3047. *
  3048. * @param iterable<string> $value
  3049. * @param string $message
  3050. *
  3051. * @throws InvalidArgumentException
  3052. *
  3053. * @return void
  3054. */
  3055. public static function allLower($value, $message = '')
  3056. {
  3057. static::isIterable($value);
  3058. foreach ($value as $entry) {
  3059. static::lower($entry, $message);
  3060. }
  3061. }
  3062. /**
  3063. * @psalm-pure
  3064. * @psalm-assert iterable<lowercase-string|null> $value
  3065. *
  3066. * @param iterable<string|null> $value
  3067. * @param string $message
  3068. *
  3069. * @throws InvalidArgumentException
  3070. *
  3071. * @return void
  3072. */
  3073. public static function allNullOrLower($value, $message = '')
  3074. {
  3075. static::isIterable($value);
  3076. foreach ($value as $entry) {
  3077. null === $entry || static::lower($entry, $message);
  3078. }
  3079. }
  3080. /**
  3081. * @psalm-pure
  3082. *
  3083. * @param string|null $value
  3084. * @param string $message
  3085. *
  3086. * @throws InvalidArgumentException
  3087. *
  3088. * @return void
  3089. */
  3090. public static function nullOrUpper($value, $message = '')
  3091. {
  3092. null === $value || static::upper($value, $message);
  3093. }
  3094. /**
  3095. * @psalm-pure
  3096. *
  3097. * @param iterable<string> $value
  3098. * @param string $message
  3099. *
  3100. * @throws InvalidArgumentException
  3101. *
  3102. * @return void
  3103. */
  3104. public static function allUpper($value, $message = '')
  3105. {
  3106. static::isIterable($value);
  3107. foreach ($value as $entry) {
  3108. static::upper($entry, $message);
  3109. }
  3110. }
  3111. /**
  3112. * @psalm-pure
  3113. * @psalm-assert iterable<!lowercase-string|null> $value
  3114. *
  3115. * @param iterable<string|null> $value
  3116. * @param string $message
  3117. *
  3118. * @throws InvalidArgumentException
  3119. *
  3120. * @return void
  3121. */
  3122. public static function allNullOrUpper($value, $message = '')
  3123. {
  3124. static::isIterable($value);
  3125. foreach ($value as $entry) {
  3126. null === $entry || static::upper($entry, $message);
  3127. }
  3128. }
  3129. /**
  3130. * @psalm-pure
  3131. *
  3132. * @param string|null $value
  3133. * @param int $length
  3134. * @param string $message
  3135. *
  3136. * @throws InvalidArgumentException
  3137. *
  3138. * @return void
  3139. */
  3140. public static function nullOrLength($value, $length, $message = '')
  3141. {
  3142. null === $value || static::length($value, $length, $message);
  3143. }
  3144. /**
  3145. * @psalm-pure
  3146. *
  3147. * @param iterable<string> $value
  3148. * @param int $length
  3149. * @param string $message
  3150. *
  3151. * @throws InvalidArgumentException
  3152. *
  3153. * @return void
  3154. */
  3155. public static function allLength($value, $length, $message = '')
  3156. {
  3157. static::isIterable($value);
  3158. foreach ($value as $entry) {
  3159. static::length($entry, $length, $message);
  3160. }
  3161. }
  3162. /**
  3163. * @psalm-pure
  3164. *
  3165. * @param iterable<string|null> $value
  3166. * @param int $length
  3167. * @param string $message
  3168. *
  3169. * @throws InvalidArgumentException
  3170. *
  3171. * @return void
  3172. */
  3173. public static function allNullOrLength($value, $length, $message = '')
  3174. {
  3175. static::isIterable($value);
  3176. foreach ($value as $entry) {
  3177. null === $entry || static::length($entry, $length, $message);
  3178. }
  3179. }
  3180. /**
  3181. * @psalm-pure
  3182. *
  3183. * @param string|null $value
  3184. * @param int|float $min
  3185. * @param string $message
  3186. *
  3187. * @throws InvalidArgumentException
  3188. *
  3189. * @return void
  3190. */
  3191. public static function nullOrMinLength($value, $min, $message = '')
  3192. {
  3193. null === $value || static::minLength($value, $min, $message);
  3194. }
  3195. /**
  3196. * @psalm-pure
  3197. *
  3198. * @param iterable<string> $value
  3199. * @param int|float $min
  3200. * @param string $message
  3201. *
  3202. * @throws InvalidArgumentException
  3203. *
  3204. * @return void
  3205. */
  3206. public static function allMinLength($value, $min, $message = '')
  3207. {
  3208. static::isIterable($value);
  3209. foreach ($value as $entry) {
  3210. static::minLength($entry, $min, $message);
  3211. }
  3212. }
  3213. /**
  3214. * @psalm-pure
  3215. *
  3216. * @param iterable<string|null> $value
  3217. * @param int|float $min
  3218. * @param string $message
  3219. *
  3220. * @throws InvalidArgumentException
  3221. *
  3222. * @return void
  3223. */
  3224. public static function allNullOrMinLength($value, $min, $message = '')
  3225. {
  3226. static::isIterable($value);
  3227. foreach ($value as $entry) {
  3228. null === $entry || static::minLength($entry, $min, $message);
  3229. }
  3230. }
  3231. /**
  3232. * @psalm-pure
  3233. *
  3234. * @param string|null $value
  3235. * @param int|float $max
  3236. * @param string $message
  3237. *
  3238. * @throws InvalidArgumentException
  3239. *
  3240. * @return void
  3241. */
  3242. public static function nullOrMaxLength($value, $max, $message = '')
  3243. {
  3244. null === $value || static::maxLength($value, $max, $message);
  3245. }
  3246. /**
  3247. * @psalm-pure
  3248. *
  3249. * @param iterable<string> $value
  3250. * @param int|float $max
  3251. * @param string $message
  3252. *
  3253. * @throws InvalidArgumentException
  3254. *
  3255. * @return void
  3256. */
  3257. public static function allMaxLength($value, $max, $message = '')
  3258. {
  3259. static::isIterable($value);
  3260. foreach ($value as $entry) {
  3261. static::maxLength($entry, $max, $message);
  3262. }
  3263. }
  3264. /**
  3265. * @psalm-pure
  3266. *
  3267. * @param iterable<string|null> $value
  3268. * @param int|float $max
  3269. * @param string $message
  3270. *
  3271. * @throws InvalidArgumentException
  3272. *
  3273. * @return void
  3274. */
  3275. public static function allNullOrMaxLength($value, $max, $message = '')
  3276. {
  3277. static::isIterable($value);
  3278. foreach ($value as $entry) {
  3279. null === $entry || static::maxLength($entry, $max, $message);
  3280. }
  3281. }
  3282. /**
  3283. * @psalm-pure
  3284. *
  3285. * @param string|null $value
  3286. * @param int|float $min
  3287. * @param int|float $max
  3288. * @param string $message
  3289. *
  3290. * @throws InvalidArgumentException
  3291. *
  3292. * @return void
  3293. */
  3294. public static function nullOrLengthBetween($value, $min, $max, $message = '')
  3295. {
  3296. null === $value || static::lengthBetween($value, $min, $max, $message);
  3297. }
  3298. /**
  3299. * @psalm-pure
  3300. *
  3301. * @param iterable<string> $value
  3302. * @param int|float $min
  3303. * @param int|float $max
  3304. * @param string $message
  3305. *
  3306. * @throws InvalidArgumentException
  3307. *
  3308. * @return void
  3309. */
  3310. public static function allLengthBetween($value, $min, $max, $message = '')
  3311. {
  3312. static::isIterable($value);
  3313. foreach ($value as $entry) {
  3314. static::lengthBetween($entry, $min, $max, $message);
  3315. }
  3316. }
  3317. /**
  3318. * @psalm-pure
  3319. *
  3320. * @param iterable<string|null> $value
  3321. * @param int|float $min
  3322. * @param int|float $max
  3323. * @param string $message
  3324. *
  3325. * @throws InvalidArgumentException
  3326. *
  3327. * @return void
  3328. */
  3329. public static function allNullOrLengthBetween($value, $min, $max, $message = '')
  3330. {
  3331. static::isIterable($value);
  3332. foreach ($value as $entry) {
  3333. null === $entry || static::lengthBetween($entry, $min, $max, $message);
  3334. }
  3335. }
  3336. /**
  3337. * @param mixed $value
  3338. * @param string $message
  3339. *
  3340. * @throws InvalidArgumentException
  3341. *
  3342. * @return void
  3343. */
  3344. public static function nullOrFileExists($value, $message = '')
  3345. {
  3346. null === $value || static::fileExists($value, $message);
  3347. }
  3348. /**
  3349. * @param mixed $value
  3350. * @param string $message
  3351. *
  3352. * @throws InvalidArgumentException
  3353. *
  3354. * @return void
  3355. */
  3356. public static function allFileExists($value, $message = '')
  3357. {
  3358. static::isIterable($value);
  3359. foreach ($value as $entry) {
  3360. static::fileExists($entry, $message);
  3361. }
  3362. }
  3363. /**
  3364. * @param mixed $value
  3365. * @param string $message
  3366. *
  3367. * @throws InvalidArgumentException
  3368. *
  3369. * @return void
  3370. */
  3371. public static function allNullOrFileExists($value, $message = '')
  3372. {
  3373. static::isIterable($value);
  3374. foreach ($value as $entry) {
  3375. null === $entry || static::fileExists($entry, $message);
  3376. }
  3377. }
  3378. /**
  3379. * @param mixed $value
  3380. * @param string $message
  3381. *
  3382. * @throws InvalidArgumentException
  3383. *
  3384. * @return void
  3385. */
  3386. public static function nullOrFile($value, $message = '')
  3387. {
  3388. null === $value || static::file($value, $message);
  3389. }
  3390. /**
  3391. * @param mixed $value
  3392. * @param string $message
  3393. *
  3394. * @throws InvalidArgumentException
  3395. *
  3396. * @return void
  3397. */
  3398. public static function allFile($value, $message = '')
  3399. {
  3400. static::isIterable($value);
  3401. foreach ($value as $entry) {
  3402. static::file($entry, $message);
  3403. }
  3404. }
  3405. /**
  3406. * @param mixed $value
  3407. * @param string $message
  3408. *
  3409. * @throws InvalidArgumentException
  3410. *
  3411. * @return void
  3412. */
  3413. public static function allNullOrFile($value, $message = '')
  3414. {
  3415. static::isIterable($value);
  3416. foreach ($value as $entry) {
  3417. null === $entry || static::file($entry, $message);
  3418. }
  3419. }
  3420. /**
  3421. * @param mixed $value
  3422. * @param string $message
  3423. *
  3424. * @throws InvalidArgumentException
  3425. *
  3426. * @return void
  3427. */
  3428. public static function nullOrDirectory($value, $message = '')
  3429. {
  3430. null === $value || static::directory($value, $message);
  3431. }
  3432. /**
  3433. * @param mixed $value
  3434. * @param string $message
  3435. *
  3436. * @throws InvalidArgumentException
  3437. *
  3438. * @return void
  3439. */
  3440. public static function allDirectory($value, $message = '')
  3441. {
  3442. static::isIterable($value);
  3443. foreach ($value as $entry) {
  3444. static::directory($entry, $message);
  3445. }
  3446. }
  3447. /**
  3448. * @param mixed $value
  3449. * @param string $message
  3450. *
  3451. * @throws InvalidArgumentException
  3452. *
  3453. * @return void
  3454. */
  3455. public static function allNullOrDirectory($value, $message = '')
  3456. {
  3457. static::isIterable($value);
  3458. foreach ($value as $entry) {
  3459. null === $entry || static::directory($entry, $message);
  3460. }
  3461. }
  3462. /**
  3463. * @param string|null $value
  3464. * @param string $message
  3465. *
  3466. * @throws InvalidArgumentException
  3467. *
  3468. * @return void
  3469. */
  3470. public static function nullOrReadable($value, $message = '')
  3471. {
  3472. null === $value || static::readable($value, $message);
  3473. }
  3474. /**
  3475. * @param iterable<string> $value
  3476. * @param string $message
  3477. *
  3478. * @throws InvalidArgumentException
  3479. *
  3480. * @return void
  3481. */
  3482. public static function allReadable($value, $message = '')
  3483. {
  3484. static::isIterable($value);
  3485. foreach ($value as $entry) {
  3486. static::readable($entry, $message);
  3487. }
  3488. }
  3489. /**
  3490. * @param iterable<string|null> $value
  3491. * @param string $message
  3492. *
  3493. * @throws InvalidArgumentException
  3494. *
  3495. * @return void
  3496. */
  3497. public static function allNullOrReadable($value, $message = '')
  3498. {
  3499. static::isIterable($value);
  3500. foreach ($value as $entry) {
  3501. null === $entry || static::readable($entry, $message);
  3502. }
  3503. }
  3504. /**
  3505. * @param string|null $value
  3506. * @param string $message
  3507. *
  3508. * @throws InvalidArgumentException
  3509. *
  3510. * @return void
  3511. */
  3512. public static function nullOrWritable($value, $message = '')
  3513. {
  3514. null === $value || static::writable($value, $message);
  3515. }
  3516. /**
  3517. * @param iterable<string> $value
  3518. * @param string $message
  3519. *
  3520. * @throws InvalidArgumentException
  3521. *
  3522. * @return void
  3523. */
  3524. public static function allWritable($value, $message = '')
  3525. {
  3526. static::isIterable($value);
  3527. foreach ($value as $entry) {
  3528. static::writable($entry, $message);
  3529. }
  3530. }
  3531. /**
  3532. * @param iterable<string|null> $value
  3533. * @param string $message
  3534. *
  3535. * @throws InvalidArgumentException
  3536. *
  3537. * @return void
  3538. */
  3539. public static function allNullOrWritable($value, $message = '')
  3540. {
  3541. static::isIterable($value);
  3542. foreach ($value as $entry) {
  3543. null === $entry || static::writable($entry, $message);
  3544. }
  3545. }
  3546. /**
  3547. * @psalm-assert class-string|null $value
  3548. *
  3549. * @param mixed $value
  3550. * @param string $message
  3551. *
  3552. * @throws InvalidArgumentException
  3553. *
  3554. * @return void
  3555. */
  3556. public static function nullOrClassExists($value, $message = '')
  3557. {
  3558. null === $value || static::classExists($value, $message);
  3559. }
  3560. /**
  3561. * @psalm-assert iterable<class-string> $value
  3562. *
  3563. * @param mixed $value
  3564. * @param string $message
  3565. *
  3566. * @throws InvalidArgumentException
  3567. *
  3568. * @return void
  3569. */
  3570. public static function allClassExists($value, $message = '')
  3571. {
  3572. static::isIterable($value);
  3573. foreach ($value as $entry) {
  3574. static::classExists($entry, $message);
  3575. }
  3576. }
  3577. /**
  3578. * @psalm-assert iterable<class-string|null> $value
  3579. *
  3580. * @param mixed $value
  3581. * @param string $message
  3582. *
  3583. * @throws InvalidArgumentException
  3584. *
  3585. * @return void
  3586. */
  3587. public static function allNullOrClassExists($value, $message = '')
  3588. {
  3589. static::isIterable($value);
  3590. foreach ($value as $entry) {
  3591. null === $entry || static::classExists($entry, $message);
  3592. }
  3593. }
  3594. /**
  3595. * @psalm-pure
  3596. * @psalm-template ExpectedType of object
  3597. * @psalm-param class-string<ExpectedType> $class
  3598. * @psalm-assert class-string<ExpectedType>|ExpectedType|null $value
  3599. *
  3600. * @param mixed $value
  3601. * @param string|object $class
  3602. * @param string $message
  3603. *
  3604. * @throws InvalidArgumentException
  3605. *
  3606. * @return void
  3607. */
  3608. public static function nullOrSubclassOf($value, $class, $message = '')
  3609. {
  3610. null === $value || static::subclassOf($value, $class, $message);
  3611. }
  3612. /**
  3613. * @psalm-pure
  3614. * @psalm-template ExpectedType of object
  3615. * @psalm-param class-string<ExpectedType> $class
  3616. * @psalm-assert iterable<class-string<ExpectedType>|ExpectedType> $value
  3617. *
  3618. * @param mixed $value
  3619. * @param string|object $class
  3620. * @param string $message
  3621. *
  3622. * @throws InvalidArgumentException
  3623. *
  3624. * @return void
  3625. */
  3626. public static function allSubclassOf($value, $class, $message = '')
  3627. {
  3628. static::isIterable($value);
  3629. foreach ($value as $entry) {
  3630. static::subclassOf($entry, $class, $message);
  3631. }
  3632. }
  3633. /**
  3634. * @psalm-pure
  3635. * @psalm-template ExpectedType of object
  3636. * @psalm-param class-string<ExpectedType> $class
  3637. * @psalm-assert iterable<class-string<ExpectedType>|ExpectedType|null> $value
  3638. *
  3639. * @param mixed $value
  3640. * @param string|object $class
  3641. * @param string $message
  3642. *
  3643. * @throws InvalidArgumentException
  3644. *
  3645. * @return void
  3646. */
  3647. public static function allNullOrSubclassOf($value, $class, $message = '')
  3648. {
  3649. static::isIterable($value);
  3650. foreach ($value as $entry) {
  3651. null === $entry || static::subclassOf($entry, $class, $message);
  3652. }
  3653. }
  3654. /**
  3655. * @psalm-assert class-string|null $value
  3656. *
  3657. * @param mixed $value
  3658. * @param string $message
  3659. *
  3660. * @throws InvalidArgumentException
  3661. *
  3662. * @return void
  3663. */
  3664. public static function nullOrInterfaceExists($value, $message = '')
  3665. {
  3666. null === $value || static::interfaceExists($value, $message);
  3667. }
  3668. /**
  3669. * @psalm-assert iterable<class-string> $value
  3670. *
  3671. * @param mixed $value
  3672. * @param string $message
  3673. *
  3674. * @throws InvalidArgumentException
  3675. *
  3676. * @return void
  3677. */
  3678. public static function allInterfaceExists($value, $message = '')
  3679. {
  3680. static::isIterable($value);
  3681. foreach ($value as $entry) {
  3682. static::interfaceExists($entry, $message);
  3683. }
  3684. }
  3685. /**
  3686. * @psalm-assert iterable<class-string|null> $value
  3687. *
  3688. * @param mixed $value
  3689. * @param string $message
  3690. *
  3691. * @throws InvalidArgumentException
  3692. *
  3693. * @return void
  3694. */
  3695. public static function allNullOrInterfaceExists($value, $message = '')
  3696. {
  3697. static::isIterable($value);
  3698. foreach ($value as $entry) {
  3699. null === $entry || static::interfaceExists($entry, $message);
  3700. }
  3701. }
  3702. /**
  3703. * @psalm-pure
  3704. * @psalm-template ExpectedType of object
  3705. * @psalm-param class-string<ExpectedType> $interface
  3706. * @psalm-assert class-string<ExpectedType>|null $value
  3707. *
  3708. * @param mixed $value
  3709. * @param mixed $interface
  3710. * @param string $message
  3711. *
  3712. * @throws InvalidArgumentException
  3713. *
  3714. * @return void
  3715. */
  3716. public static function nullOrImplementsInterface($value, $interface, $message = '')
  3717. {
  3718. null === $value || static::implementsInterface($value, $interface, $message);
  3719. }
  3720. /**
  3721. * @psalm-pure
  3722. * @psalm-template ExpectedType of object
  3723. * @psalm-param class-string<ExpectedType> $interface
  3724. * @psalm-assert iterable<class-string<ExpectedType>> $value
  3725. *
  3726. * @param mixed $value
  3727. * @param mixed $interface
  3728. * @param string $message
  3729. *
  3730. * @throws InvalidArgumentException
  3731. *
  3732. * @return void
  3733. */
  3734. public static function allImplementsInterface($value, $interface, $message = '')
  3735. {
  3736. static::isIterable($value);
  3737. foreach ($value as $entry) {
  3738. static::implementsInterface($entry, $interface, $message);
  3739. }
  3740. }
  3741. /**
  3742. * @psalm-pure
  3743. * @psalm-template ExpectedType of object
  3744. * @psalm-param class-string<ExpectedType> $interface
  3745. * @psalm-assert iterable<class-string<ExpectedType>|null> $value
  3746. *
  3747. * @param mixed $value
  3748. * @param mixed $interface
  3749. * @param string $message
  3750. *
  3751. * @throws InvalidArgumentException
  3752. *
  3753. * @return void
  3754. */
  3755. public static function allNullOrImplementsInterface($value, $interface, $message = '')
  3756. {
  3757. static::isIterable($value);
  3758. foreach ($value as $entry) {
  3759. null === $entry || static::implementsInterface($entry, $interface, $message);
  3760. }
  3761. }
  3762. /**
  3763. * @psalm-pure
  3764. * @psalm-param class-string|object|null $classOrObject
  3765. *
  3766. * @param string|object|null $classOrObject
  3767. * @param mixed $property
  3768. * @param string $message
  3769. *
  3770. * @throws InvalidArgumentException
  3771. *
  3772. * @return void
  3773. */
  3774. public static function nullOrPropertyExists($classOrObject, $property, $message = '')
  3775. {
  3776. null === $classOrObject || static::propertyExists($classOrObject, $property, $message);
  3777. }
  3778. /**
  3779. * @psalm-pure
  3780. * @psalm-param iterable<class-string|object> $classOrObject
  3781. *
  3782. * @param iterable<string|object> $classOrObject
  3783. * @param mixed $property
  3784. * @param string $message
  3785. *
  3786. * @throws InvalidArgumentException
  3787. *
  3788. * @return void
  3789. */
  3790. public static function allPropertyExists($classOrObject, $property, $message = '')
  3791. {
  3792. static::isIterable($classOrObject);
  3793. foreach ($classOrObject as $entry) {
  3794. static::propertyExists($entry, $property, $message);
  3795. }
  3796. }
  3797. /**
  3798. * @psalm-pure
  3799. * @psalm-param iterable<class-string|object|null> $classOrObject
  3800. *
  3801. * @param iterable<string|object|null> $classOrObject
  3802. * @param mixed $property
  3803. * @param string $message
  3804. *
  3805. * @throws InvalidArgumentException
  3806. *
  3807. * @return void
  3808. */
  3809. public static function allNullOrPropertyExists($classOrObject, $property, $message = '')
  3810. {
  3811. static::isIterable($classOrObject);
  3812. foreach ($classOrObject as $entry) {
  3813. null === $entry || static::propertyExists($entry, $property, $message);
  3814. }
  3815. }
  3816. /**
  3817. * @psalm-pure
  3818. * @psalm-param class-string|object|null $classOrObject
  3819. *
  3820. * @param string|object|null $classOrObject
  3821. * @param mixed $property
  3822. * @param string $message
  3823. *
  3824. * @throws InvalidArgumentException
  3825. *
  3826. * @return void
  3827. */
  3828. public static function nullOrPropertyNotExists($classOrObject, $property, $message = '')
  3829. {
  3830. null === $classOrObject || static::propertyNotExists($classOrObject, $property, $message);
  3831. }
  3832. /**
  3833. * @psalm-pure
  3834. * @psalm-param iterable<class-string|object> $classOrObject
  3835. *
  3836. * @param iterable<string|object> $classOrObject
  3837. * @param mixed $property
  3838. * @param string $message
  3839. *
  3840. * @throws InvalidArgumentException
  3841. *
  3842. * @return void
  3843. */
  3844. public static function allPropertyNotExists($classOrObject, $property, $message = '')
  3845. {
  3846. static::isIterable($classOrObject);
  3847. foreach ($classOrObject as $entry) {
  3848. static::propertyNotExists($entry, $property, $message);
  3849. }
  3850. }
  3851. /**
  3852. * @psalm-pure
  3853. * @psalm-param iterable<class-string|object|null> $classOrObject
  3854. *
  3855. * @param iterable<string|object|null> $classOrObject
  3856. * @param mixed $property
  3857. * @param string $message
  3858. *
  3859. * @throws InvalidArgumentException
  3860. *
  3861. * @return void
  3862. */
  3863. public static function allNullOrPropertyNotExists($classOrObject, $property, $message = '')
  3864. {
  3865. static::isIterable($classOrObject);
  3866. foreach ($classOrObject as $entry) {
  3867. null === $entry || static::propertyNotExists($entry, $property, $message);
  3868. }
  3869. }
  3870. /**
  3871. * @psalm-pure
  3872. * @psalm-param class-string|object|null $classOrObject
  3873. *
  3874. * @param string|object|null $classOrObject
  3875. * @param mixed $method
  3876. * @param string $message
  3877. *
  3878. * @throws InvalidArgumentException
  3879. *
  3880. * @return void
  3881. */
  3882. public static function nullOrMethodExists($classOrObject, $method, $message = '')
  3883. {
  3884. null === $classOrObject || static::methodExists($classOrObject, $method, $message);
  3885. }
  3886. /**
  3887. * @psalm-pure
  3888. * @psalm-param iterable<class-string|object> $classOrObject
  3889. *
  3890. * @param iterable<string|object> $classOrObject
  3891. * @param mixed $method
  3892. * @param string $message
  3893. *
  3894. * @throws InvalidArgumentException
  3895. *
  3896. * @return void
  3897. */
  3898. public static function allMethodExists($classOrObject, $method, $message = '')
  3899. {
  3900. static::isIterable($classOrObject);
  3901. foreach ($classOrObject as $entry) {
  3902. static::methodExists($entry, $method, $message);
  3903. }
  3904. }
  3905. /**
  3906. * @psalm-pure
  3907. * @psalm-param iterable<class-string|object|null> $classOrObject
  3908. *
  3909. * @param iterable<string|object|null> $classOrObject
  3910. * @param mixed $method
  3911. * @param string $message
  3912. *
  3913. * @throws InvalidArgumentException
  3914. *
  3915. * @return void
  3916. */
  3917. public static function allNullOrMethodExists($classOrObject, $method, $message = '')
  3918. {
  3919. static::isIterable($classOrObject);
  3920. foreach ($classOrObject as $entry) {
  3921. null === $entry || static::methodExists($entry, $method, $message);
  3922. }
  3923. }
  3924. /**
  3925. * @psalm-pure
  3926. * @psalm-param class-string|object|null $classOrObject
  3927. *
  3928. * @param string|object|null $classOrObject
  3929. * @param mixed $method
  3930. * @param string $message
  3931. *
  3932. * @throws InvalidArgumentException
  3933. *
  3934. * @return void
  3935. */
  3936. public static function nullOrMethodNotExists($classOrObject, $method, $message = '')
  3937. {
  3938. null === $classOrObject || static::methodNotExists($classOrObject, $method, $message);
  3939. }
  3940. /**
  3941. * @psalm-pure
  3942. * @psalm-param iterable<class-string|object> $classOrObject
  3943. *
  3944. * @param iterable<string|object> $classOrObject
  3945. * @param mixed $method
  3946. * @param string $message
  3947. *
  3948. * @throws InvalidArgumentException
  3949. *
  3950. * @return void
  3951. */
  3952. public static function allMethodNotExists($classOrObject, $method, $message = '')
  3953. {
  3954. static::isIterable($classOrObject);
  3955. foreach ($classOrObject as $entry) {
  3956. static::methodNotExists($entry, $method, $message);
  3957. }
  3958. }
  3959. /**
  3960. * @psalm-pure
  3961. * @psalm-param iterable<class-string|object|null> $classOrObject
  3962. *
  3963. * @param iterable<string|object|null> $classOrObject
  3964. * @param mixed $method
  3965. * @param string $message
  3966. *
  3967. * @throws InvalidArgumentException
  3968. *
  3969. * @return void
  3970. */
  3971. public static function allNullOrMethodNotExists($classOrObject, $method, $message = '')
  3972. {
  3973. static::isIterable($classOrObject);
  3974. foreach ($classOrObject as $entry) {
  3975. null === $entry || static::methodNotExists($entry, $method, $message);
  3976. }
  3977. }
  3978. /**
  3979. * @psalm-pure
  3980. *
  3981. * @param array|null $array
  3982. * @param string|int $key
  3983. * @param string $message
  3984. *
  3985. * @throws InvalidArgumentException
  3986. *
  3987. * @return void
  3988. */
  3989. public static function nullOrKeyExists($array, $key, $message = '')
  3990. {
  3991. null === $array || static::keyExists($array, $key, $message);
  3992. }
  3993. /**
  3994. * @psalm-pure
  3995. *
  3996. * @param iterable<array> $array
  3997. * @param string|int $key
  3998. * @param string $message
  3999. *
  4000. * @throws InvalidArgumentException
  4001. *
  4002. * @return void
  4003. */
  4004. public static function allKeyExists($array, $key, $message = '')
  4005. {
  4006. static::isIterable($array);
  4007. foreach ($array as $entry) {
  4008. static::keyExists($entry, $key, $message);
  4009. }
  4010. }
  4011. /**
  4012. * @psalm-pure
  4013. *
  4014. * @param iterable<array|null> $array
  4015. * @param string|int $key
  4016. * @param string $message
  4017. *
  4018. * @throws InvalidArgumentException
  4019. *
  4020. * @return void
  4021. */
  4022. public static function allNullOrKeyExists($array, $key, $message = '')
  4023. {
  4024. static::isIterable($array);
  4025. foreach ($array as $entry) {
  4026. null === $entry || static::keyExists($entry, $key, $message);
  4027. }
  4028. }
  4029. /**
  4030. * @psalm-pure
  4031. *
  4032. * @param array|null $array
  4033. * @param string|int $key
  4034. * @param string $message
  4035. *
  4036. * @throws InvalidArgumentException
  4037. *
  4038. * @return void
  4039. */
  4040. public static function nullOrKeyNotExists($array, $key, $message = '')
  4041. {
  4042. null === $array || static::keyNotExists($array, $key, $message);
  4043. }
  4044. /**
  4045. * @psalm-pure
  4046. *
  4047. * @param iterable<array> $array
  4048. * @param string|int $key
  4049. * @param string $message
  4050. *
  4051. * @throws InvalidArgumentException
  4052. *
  4053. * @return void
  4054. */
  4055. public static function allKeyNotExists($array, $key, $message = '')
  4056. {
  4057. static::isIterable($array);
  4058. foreach ($array as $entry) {
  4059. static::keyNotExists($entry, $key, $message);
  4060. }
  4061. }
  4062. /**
  4063. * @psalm-pure
  4064. *
  4065. * @param iterable<array|null> $array
  4066. * @param string|int $key
  4067. * @param string $message
  4068. *
  4069. * @throws InvalidArgumentException
  4070. *
  4071. * @return void
  4072. */
  4073. public static function allNullOrKeyNotExists($array, $key, $message = '')
  4074. {
  4075. static::isIterable($array);
  4076. foreach ($array as $entry) {
  4077. null === $entry || static::keyNotExists($entry, $key, $message);
  4078. }
  4079. }
  4080. /**
  4081. * @psalm-pure
  4082. * @psalm-assert array-key|null $value
  4083. *
  4084. * @param mixed $value
  4085. * @param string $message
  4086. *
  4087. * @throws InvalidArgumentException
  4088. *
  4089. * @return void
  4090. */
  4091. public static function nullOrValidArrayKey($value, $message = '')
  4092. {
  4093. null === $value || static::validArrayKey($value, $message);
  4094. }
  4095. /**
  4096. * @psalm-pure
  4097. * @psalm-assert iterable<array-key> $value
  4098. *
  4099. * @param mixed $value
  4100. * @param string $message
  4101. *
  4102. * @throws InvalidArgumentException
  4103. *
  4104. * @return void
  4105. */
  4106. public static function allValidArrayKey($value, $message = '')
  4107. {
  4108. static::isIterable($value);
  4109. foreach ($value as $entry) {
  4110. static::validArrayKey($entry, $message);
  4111. }
  4112. }
  4113. /**
  4114. * @psalm-pure
  4115. * @psalm-assert iterable<array-key|null> $value
  4116. *
  4117. * @param mixed $value
  4118. * @param string $message
  4119. *
  4120. * @throws InvalidArgumentException
  4121. *
  4122. * @return void
  4123. */
  4124. public static function allNullOrValidArrayKey($value, $message = '')
  4125. {
  4126. static::isIterable($value);
  4127. foreach ($value as $entry) {
  4128. null === $entry || static::validArrayKey($entry, $message);
  4129. }
  4130. }
  4131. /**
  4132. * @param Countable|array|null $array
  4133. * @param int $number
  4134. * @param string $message
  4135. *
  4136. * @throws InvalidArgumentException
  4137. *
  4138. * @return void
  4139. */
  4140. public static function nullOrCount($array, $number, $message = '')
  4141. {
  4142. null === $array || static::count($array, $number, $message);
  4143. }
  4144. /**
  4145. * @param iterable<Countable|array> $array
  4146. * @param int $number
  4147. * @param string $message
  4148. *
  4149. * @throws InvalidArgumentException
  4150. *
  4151. * @return void
  4152. */
  4153. public static function allCount($array, $number, $message = '')
  4154. {
  4155. static::isIterable($array);
  4156. foreach ($array as $entry) {
  4157. static::count($entry, $number, $message);
  4158. }
  4159. }
  4160. /**
  4161. * @param iterable<Countable|array|null> $array
  4162. * @param int $number
  4163. * @param string $message
  4164. *
  4165. * @throws InvalidArgumentException
  4166. *
  4167. * @return void
  4168. */
  4169. public static function allNullOrCount($array, $number, $message = '')
  4170. {
  4171. static::isIterable($array);
  4172. foreach ($array as $entry) {
  4173. null === $entry || static::count($entry, $number, $message);
  4174. }
  4175. }
  4176. /**
  4177. * @param Countable|array|null $array
  4178. * @param int|float $min
  4179. * @param string $message
  4180. *
  4181. * @throws InvalidArgumentException
  4182. *
  4183. * @return void
  4184. */
  4185. public static function nullOrMinCount($array, $min, $message = '')
  4186. {
  4187. null === $array || static::minCount($array, $min, $message);
  4188. }
  4189. /**
  4190. * @param iterable<Countable|array> $array
  4191. * @param int|float $min
  4192. * @param string $message
  4193. *
  4194. * @throws InvalidArgumentException
  4195. *
  4196. * @return void
  4197. */
  4198. public static function allMinCount($array, $min, $message = '')
  4199. {
  4200. static::isIterable($array);
  4201. foreach ($array as $entry) {
  4202. static::minCount($entry, $min, $message);
  4203. }
  4204. }
  4205. /**
  4206. * @param iterable<Countable|array|null> $array
  4207. * @param int|float $min
  4208. * @param string $message
  4209. *
  4210. * @throws InvalidArgumentException
  4211. *
  4212. * @return void
  4213. */
  4214. public static function allNullOrMinCount($array, $min, $message = '')
  4215. {
  4216. static::isIterable($array);
  4217. foreach ($array as $entry) {
  4218. null === $entry || static::minCount($entry, $min, $message);
  4219. }
  4220. }
  4221. /**
  4222. * @param Countable|array|null $array
  4223. * @param int|float $max
  4224. * @param string $message
  4225. *
  4226. * @throws InvalidArgumentException
  4227. *
  4228. * @return void
  4229. */
  4230. public static function nullOrMaxCount($array, $max, $message = '')
  4231. {
  4232. null === $array || static::maxCount($array, $max, $message);
  4233. }
  4234. /**
  4235. * @param iterable<Countable|array> $array
  4236. * @param int|float $max
  4237. * @param string $message
  4238. *
  4239. * @throws InvalidArgumentException
  4240. *
  4241. * @return void
  4242. */
  4243. public static function allMaxCount($array, $max, $message = '')
  4244. {
  4245. static::isIterable($array);
  4246. foreach ($array as $entry) {
  4247. static::maxCount($entry, $max, $message);
  4248. }
  4249. }
  4250. /**
  4251. * @param iterable<Countable|array|null> $array
  4252. * @param int|float $max
  4253. * @param string $message
  4254. *
  4255. * @throws InvalidArgumentException
  4256. *
  4257. * @return void
  4258. */
  4259. public static function allNullOrMaxCount($array, $max, $message = '')
  4260. {
  4261. static::isIterable($array);
  4262. foreach ($array as $entry) {
  4263. null === $entry || static::maxCount($entry, $max, $message);
  4264. }
  4265. }
  4266. /**
  4267. * @param Countable|array|null $array
  4268. * @param int|float $min
  4269. * @param int|float $max
  4270. * @param string $message
  4271. *
  4272. * @throws InvalidArgumentException
  4273. *
  4274. * @return void
  4275. */
  4276. public static function nullOrCountBetween($array, $min, $max, $message = '')
  4277. {
  4278. null === $array || static::countBetween($array, $min, $max, $message);
  4279. }
  4280. /**
  4281. * @param iterable<Countable|array> $array
  4282. * @param int|float $min
  4283. * @param int|float $max
  4284. * @param string $message
  4285. *
  4286. * @throws InvalidArgumentException
  4287. *
  4288. * @return void
  4289. */
  4290. public static function allCountBetween($array, $min, $max, $message = '')
  4291. {
  4292. static::isIterable($array);
  4293. foreach ($array as $entry) {
  4294. static::countBetween($entry, $min, $max, $message);
  4295. }
  4296. }
  4297. /**
  4298. * @param iterable<Countable|array|null> $array
  4299. * @param int|float $min
  4300. * @param int|float $max
  4301. * @param string $message
  4302. *
  4303. * @throws InvalidArgumentException
  4304. *
  4305. * @return void
  4306. */
  4307. public static function allNullOrCountBetween($array, $min, $max, $message = '')
  4308. {
  4309. static::isIterable($array);
  4310. foreach ($array as $entry) {
  4311. null === $entry || static::countBetween($entry, $min, $max, $message);
  4312. }
  4313. }
  4314. /**
  4315. * @psalm-pure
  4316. * @psalm-assert list|null $array
  4317. *
  4318. * @param mixed $array
  4319. * @param string $message
  4320. *
  4321. * @throws InvalidArgumentException
  4322. *
  4323. * @return void
  4324. */
  4325. public static function nullOrIsList($array, $message = '')
  4326. {
  4327. null === $array || static::isList($array, $message);
  4328. }
  4329. /**
  4330. * @psalm-pure
  4331. * @psalm-assert iterable<list> $array
  4332. *
  4333. * @param mixed $array
  4334. * @param string $message
  4335. *
  4336. * @throws InvalidArgumentException
  4337. *
  4338. * @return void
  4339. */
  4340. public static function allIsList($array, $message = '')
  4341. {
  4342. static::isIterable($array);
  4343. foreach ($array as $entry) {
  4344. static::isList($entry, $message);
  4345. }
  4346. }
  4347. /**
  4348. * @psalm-pure
  4349. * @psalm-assert iterable<list|null> $array
  4350. *
  4351. * @param mixed $array
  4352. * @param string $message
  4353. *
  4354. * @throws InvalidArgumentException
  4355. *
  4356. * @return void
  4357. */
  4358. public static function allNullOrIsList($array, $message = '')
  4359. {
  4360. static::isIterable($array);
  4361. foreach ($array as $entry) {
  4362. null === $entry || static::isList($entry, $message);
  4363. }
  4364. }
  4365. /**
  4366. * @psalm-pure
  4367. * @psalm-assert non-empty-list|null $array
  4368. *
  4369. * @param mixed $array
  4370. * @param string $message
  4371. *
  4372. * @throws InvalidArgumentException
  4373. *
  4374. * @return void
  4375. */
  4376. public static function nullOrIsNonEmptyList($array, $message = '')
  4377. {
  4378. null === $array || static::isNonEmptyList($array, $message);
  4379. }
  4380. /**
  4381. * @psalm-pure
  4382. * @psalm-assert iterable<non-empty-list> $array
  4383. *
  4384. * @param mixed $array
  4385. * @param string $message
  4386. *
  4387. * @throws InvalidArgumentException
  4388. *
  4389. * @return void
  4390. */
  4391. public static function allIsNonEmptyList($array, $message = '')
  4392. {
  4393. static::isIterable($array);
  4394. foreach ($array as $entry) {
  4395. static::isNonEmptyList($entry, $message);
  4396. }
  4397. }
  4398. /**
  4399. * @psalm-pure
  4400. * @psalm-assert iterable<non-empty-list|null> $array
  4401. *
  4402. * @param mixed $array
  4403. * @param string $message
  4404. *
  4405. * @throws InvalidArgumentException
  4406. *
  4407. * @return void
  4408. */
  4409. public static function allNullOrIsNonEmptyList($array, $message = '')
  4410. {
  4411. static::isIterable($array);
  4412. foreach ($array as $entry) {
  4413. null === $entry || static::isNonEmptyList($entry, $message);
  4414. }
  4415. }
  4416. /**
  4417. * @psalm-pure
  4418. * @psalm-template T
  4419. * @psalm-param mixed|array<T>|null $array
  4420. * @psalm-assert array<string, T>|null $array
  4421. *
  4422. * @param mixed $array
  4423. * @param string $message
  4424. *
  4425. * @throws InvalidArgumentException
  4426. *
  4427. * @return void
  4428. */
  4429. public static function nullOrIsMap($array, $message = '')
  4430. {
  4431. null === $array || static::isMap($array, $message);
  4432. }
  4433. /**
  4434. * @psalm-pure
  4435. * @psalm-template T
  4436. * @psalm-param iterable<mixed|array<T>> $array
  4437. * @psalm-assert iterable<array<string, T>> $array
  4438. *
  4439. * @param mixed $array
  4440. * @param string $message
  4441. *
  4442. * @throws InvalidArgumentException
  4443. *
  4444. * @return void
  4445. */
  4446. public static function allIsMap($array, $message = '')
  4447. {
  4448. static::isIterable($array);
  4449. foreach ($array as $entry) {
  4450. static::isMap($entry, $message);
  4451. }
  4452. }
  4453. /**
  4454. * @psalm-pure
  4455. * @psalm-template T
  4456. * @psalm-param iterable<mixed|array<T>|null> $array
  4457. * @psalm-assert iterable<array<string, T>|null> $array
  4458. *
  4459. * @param mixed $array
  4460. * @param string $message
  4461. *
  4462. * @throws InvalidArgumentException
  4463. *
  4464. * @return void
  4465. */
  4466. public static function allNullOrIsMap($array, $message = '')
  4467. {
  4468. static::isIterable($array);
  4469. foreach ($array as $entry) {
  4470. null === $entry || static::isMap($entry, $message);
  4471. }
  4472. }
  4473. /**
  4474. * @psalm-pure
  4475. * @psalm-template T
  4476. * @psalm-param mixed|array<T>|null $array
  4477. *
  4478. * @param mixed $array
  4479. * @param string $message
  4480. *
  4481. * @throws InvalidArgumentException
  4482. *
  4483. * @return void
  4484. */
  4485. public static function nullOrIsNonEmptyMap($array, $message = '')
  4486. {
  4487. null === $array || static::isNonEmptyMap($array, $message);
  4488. }
  4489. /**
  4490. * @psalm-pure
  4491. * @psalm-template T
  4492. * @psalm-param iterable<mixed|array<T>> $array
  4493. *
  4494. * @param mixed $array
  4495. * @param string $message
  4496. *
  4497. * @throws InvalidArgumentException
  4498. *
  4499. * @return void
  4500. */
  4501. public static function allIsNonEmptyMap($array, $message = '')
  4502. {
  4503. static::isIterable($array);
  4504. foreach ($array as $entry) {
  4505. static::isNonEmptyMap($entry, $message);
  4506. }
  4507. }
  4508. /**
  4509. * @psalm-pure
  4510. * @psalm-template T
  4511. * @psalm-param iterable<mixed|array<T>|null> $array
  4512. * @psalm-assert iterable<array<string, T>|null> $array
  4513. * @psalm-assert iterable<!empty|null> $array
  4514. *
  4515. * @param mixed $array
  4516. * @param string $message
  4517. *
  4518. * @throws InvalidArgumentException
  4519. *
  4520. * @return void
  4521. */
  4522. public static function allNullOrIsNonEmptyMap($array, $message = '')
  4523. {
  4524. static::isIterable($array);
  4525. foreach ($array as $entry) {
  4526. null === $entry || static::isNonEmptyMap($entry, $message);
  4527. }
  4528. }
  4529. /**
  4530. * @psalm-pure
  4531. *
  4532. * @param string|null $value
  4533. * @param string $message
  4534. *
  4535. * @throws InvalidArgumentException
  4536. *
  4537. * @return void
  4538. */
  4539. public static function nullOrUuid($value, $message = '')
  4540. {
  4541. null === $value || static::uuid($value, $message);
  4542. }
  4543. /**
  4544. * @psalm-pure
  4545. *
  4546. * @param iterable<string> $value
  4547. * @param string $message
  4548. *
  4549. * @throws InvalidArgumentException
  4550. *
  4551. * @return void
  4552. */
  4553. public static function allUuid($value, $message = '')
  4554. {
  4555. static::isIterable($value);
  4556. foreach ($value as $entry) {
  4557. static::uuid($entry, $message);
  4558. }
  4559. }
  4560. /**
  4561. * @psalm-pure
  4562. *
  4563. * @param iterable<string|null> $value
  4564. * @param string $message
  4565. *
  4566. * @throws InvalidArgumentException
  4567. *
  4568. * @return void
  4569. */
  4570. public static function allNullOrUuid($value, $message = '')
  4571. {
  4572. static::isIterable($value);
  4573. foreach ($value as $entry) {
  4574. null === $entry || static::uuid($entry, $message);
  4575. }
  4576. }
  4577. /**
  4578. * @psalm-param class-string<Throwable> $class
  4579. *
  4580. * @param Closure|null $expression
  4581. * @param string $class
  4582. * @param string $message
  4583. *
  4584. * @throws InvalidArgumentException
  4585. *
  4586. * @return void
  4587. */
  4588. public static function nullOrThrows($expression, $class = 'Exception', $message = '')
  4589. {
  4590. null === $expression || static::throws($expression, $class, $message);
  4591. }
  4592. /**
  4593. * @psalm-param class-string<Throwable> $class
  4594. *
  4595. * @param iterable<Closure> $expression
  4596. * @param string $class
  4597. * @param string $message
  4598. *
  4599. * @throws InvalidArgumentException
  4600. *
  4601. * @return void
  4602. */
  4603. public static function allThrows($expression, $class = 'Exception', $message = '')
  4604. {
  4605. static::isIterable($expression);
  4606. foreach ($expression as $entry) {
  4607. static::throws($entry, $class, $message);
  4608. }
  4609. }
  4610. /**
  4611. * @psalm-param class-string<Throwable> $class
  4612. *
  4613. * @param iterable<Closure|null> $expression
  4614. * @param string $class
  4615. * @param string $message
  4616. *
  4617. * @throws InvalidArgumentException
  4618. *
  4619. * @return void
  4620. */
  4621. public static function allNullOrThrows($expression, $class = 'Exception', $message = '')
  4622. {
  4623. static::isIterable($expression);
  4624. foreach ($expression as $entry) {
  4625. null === $entry || static::throws($entry, $class, $message);
  4626. }
  4627. }
  4628. }