URLEncoding.html 60 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <title>URLEncoding Structure Reference</title>
  5. <link rel="stylesheet" type="text/css" href="../css/jazzy.css" />
  6. <link rel="stylesheet" type="text/css" href="../css/highlight.css" />
  7. <meta charset="utf-8">
  8. <script src="../js/jquery.min.js" defer></script>
  9. <script src="../js/jazzy.js" defer></script>
  10. <script src="../js/lunr.min.js" defer></script>
  11. <script src="../js/typeahead.jquery.js" defer></script>
  12. <script src="../js/jazzy.search.js" defer></script>
  13. </head>
  14. <body>
  15. <a name="//apple_ref/swift/Struct/URLEncoding" class="dashAnchor"></a>
  16. <a title="URLEncoding Structure Reference"></a>
  17. <header class="header">
  18. <p class="header-col header-col--primary">
  19. <a class="header-link" href="../index.html">
  20. Alamofire 5.11.0 Docs
  21. </a>
  22. (96% documented)
  23. </p>
  24. <div class="header-col--secondary">
  25. <form role="search" action="../search.json">
  26. <input type="text" placeholder="Search documentation" data-typeahead>
  27. </form>
  28. </div>
  29. <p class="header-col header-col--secondary">
  30. <a class="header-link" href="https://github.com/Alamofire/Alamofire">
  31. <img class="header-icon" src="../img/gh.png" alt="GitHub"/>
  32. View on GitHub
  33. </a>
  34. </p>
  35. <p class="header-col header-col--secondary">
  36. <a class="header-link" href="dash-feed://https%3A%2F%2Falamofire.github.io%2FAlamofire%2Fdocsets%2FAlamofire.xml">
  37. <img class="header-icon" src="../img/dash.png" alt="Dash"/>
  38. Install in Dash
  39. </a>
  40. </p>
  41. </header>
  42. <p class="breadcrumbs">
  43. <a class="breadcrumb" href="../index.html">Alamofire</a>
  44. <img class="carat" src="../img/carat.png" alt=""/>
  45. <a class="breadcrumb" href="../Structs.html">Structures</a>
  46. <img class="carat" src="../img/carat.png" alt=""/>
  47. URLEncoding Structure Reference
  48. </p>
  49. <div class="content-wrapper">
  50. <nav class="navigation">
  51. <ul class="nav-groups">
  52. <li class="nav-group-name">
  53. <a class="nav-group-name-link" href="../Classes.html">Classes</a>
  54. <ul class="nav-group-tasks">
  55. <li class="nav-group-task">
  56. <a class="nav-group-task-link" href="../Classes/Adapter.html">Adapter</a>
  57. </li>
  58. <li class="nav-group-task">
  59. <a class="nav-group-task-link" href="../Classes/AlamofireNotifications.html">AlamofireNotifications</a>
  60. </li>
  61. <li class="nav-group-task">
  62. <a class="nav-group-task-link" href="../Classes/AuthenticationInterceptor.html">AuthenticationInterceptor</a>
  63. </li>
  64. <li class="nav-group-task">
  65. <a class="nav-group-task-link" href="../Classes/AuthenticationInterceptor/RefreshWindow.html">– RefreshWindow</a>
  66. </li>
  67. <li class="nav-group-task">
  68. <a class="nav-group-task-link" href="../Classes/ClosureEventMonitor.html">ClosureEventMonitor</a>
  69. </li>
  70. <li class="nav-group-task">
  71. <a class="nav-group-task-link" href="../Classes/CompositeEventMonitor.html">CompositeEventMonitor</a>
  72. </li>
  73. <li class="nav-group-task">
  74. <a class="nav-group-task-link" href="../Classes/CompositeTrustEvaluator.html">CompositeTrustEvaluator</a>
  75. </li>
  76. <li class="nav-group-task">
  77. <a class="nav-group-task-link" href="../Classes/ConnectionLostRetryPolicy.html">ConnectionLostRetryPolicy</a>
  78. </li>
  79. <li class="nav-group-task">
  80. <a class="nav-group-task-link" href="../Classes/DataRequest.html">DataRequest</a>
  81. </li>
  82. <li class="nav-group-task">
  83. <a class="nav-group-task-link" href="../Classes/DataResponseSerializer.html">DataResponseSerializer</a>
  84. </li>
  85. <li class="nav-group-task">
  86. <a class="nav-group-task-link" href="../Classes/DataStreamRequest.html">DataStreamRequest</a>
  87. </li>
  88. <li class="nav-group-task">
  89. <a class="nav-group-task-link" href="../Classes/DataStreamRequest/Stream.html">– Stream</a>
  90. </li>
  91. <li class="nav-group-task">
  92. <a class="nav-group-task-link" href="../Classes/DataStreamRequest/Event.html">– Event</a>
  93. </li>
  94. <li class="nav-group-task">
  95. <a class="nav-group-task-link" href="../Classes/DataStreamRequest/Completion.html">– Completion</a>
  96. </li>
  97. <li class="nav-group-task">
  98. <a class="nav-group-task-link" href="../Classes/DataStreamRequest/CancellationToken.html">– CancellationToken</a>
  99. </li>
  100. <li class="nav-group-task">
  101. <a class="nav-group-task-link" href="../Classes/DecodableResponseSerializer.html">DecodableResponseSerializer</a>
  102. </li>
  103. <li class="nav-group-task">
  104. <a class="nav-group-task-link" href="../Classes/DefaultTrustEvaluator.html">DefaultTrustEvaluator</a>
  105. </li>
  106. <li class="nav-group-task">
  107. <a class="nav-group-task-link" href="../Classes/DisabledTrustEvaluator.html">DisabledTrustEvaluator</a>
  108. </li>
  109. <li class="nav-group-task">
  110. <a class="nav-group-task-link" href="../Classes/DownloadRequest.html">DownloadRequest</a>
  111. </li>
  112. <li class="nav-group-task">
  113. <a class="nav-group-task-link" href="../Classes/DownloadRequest/Options.html">– Options</a>
  114. </li>
  115. <li class="nav-group-task">
  116. <a class="nav-group-task-link" href="../Classes/DownloadRequest/Downloadable.html">– Downloadable</a>
  117. </li>
  118. <li class="nav-group-task">
  119. <a class="nav-group-task-link" href="../Classes/Interceptor.html">Interceptor</a>
  120. </li>
  121. <li class="nav-group-task">
  122. <a class="nav-group-task-link" href="../Classes/JSONParameterEncoder.html">JSONParameterEncoder</a>
  123. </li>
  124. <li class="nav-group-task">
  125. <a class="nav-group-task-link" href="../Classes/JSONResponseSerializer.html">JSONResponseSerializer</a>
  126. </li>
  127. <li class="nav-group-task">
  128. <a class="nav-group-task-link" href="../Classes/MultipartFormData.html">MultipartFormData</a>
  129. </li>
  130. <li class="nav-group-task">
  131. <a class="nav-group-task-link" href="../Classes/NetworkReachabilityManager.html">NetworkReachabilityManager</a>
  132. </li>
  133. <li class="nav-group-task">
  134. <a class="nav-group-task-link" href="../Classes/NetworkReachabilityManager/NetworkReachabilityStatus.html">– NetworkReachabilityStatus</a>
  135. </li>
  136. <li class="nav-group-task">
  137. <a class="nav-group-task-link" href="../Classes/OfflineRetrier.html">OfflineRetrier</a>
  138. </li>
  139. <li class="nav-group-task">
  140. <a class="nav-group-task-link" href="../Classes/PinnedCertificatesTrustEvaluator.html">PinnedCertificatesTrustEvaluator</a>
  141. </li>
  142. <li class="nav-group-task">
  143. <a class="nav-group-task-link" href="../Classes/PublicKeysTrustEvaluator.html">PublicKeysTrustEvaluator</a>
  144. </li>
  145. <li class="nav-group-task">
  146. <a class="nav-group-task-link" href="../Classes/Request.html">Request</a>
  147. </li>
  148. <li class="nav-group-task">
  149. <a class="nav-group-task-link" href="../Classes/Request/State.html">– State</a>
  150. </li>
  151. <li class="nav-group-task">
  152. <a class="nav-group-task-link" href="../Classes/Request/ResponseDisposition.html">– ResponseDisposition</a>
  153. </li>
  154. <li class="nav-group-task">
  155. <a class="nav-group-task-link" href="../Classes/Retrier.html">Retrier</a>
  156. </li>
  157. <li class="nav-group-task">
  158. <a class="nav-group-task-link" href="../Classes/RetryPolicy.html">RetryPolicy</a>
  159. </li>
  160. <li class="nav-group-task">
  161. <a class="nav-group-task-link" href="../Classes/RevocationTrustEvaluator.html">RevocationTrustEvaluator</a>
  162. </li>
  163. <li class="nav-group-task">
  164. <a class="nav-group-task-link" href="../Classes/RevocationTrustEvaluator/Options.html">– Options</a>
  165. </li>
  166. <li class="nav-group-task">
  167. <a class="nav-group-task-link" href="../Classes/ServerTrustManager.html">ServerTrustManager</a>
  168. </li>
  169. <li class="nav-group-task">
  170. <a class="nav-group-task-link" href="../Classes/Session.html">Session</a>
  171. </li>
  172. <li class="nav-group-task">
  173. <a class="nav-group-task-link" href="../Classes/Session/RequestSetup.html">– RequestSetup</a>
  174. </li>
  175. <li class="nav-group-task">
  176. <a class="nav-group-task-link" href="../Classes/SessionDelegate.html">SessionDelegate</a>
  177. </li>
  178. <li class="nav-group-task">
  179. <a class="nav-group-task-link" href="../Classes/StringResponseSerializer.html">StringResponseSerializer</a>
  180. </li>
  181. <li class="nav-group-task">
  182. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder.html">URLEncodedFormEncoder</a>
  183. </li>
  184. <li class="nav-group-task">
  185. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/ArrayEncoding.html">– ArrayEncoding</a>
  186. </li>
  187. <li class="nav-group-task">
  188. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/BoolEncoding.html">– BoolEncoding</a>
  189. </li>
  190. <li class="nav-group-task">
  191. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/DataEncoding.html">– DataEncoding</a>
  192. </li>
  193. <li class="nav-group-task">
  194. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/DateEncoding.html">– DateEncoding</a>
  195. </li>
  196. <li class="nav-group-task">
  197. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/KeyEncoding.html">– KeyEncoding</a>
  198. </li>
  199. <li class="nav-group-task">
  200. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/KeyPathEncoding.html">– KeyPathEncoding</a>
  201. </li>
  202. <li class="nav-group-task">
  203. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/NilEncoding.html">– NilEncoding</a>
  204. </li>
  205. <li class="nav-group-task">
  206. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/SpaceEncoding.html">– SpaceEncoding</a>
  207. </li>
  208. <li class="nav-group-task">
  209. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/Error.html">– Error</a>
  210. </li>
  211. <li class="nav-group-task">
  212. <a class="nav-group-task-link" href="../Classes/URLEncodedFormParameterEncoder.html">URLEncodedFormParameterEncoder</a>
  213. </li>
  214. <li class="nav-group-task">
  215. <a class="nav-group-task-link" href="../Classes/URLEncodedFormParameterEncoder/Destination.html">– Destination</a>
  216. </li>
  217. <li class="nav-group-task">
  218. <a class="nav-group-task-link" href="../Classes/UploadRequest.html">UploadRequest</a>
  219. </li>
  220. <li class="nav-group-task">
  221. <a class="nav-group-task-link" href="../Classes/UploadRequest/Uploadable.html">– Uploadable</a>
  222. </li>
  223. </ul>
  224. </li>
  225. <li class="nav-group-name">
  226. <a class="nav-group-name-link" href="../Global%20Variables.html">Global Variables</a>
  227. <ul class="nav-group-tasks">
  228. <li class="nav-group-task">
  229. <a class="nav-group-task-link" href="../Global%20Variables.html#/s:9Alamofire2AFAA7SessionCvp">AF</a>
  230. </li>
  231. </ul>
  232. </li>
  233. <li class="nav-group-name">
  234. <a class="nav-group-name-link" href="../Enums.html">Enumerations</a>
  235. <ul class="nav-group-tasks">
  236. <li class="nav-group-task">
  237. <a class="nav-group-task-link" href="../Enums/AFError.html">AFError</a>
  238. </li>
  239. <li class="nav-group-task">
  240. <a class="nav-group-task-link" href="../Enums/AFError/MultipartEncodingFailureReason.html">– MultipartEncodingFailureReason</a>
  241. </li>
  242. <li class="nav-group-task">
  243. <a class="nav-group-task-link" href="../Enums/AFError/UnexpectedInputStreamLength.html">– UnexpectedInputStreamLength</a>
  244. </li>
  245. <li class="nav-group-task">
  246. <a class="nav-group-task-link" href="../Enums/AFError/ParameterEncodingFailureReason.html">– ParameterEncodingFailureReason</a>
  247. </li>
  248. <li class="nav-group-task">
  249. <a class="nav-group-task-link" href="../Enums/AFError/ParameterEncoderFailureReason.html">– ParameterEncoderFailureReason</a>
  250. </li>
  251. <li class="nav-group-task">
  252. <a class="nav-group-task-link" href="../Enums/AFError/ResponseValidationFailureReason.html">– ResponseValidationFailureReason</a>
  253. </li>
  254. <li class="nav-group-task">
  255. <a class="nav-group-task-link" href="../Enums/AFError/ResponseSerializationFailureReason.html">– ResponseSerializationFailureReason</a>
  256. </li>
  257. <li class="nav-group-task">
  258. <a class="nav-group-task-link" href="../Enums/AFError/ServerTrustFailureReason.html">– ServerTrustFailureReason</a>
  259. </li>
  260. <li class="nav-group-task">
  261. <a class="nav-group-task-link" href="../Enums/AFError/URLRequestValidationFailureReason.html">– URLRequestValidationFailureReason</a>
  262. </li>
  263. <li class="nav-group-task">
  264. <a class="nav-group-task-link" href="../Enums/AFInfo.html">AFInfo</a>
  265. </li>
  266. <li class="nav-group-task">
  267. <a class="nav-group-task-link" href="../Enums/AuthenticationError.html">AuthenticationError</a>
  268. </li>
  269. <li class="nav-group-task">
  270. <a class="nav-group-task-link" href="../Enums/RetryResult.html">RetryResult</a>
  271. </li>
  272. </ul>
  273. </li>
  274. <li class="nav-group-name">
  275. <a class="nav-group-name-link" href="../Extensions.html">Extensions</a>
  276. <ul class="nav-group-tasks">
  277. <li class="nav-group-task">
  278. <a class="nav-group-task-link" href="../Extensions.html#/s:Sa">Array</a>
  279. </li>
  280. <li class="nav-group-task">
  281. <a class="nav-group-task-link" href="../Extensions.html#/c:objc(cs)NSBundle">Bundle</a>
  282. </li>
  283. <li class="nav-group-task">
  284. <a class="nav-group-task-link" href="../Extensions/CharacterSet.html">CharacterSet</a>
  285. </li>
  286. <li class="nav-group-task">
  287. <a class="nav-group-task-link" href="../Extensions/Error.html">Error</a>
  288. </li>
  289. <li class="nav-group-task">
  290. <a class="nav-group-task-link" href="../Extensions/HTTPURLResponse.html">HTTPURLResponse</a>
  291. </li>
  292. <li class="nav-group-task">
  293. <a class="nav-group-task-link" href="../Extensions.html#/s:10Foundation11JSONDecoderC">JSONDecoder</a>
  294. </li>
  295. <li class="nav-group-task">
  296. <a class="nav-group-task-link" href="../Extensions/Notification.html">Notification</a>
  297. </li>
  298. <li class="nav-group-task">
  299. <a class="nav-group-task-link" href="../Extensions.html#/c:@T@OSStatus">OSStatus</a>
  300. </li>
  301. <li class="nav-group-task">
  302. <a class="nav-group-task-link" href="../Extensions.html#/s:10Foundation19PropertyListDecoderC">PropertyListDecoder</a>
  303. </li>
  304. <li class="nav-group-task">
  305. <a class="nav-group-task-link" href="../Extensions.html#/c:@T@SecCertificateRef">SecCertificate</a>
  306. </li>
  307. <li class="nav-group-task">
  308. <a class="nav-group-task-link" href="../Extensions.html#/c:@T@SecPolicyRef">SecPolicy</a>
  309. </li>
  310. <li class="nav-group-task">
  311. <a class="nav-group-task-link" href="../Extensions.html#/c:@T@SecTrustRef">SecTrust</a>
  312. </li>
  313. <li class="nav-group-task">
  314. <a class="nav-group-task-link" href="../Extensions.html#/c:@E@SecTrustResultType">SecTrustResultType</a>
  315. </li>
  316. <li class="nav-group-task">
  317. <a class="nav-group-task-link" href="../Extensions/String.html">String</a>
  318. </li>
  319. <li class="nav-group-task">
  320. <a class="nav-group-task-link" href="../Extensions/URL.html">URL</a>
  321. </li>
  322. <li class="nav-group-task">
  323. <a class="nav-group-task-link" href="../Extensions/URLComponents.html">URLComponents</a>
  324. </li>
  325. <li class="nav-group-task">
  326. <a class="nav-group-task-link" href="../Extensions/URLRequest.html">URLRequest</a>
  327. </li>
  328. <li class="nav-group-task">
  329. <a class="nav-group-task-link" href="../Extensions/URLSessionConfiguration.html">URLSessionConfiguration</a>
  330. </li>
  331. <li class="nav-group-task">
  332. <a class="nav-group-task-link" href="../Extensions/%5BServerTrustEvaluating%5D.html">[ServerTrustEvaluating]</a>
  333. </li>
  334. </ul>
  335. </li>
  336. <li class="nav-group-name">
  337. <a class="nav-group-name-link" href="../Protocols.html">Protocols</a>
  338. <ul class="nav-group-tasks">
  339. <li class="nav-group-task">
  340. <a class="nav-group-task-link" href="../Protocols/AlamofireExtended.html">AlamofireExtended</a>
  341. </li>
  342. <li class="nav-group-task">
  343. <a class="nav-group-task-link" href="../Protocols/AuthenticationCredential.html">AuthenticationCredential</a>
  344. </li>
  345. <li class="nav-group-task">
  346. <a class="nav-group-task-link" href="../Protocols/Authenticator.html">Authenticator</a>
  347. </li>
  348. <li class="nav-group-task">
  349. <a class="nav-group-task-link" href="../Protocols/CachedResponseHandler.html">CachedResponseHandler</a>
  350. </li>
  351. <li class="nav-group-task">
  352. <a class="nav-group-task-link" href="../Protocols/DataDecoder.html">DataDecoder</a>
  353. </li>
  354. <li class="nav-group-task">
  355. <a class="nav-group-task-link" href="../Protocols/DataPreprocessor.html">DataPreprocessor</a>
  356. </li>
  357. <li class="nav-group-task">
  358. <a class="nav-group-task-link" href="../Protocols/DataResponseSerializerProtocol.html">DataResponseSerializerProtocol</a>
  359. </li>
  360. <li class="nav-group-task">
  361. <a class="nav-group-task-link" href="../Protocols/DataStreamSerializer.html">DataStreamSerializer</a>
  362. </li>
  363. <li class="nav-group-task">
  364. <a class="nav-group-task-link" href="../Protocols/DownloadResponseSerializerProtocol.html">DownloadResponseSerializerProtocol</a>
  365. </li>
  366. <li class="nav-group-task">
  367. <a class="nav-group-task-link" href="../Protocols/EmptyResponse.html">EmptyResponse</a>
  368. </li>
  369. <li class="nav-group-task">
  370. <a class="nav-group-task-link" href="../Protocols/EventMonitor.html">EventMonitor</a>
  371. </li>
  372. <li class="nav-group-task">
  373. <a class="nav-group-task-link" href="../Protocols/ParameterEncoder.html">ParameterEncoder</a>
  374. </li>
  375. <li class="nav-group-task">
  376. <a class="nav-group-task-link" href="../Protocols/ParameterEncoding.html">ParameterEncoding</a>
  377. </li>
  378. <li class="nav-group-task">
  379. <a class="nav-group-task-link" href="../Protocols/RedirectHandler.html">RedirectHandler</a>
  380. </li>
  381. <li class="nav-group-task">
  382. <a class="nav-group-task-link" href="../Protocols/RequestAdapter.html">RequestAdapter</a>
  383. </li>
  384. <li class="nav-group-task">
  385. <a class="nav-group-task-link" href="../Protocols/RequestDelegate.html">RequestDelegate</a>
  386. </li>
  387. <li class="nav-group-task">
  388. <a class="nav-group-task-link" href="../Protocols/RequestInterceptor.html">RequestInterceptor</a>
  389. </li>
  390. <li class="nav-group-task">
  391. <a class="nav-group-task-link" href="../Protocols/RequestRetrier.html">RequestRetrier</a>
  392. </li>
  393. <li class="nav-group-task">
  394. <a class="nav-group-task-link" href="../Protocols/ResponseSerializer.html">ResponseSerializer</a>
  395. </li>
  396. <li class="nav-group-task">
  397. <a class="nav-group-task-link" href="../Protocols/ServerTrustEvaluating.html">ServerTrustEvaluating</a>
  398. </li>
  399. <li class="nav-group-task">
  400. <a class="nav-group-task-link" href="../Protocols/URLConvertible.html">URLConvertible</a>
  401. </li>
  402. <li class="nav-group-task">
  403. <a class="nav-group-task-link" href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a>
  404. </li>
  405. <li class="nav-group-task">
  406. <a class="nav-group-task-link" href="../Protocols.html#/s:9Alamofire17UploadConvertibleP">UploadConvertible</a>
  407. </li>
  408. <li class="nav-group-task">
  409. <a class="nav-group-task-link" href="../Protocols/UploadableConvertible.html">UploadableConvertible</a>
  410. </li>
  411. <li class="nav-group-task">
  412. <a class="nav-group-task-link" href="../Protocols/WebSocketMessageSerializer.html">WebSocketMessageSerializer</a>
  413. </li>
  414. </ul>
  415. </li>
  416. <li class="nav-group-name">
  417. <a class="nav-group-name-link" href="../Structs.html">Structures</a>
  418. <ul class="nav-group-tasks">
  419. <li class="nav-group-task">
  420. <a class="nav-group-task-link" href="../Structs/AlamofireExtension.html">AlamofireExtension</a>
  421. </li>
  422. <li class="nav-group-task">
  423. <a class="nav-group-task-link" href="../Structs/DataResponse.html">DataResponse</a>
  424. </li>
  425. <li class="nav-group-task">
  426. <a class="nav-group-task-link" href="../Structs/DataResponsePublisher.html">DataResponsePublisher</a>
  427. </li>
  428. <li class="nav-group-task">
  429. <a class="nav-group-task-link" href="../Structs/DataStreamPublisher.html">DataStreamPublisher</a>
  430. </li>
  431. <li class="nav-group-task">
  432. <a class="nav-group-task-link" href="../Structs/DataStreamTask.html">DataStreamTask</a>
  433. </li>
  434. <li class="nav-group-task">
  435. <a class="nav-group-task-link" href="../Structs/DataTask.html">DataTask</a>
  436. </li>
  437. <li class="nav-group-task">
  438. <a class="nav-group-task-link" href="../Structs/DecodableStreamSerializer.html">DecodableStreamSerializer</a>
  439. </li>
  440. <li class="nav-group-task">
  441. <a class="nav-group-task-link" href="../Structs/DecodableWebSocketMessageDecoder.html">DecodableWebSocketMessageDecoder</a>
  442. </li>
  443. <li class="nav-group-task">
  444. <a class="nav-group-task-link" href="../Structs/DecodableWebSocketMessageDecoder/Error.html">– Error</a>
  445. </li>
  446. <li class="nav-group-task">
  447. <a class="nav-group-task-link" href="../Structs/DeflateRequestCompressor.html">DeflateRequestCompressor</a>
  448. </li>
  449. <li class="nav-group-task">
  450. <a class="nav-group-task-link" href="../Structs/DeflateRequestCompressor/DuplicateHeaderBehavior.html">– DuplicateHeaderBehavior</a>
  451. </li>
  452. <li class="nav-group-task">
  453. <a class="nav-group-task-link" href="../Structs/DeflateRequestCompressor.html#/s:9Alamofire24DeflateRequestCompressorV20DuplicateHeaderErrorV">– DuplicateHeaderError</a>
  454. </li>
  455. <li class="nav-group-task">
  456. <a class="nav-group-task-link" href="../Structs/DownloadResponse.html">DownloadResponse</a>
  457. </li>
  458. <li class="nav-group-task">
  459. <a class="nav-group-task-link" href="../Structs/DownloadResponsePublisher.html">DownloadResponsePublisher</a>
  460. </li>
  461. <li class="nav-group-task">
  462. <a class="nav-group-task-link" href="../Structs/DownloadTask.html">DownloadTask</a>
  463. </li>
  464. <li class="nav-group-task">
  465. <a class="nav-group-task-link" href="../Structs/Empty.html">Empty</a>
  466. </li>
  467. <li class="nav-group-task">
  468. <a class="nav-group-task-link" href="../Structs/GoogleXSSIPreprocessor.html">GoogleXSSIPreprocessor</a>
  469. </li>
  470. <li class="nav-group-task">
  471. <a class="nav-group-task-link" href="../Structs/HTTPHeader.html">HTTPHeader</a>
  472. </li>
  473. <li class="nav-group-task">
  474. <a class="nav-group-task-link" href="../Structs/HTTPHeaders.html">HTTPHeaders</a>
  475. </li>
  476. <li class="nav-group-task">
  477. <a class="nav-group-task-link" href="../Structs/HTTPMethod.html">HTTPMethod</a>
  478. </li>
  479. <li class="nav-group-task">
  480. <a class="nav-group-task-link" href="../Structs/JSONEncoding.html">JSONEncoding</a>
  481. </li>
  482. <li class="nav-group-task">
  483. <a class="nav-group-task-link" href="../Structs/JSONEncoding/Error.html">– Error</a>
  484. </li>
  485. <li class="nav-group-task">
  486. <a class="nav-group-task-link" href="../Structs/PassthroughPreprocessor.html">PassthroughPreprocessor</a>
  487. </li>
  488. <li class="nav-group-task">
  489. <a class="nav-group-task-link" href="../Structs/PassthroughStreamSerializer.html">PassthroughStreamSerializer</a>
  490. </li>
  491. <li class="nav-group-task">
  492. <a class="nav-group-task-link" href="../Structs/Redirector.html">Redirector</a>
  493. </li>
  494. <li class="nav-group-task">
  495. <a class="nav-group-task-link" href="../Structs/Redirector/Behavior.html">– Behavior</a>
  496. </li>
  497. <li class="nav-group-task">
  498. <a class="nav-group-task-link" href="../Structs/RequestAdapterState.html">RequestAdapterState</a>
  499. </li>
  500. <li class="nav-group-task">
  501. <a class="nav-group-task-link" href="../Structs/ResponseCacher.html">ResponseCacher</a>
  502. </li>
  503. <li class="nav-group-task">
  504. <a class="nav-group-task-link" href="../Structs/ResponseCacher/Behavior.html">– Behavior</a>
  505. </li>
  506. <li class="nav-group-task">
  507. <a class="nav-group-task-link" href="../Structs/StreamOf.html">StreamOf</a>
  508. </li>
  509. <li class="nav-group-task">
  510. <a class="nav-group-task-link" href="../Structs/StreamOf/Iterator.html">– Iterator</a>
  511. </li>
  512. <li class="nav-group-task">
  513. <a class="nav-group-task-link" href="../Structs/StringStreamSerializer.html">StringStreamSerializer</a>
  514. </li>
  515. <li class="nav-group-task">
  516. <a class="nav-group-task-link" href="../Structs/URLEncoding.html">URLEncoding</a>
  517. </li>
  518. <li class="nav-group-task">
  519. <a class="nav-group-task-link" href="../Structs/URLEncoding/Destination.html">– Destination</a>
  520. </li>
  521. <li class="nav-group-task">
  522. <a class="nav-group-task-link" href="../Structs/URLEncoding/ArrayEncoding.html">– ArrayEncoding</a>
  523. </li>
  524. <li class="nav-group-task">
  525. <a class="nav-group-task-link" href="../Structs/URLEncoding/BoolEncoding.html">– BoolEncoding</a>
  526. </li>
  527. <li class="nav-group-task">
  528. <a class="nav-group-task-link" href="../Structs/URLResponseSerializer.html">URLResponseSerializer</a>
  529. </li>
  530. </ul>
  531. </li>
  532. <li class="nav-group-name">
  533. <a class="nav-group-name-link" href="../Typealiases.html">Type Aliases</a>
  534. <ul class="nav-group-tasks">
  535. <li class="nav-group-task">
  536. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire14AFDataResponsea">AFDataResponse</a>
  537. </li>
  538. <li class="nav-group-task">
  539. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire18AFDownloadResponsea">AFDownloadResponse</a>
  540. </li>
  541. <li class="nav-group-task">
  542. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire8AFResulta">AFResult</a>
  543. </li>
  544. <li class="nav-group-task">
  545. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire12AdaptHandlera">AdaptHandler</a>
  546. </li>
  547. <li class="nav-group-task">
  548. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire17DisabledEvaluatora">DisabledEvaluator</a>
  549. </li>
  550. <li class="nav-group-task">
  551. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a>
  552. </li>
  553. <li class="nav-group-task">
  554. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire12RetryHandlera">RetryHandler</a>
  555. </li>
  556. </ul>
  557. </li>
  558. </ul>
  559. </nav>
  560. <article class="main-content">
  561. <section class="section">
  562. <div class="section-content top-matter">
  563. <h1>URLEncoding</h1>
  564. <div class="declaration">
  565. <div class="language">
  566. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">struct</span> <span class="kt">URLEncoding</span> <span class="p">:</span> <span class="kt"><a href="../Protocols/ParameterEncoding.html">ParameterEncoding</a></span></code></pre>
  567. </div>
  568. </div>
  569. <p>Creates a url-encoded query string to be set as or appended to any existing URL query string or set as the HTTP
  570. body of the URL request. Whether the query string is set or appended to any existing URL query string or set as
  571. the HTTP body depends on the destination of the encoding.</p>
  572. <p>The <code>Content-Type</code> HTTP header field of an encoded request with HTTP body is set to
  573. <code>application/x-www-form-urlencoded; charset=utf-8</code>.</p>
  574. <p>There is no published specification for how to encode collection types. By default the convention of appending
  575. <code>[]</code> to the key for array values (<code>foo[]=1&amp;foo[]=2</code>), and appending the key surrounded by square brackets for
  576. nested dictionary values (<code>foo[bar]=baz</code>) is used. Optionally, <code>ArrayEncoding</code> can be used to omit the
  577. square brackets appended to array keys.</p>
  578. <p><code>BoolEncoding</code> can be used to configure how boolean values are encoded. The default behavior is to encode
  579. <code>true</code> as 1 and <code>false</code> as 0.</p>
  580. </div>
  581. </section>
  582. <section class="section">
  583. <div class="section-content">
  584. <div class="task-group">
  585. <div class="task-name-container">
  586. <a name="/Helper%20Types"></a>
  587. <a name="//apple_ref/swift/Section/Helper Types" class="dashAnchor"></a>
  588. <div class="section-name-container">
  589. <a class="section-name-link" href="#/Helper%20Types"></a>
  590. <h3 class="section-name"><span>Helper Types</span>
  591. </h3>
  592. </div>
  593. </div>
  594. <ul class="item-container">
  595. <li class="item">
  596. <div>
  597. <code>
  598. <a name="/s:9Alamofire11URLEncodingV11DestinationO"></a>
  599. <a name="//apple_ref/swift/Enum/Destination" class="dashAnchor"></a>
  600. <a class="token" href="#/s:9Alamofire11URLEncodingV11DestinationO">Destination</a>
  601. </code>
  602. </div>
  603. <div class="height-container">
  604. <div class="pointer-container"></div>
  605. <section class="section">
  606. <div class="pointer"></div>
  607. <div class="abstract">
  608. <p>Defines whether the url-encoded query string is applied to the existing query string or HTTP body of the
  609. resulting URL request.</p>
  610. <a href="../Structs/URLEncoding/Destination.html" class="slightly-smaller">See more</a>
  611. </div>
  612. <div class="declaration">
  613. <h4>Declaration</h4>
  614. <div class="language">
  615. <p class="aside-title">Swift</p>
  616. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">enum</span> <span class="kt">Destination</span> <span class="p">:</span> <span class="kt">Sendable</span></code></pre>
  617. </div>
  618. </div>
  619. </section>
  620. </div>
  621. </li>
  622. <li class="item">
  623. <div>
  624. <code>
  625. <a name="/s:9Alamofire11URLEncodingV13ArrayEncodingO"></a>
  626. <a name="//apple_ref/swift/Enum/ArrayEncoding" class="dashAnchor"></a>
  627. <a class="token" href="#/s:9Alamofire11URLEncodingV13ArrayEncodingO">ArrayEncoding</a>
  628. </code>
  629. </div>
  630. <div class="height-container">
  631. <div class="pointer-container"></div>
  632. <section class="section">
  633. <div class="pointer"></div>
  634. <div class="abstract">
  635. <p>Configures how <code>Array</code> parameters are encoded.</p>
  636. <a href="../Structs/URLEncoding/ArrayEncoding.html" class="slightly-smaller">See more</a>
  637. </div>
  638. <div class="declaration">
  639. <h4>Declaration</h4>
  640. <div class="language">
  641. <p class="aside-title">Swift</p>
  642. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">enum</span> <span class="kt">ArrayEncoding</span> <span class="p">:</span> <span class="kt">Sendable</span></code></pre>
  643. </div>
  644. </div>
  645. </section>
  646. </div>
  647. </li>
  648. <li class="item">
  649. <div>
  650. <code>
  651. <a name="/s:9Alamofire11URLEncodingV12BoolEncodingO"></a>
  652. <a name="//apple_ref/swift/Enum/BoolEncoding" class="dashAnchor"></a>
  653. <a class="token" href="#/s:9Alamofire11URLEncodingV12BoolEncodingO">BoolEncoding</a>
  654. </code>
  655. </div>
  656. <div class="height-container">
  657. <div class="pointer-container"></div>
  658. <section class="section">
  659. <div class="pointer"></div>
  660. <div class="abstract">
  661. <p>Configures how <code>Bool</code> parameters are encoded.</p>
  662. <a href="../Structs/URLEncoding/BoolEncoding.html" class="slightly-smaller">See more</a>
  663. </div>
  664. <div class="declaration">
  665. <h4>Declaration</h4>
  666. <div class="language">
  667. <p class="aside-title">Swift</p>
  668. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">enum</span> <span class="kt">BoolEncoding</span> <span class="p">:</span> <span class="kt">Sendable</span></code></pre>
  669. </div>
  670. </div>
  671. </section>
  672. </div>
  673. </li>
  674. </ul>
  675. </div>
  676. <div class="task-group">
  677. <div class="task-name-container">
  678. <a name="/Properties"></a>
  679. <a name="//apple_ref/swift/Section/Properties" class="dashAnchor"></a>
  680. <div class="section-name-container">
  681. <a class="section-name-link" href="#/Properties"></a>
  682. <h3 class="section-name"><span>Properties</span>
  683. </h3>
  684. </div>
  685. </div>
  686. <ul class="item-container">
  687. <li class="item">
  688. <div>
  689. <code>
  690. <a name="/s:9Alamofire11URLEncodingV7defaultACvpZ"></a>
  691. <a name="//apple_ref/swift/Variable/default" class="dashAnchor"></a>
  692. <a class="token" href="#/s:9Alamofire11URLEncodingV7defaultACvpZ">default</a>
  693. </code>
  694. </div>
  695. <div class="height-container">
  696. <div class="pointer-container"></div>
  697. <section class="section">
  698. <div class="pointer"></div>
  699. <div class="abstract">
  700. <p>Returns a default <code>URLEncoding</code> instance with a <code>.methodDependent</code> destination.</p>
  701. </div>
  702. <div class="declaration">
  703. <h4>Declaration</h4>
  704. <div class="language">
  705. <p class="aside-title">Swift</p>
  706. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">var</span> <span class="p">`</span><span class="nv">default</span><span class="p">`:</span> <span class="kt">URLEncoding</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>
  707. </div>
  708. </div>
  709. </section>
  710. </div>
  711. </li>
  712. <li class="item">
  713. <div>
  714. <code>
  715. <a name="/s:9Alamofire11URLEncodingV11queryStringACvpZ"></a>
  716. <a name="//apple_ref/swift/Variable/queryString" class="dashAnchor"></a>
  717. <a class="token" href="#/s:9Alamofire11URLEncodingV11queryStringACvpZ">queryString</a>
  718. </code>
  719. </div>
  720. <div class="height-container">
  721. <div class="pointer-container"></div>
  722. <section class="section">
  723. <div class="pointer"></div>
  724. <div class="abstract">
  725. <p>Returns a <code>URLEncoding</code> instance with a <code>.queryString</code> destination.</p>
  726. </div>
  727. <div class="declaration">
  728. <h4>Declaration</h4>
  729. <div class="language">
  730. <p class="aside-title">Swift</p>
  731. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="k">var</span> <span class="nv">queryString</span><span class="p">:</span> <span class="kt">URLEncoding</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>
  732. </div>
  733. </div>
  734. </section>
  735. </div>
  736. </li>
  737. <li class="item">
  738. <div>
  739. <code>
  740. <a name="/s:9Alamofire11URLEncodingV8httpBodyACvpZ"></a>
  741. <a name="//apple_ref/swift/Variable/httpBody" class="dashAnchor"></a>
  742. <a class="token" href="#/s:9Alamofire11URLEncodingV8httpBodyACvpZ">httpBody</a>
  743. </code>
  744. </div>
  745. <div class="height-container">
  746. <div class="pointer-container"></div>
  747. <section class="section">
  748. <div class="pointer"></div>
  749. <div class="abstract">
  750. <p>Returns a <code>URLEncoding</code> instance with an <code>.httpBody</code> destination.</p>
  751. </div>
  752. <div class="declaration">
  753. <h4>Declaration</h4>
  754. <div class="language">
  755. <p class="aside-title">Swift</p>
  756. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="k">var</span> <span class="nv">httpBody</span><span class="p">:</span> <span class="kt">URLEncoding</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>
  757. </div>
  758. </div>
  759. </section>
  760. </div>
  761. </li>
  762. <li class="item">
  763. <div>
  764. <code>
  765. <a name="/s:9Alamofire11URLEncodingV11destinationAC11DestinationOvp"></a>
  766. <a name="//apple_ref/swift/Property/destination" class="dashAnchor"></a>
  767. <a class="token" href="#/s:9Alamofire11URLEncodingV11destinationAC11DestinationOvp">destination</a>
  768. </code>
  769. </div>
  770. <div class="height-container">
  771. <div class="pointer-container"></div>
  772. <section class="section">
  773. <div class="pointer"></div>
  774. <div class="abstract">
  775. <p>The destination defining where the encoded query string is to be applied to the URL request.</p>
  776. </div>
  777. <div class="declaration">
  778. <h4>Declaration</h4>
  779. <div class="language">
  780. <p class="aside-title">Swift</p>
  781. <pre class="highlight swift"><code><span class="kd">public</span> <span class="k">let</span> <span class="nv">destination</span><span class="p">:</span> <span class="kt"><a href="../Structs/URLEncoding/Destination.html">Destination</a></span></code></pre>
  782. </div>
  783. </div>
  784. </section>
  785. </div>
  786. </li>
  787. <li class="item">
  788. <div>
  789. <code>
  790. <a name="/s:9Alamofire11URLEncodingV13arrayEncodingAC05ArrayD0Ovp"></a>
  791. <a name="//apple_ref/swift/Property/arrayEncoding" class="dashAnchor"></a>
  792. <a class="token" href="#/s:9Alamofire11URLEncodingV13arrayEncodingAC05ArrayD0Ovp">arrayEncoding</a>
  793. </code>
  794. </div>
  795. <div class="height-container">
  796. <div class="pointer-container"></div>
  797. <section class="section">
  798. <div class="pointer"></div>
  799. <div class="abstract">
  800. <p>The encoding to use for <code>Array</code> parameters.</p>
  801. </div>
  802. <div class="declaration">
  803. <h4>Declaration</h4>
  804. <div class="language">
  805. <p class="aside-title">Swift</p>
  806. <pre class="highlight swift"><code><span class="kd">public</span> <span class="k">let</span> <span class="nv">arrayEncoding</span><span class="p">:</span> <span class="kt"><a href="../Structs/URLEncoding/ArrayEncoding.html">ArrayEncoding</a></span></code></pre>
  807. </div>
  808. </div>
  809. </section>
  810. </div>
  811. </li>
  812. <li class="item">
  813. <div>
  814. <code>
  815. <a name="/s:9Alamofire11URLEncodingV12boolEncodingAC04BoolD0Ovp"></a>
  816. <a name="//apple_ref/swift/Property/boolEncoding" class="dashAnchor"></a>
  817. <a class="token" href="#/s:9Alamofire11URLEncodingV12boolEncodingAC04BoolD0Ovp">boolEncoding</a>
  818. </code>
  819. </div>
  820. <div class="height-container">
  821. <div class="pointer-container"></div>
  822. <section class="section">
  823. <div class="pointer"></div>
  824. <div class="abstract">
  825. <p>The encoding to use for <code>Bool</code> parameters.</p>
  826. </div>
  827. <div class="declaration">
  828. <h4>Declaration</h4>
  829. <div class="language">
  830. <p class="aside-title">Swift</p>
  831. <pre class="highlight swift"><code><span class="kd">public</span> <span class="k">let</span> <span class="nv">boolEncoding</span><span class="p">:</span> <span class="kt"><a href="../Structs/URLEncoding/BoolEncoding.html">BoolEncoding</a></span></code></pre>
  832. </div>
  833. </div>
  834. </section>
  835. </div>
  836. </li>
  837. </ul>
  838. </div>
  839. <div class="task-group">
  840. <div class="task-name-container">
  841. <a name="/Initialization"></a>
  842. <a name="//apple_ref/swift/Section/Initialization" class="dashAnchor"></a>
  843. <div class="section-name-container">
  844. <a class="section-name-link" href="#/Initialization"></a>
  845. <h3 class="section-name"><span>Initialization</span>
  846. </h3>
  847. </div>
  848. </div>
  849. <ul class="item-container">
  850. <li class="item">
  851. <div>
  852. <code>
  853. <a name="/s:9Alamofire11URLEncodingV11destination13arrayEncoding04boolE0A2C11DestinationO_AC05ArrayE0OAC04BoolE0Otcfc"></a>
  854. <a name="//apple_ref/swift/Method/init(destination:arrayEncoding:boolEncoding:)" class="dashAnchor"></a>
  855. <a class="token" href="#/s:9Alamofire11URLEncodingV11destination13arrayEncoding04boolE0A2C11DestinationO_AC05ArrayE0OAC04BoolE0Otcfc">init(destination:<wbr>arrayEncoding:<wbr>boolEncoding:<wbr>)</a>
  856. </code>
  857. </div>
  858. <div class="height-container">
  859. <div class="pointer-container"></div>
  860. <section class="section">
  861. <div class="pointer"></div>
  862. <div class="abstract">
  863. <p>Creates an instance using the specified parameters.</p>
  864. </div>
  865. <div class="declaration">
  866. <h4>Declaration</h4>
  867. <div class="language">
  868. <p class="aside-title">Swift</p>
  869. <pre class="highlight swift"><code><span class="kd">public</span> <span class="nf">init</span><span class="p">(</span><span class="nv">destination</span><span class="p">:</span> <span class="kt"><a href="../Structs/URLEncoding/Destination.html">Destination</a></span> <span class="o">=</span> <span class="o">.</span><span class="n">methodDependent</span><span class="p">,</span>
  870. <span class="nv">arrayEncoding</span><span class="p">:</span> <span class="kt"><a href="../Structs/URLEncoding/ArrayEncoding.html">ArrayEncoding</a></span> <span class="o">=</span> <span class="o">.</span><span class="n">brackets</span><span class="p">,</span>
  871. <span class="nv">boolEncoding</span><span class="p">:</span> <span class="kt"><a href="../Structs/URLEncoding/BoolEncoding.html">BoolEncoding</a></span> <span class="o">=</span> <span class="o">.</span><span class="n">numeric</span><span class="p">)</span></code></pre>
  872. </div>
  873. </div>
  874. <div>
  875. <h4>Parameters</h4>
  876. <table class="graybox">
  877. <tbody>
  878. <tr>
  879. <td>
  880. <code>
  881. <em>destination</em>
  882. </code>
  883. </td>
  884. <td>
  885. <div>
  886. <p><code><a href="../Structs/URLEncoding/Destination.html">Destination</a></code> defining where the encoded query string will be applied. <code>.methodDependent</code> by
  887. default.</p>
  888. </div>
  889. </td>
  890. </tr>
  891. <tr>
  892. <td>
  893. <code>
  894. <em>arrayEncoding</em>
  895. </code>
  896. </td>
  897. <td>
  898. <div>
  899. <p><code><a href="../Structs/URLEncoding/ArrayEncoding.html">ArrayEncoding</a></code> to use. <code>.brackets</code> by default.</p>
  900. </div>
  901. </td>
  902. </tr>
  903. <tr>
  904. <td>
  905. <code>
  906. <em>boolEncoding</em>
  907. </code>
  908. </td>
  909. <td>
  910. <div>
  911. <p><code><a href="../Structs/URLEncoding/BoolEncoding.html">BoolEncoding</a></code> to use. <code>.numeric</code> by default.</p>
  912. </div>
  913. </td>
  914. </tr>
  915. </tbody>
  916. </table>
  917. </div>
  918. </section>
  919. </div>
  920. </li>
  921. </ul>
  922. </div>
  923. <div class="task-group">
  924. <div class="task-name-container">
  925. <a name="/Encoding"></a>
  926. <a name="//apple_ref/swift/Section/Encoding" class="dashAnchor"></a>
  927. <div class="section-name-container">
  928. <a class="section-name-link" href="#/Encoding"></a>
  929. <h3 class="section-name"><span>Encoding</span>
  930. </h3>
  931. </div>
  932. </div>
  933. <ul class="item-container">
  934. <li class="item">
  935. <div>
  936. <code>
  937. <a name="/s:9Alamofire17ParameterEncodingP6encode_4with10Foundation10URLRequestVAA0G11Convertible_p_SDySSs8Sendable_pGSgtKF"></a>
  938. <a name="//apple_ref/swift/Method/encode(_:with:)" class="dashAnchor"></a>
  939. <a class="token" href="#/s:9Alamofire17ParameterEncodingP6encode_4with10Foundation10URLRequestVAA0G11Convertible_p_SDySSs8Sendable_pGSgtKF">encode(_:<wbr>with:<wbr>)</a>
  940. </code>
  941. </div>
  942. <div class="height-container">
  943. <div class="pointer-container"></div>
  944. <section class="section">
  945. <div class="pointer"></div>
  946. <div class="abstract">
  947. </div>
  948. <div class="declaration">
  949. <h4>Declaration</h4>
  950. <div class="language">
  951. <p class="aside-title">Swift</p>
  952. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">encode</span><span class="p">(</span><span class="n">_</span> <span class="nv">urlRequest</span><span class="p">:</span> <span class="kd">any</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">,</span> <span class="n">with</span> <span class="nv">parameters</span><span class="p">:</span> <span class="kt"><a href="../Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a></span><span class="p">?)</span> <span class="k">throws</span> <span class="o">-&gt;</span> <span class="kt">URLRequest</span></code></pre>
  953. </div>
  954. </div>
  955. </section>
  956. </div>
  957. </li>
  958. <li class="item">
  959. <div>
  960. <code>
  961. <a name="/s:9Alamofire11URLEncodingV15queryComponents7fromKey5valueSaySS_SStGSS_yptF"></a>
  962. <a name="//apple_ref/swift/Method/queryComponents(fromKey:value:)" class="dashAnchor"></a>
  963. <a class="token" href="#/s:9Alamofire11URLEncodingV15queryComponents7fromKey5valueSaySS_SStGSS_yptF">queryComponents(fromKey:<wbr>value:<wbr>)</a>
  964. </code>
  965. </div>
  966. <div class="height-container">
  967. <div class="pointer-container"></div>
  968. <section class="section">
  969. <div class="pointer"></div>
  970. <div class="abstract">
  971. <p>Creates a percent-escaped, URL encoded query string components from the given key-value pair recursively.</p>
  972. </div>
  973. <div class="declaration">
  974. <h4>Declaration</h4>
  975. <div class="language">
  976. <p class="aside-title">Swift</p>
  977. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">queryComponents</span><span class="p">(</span><span class="n">fromKey</span> <span class="nv">key</span><span class="p">:</span> <span class="kt">String</span><span class="p">,</span> <span class="nv">value</span><span class="p">:</span> <span class="kt">Any</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="p">[(</span><span class="kt">String</span><span class="p">,</span> <span class="kt">String</span><span class="p">)]</span></code></pre>
  978. </div>
  979. </div>
  980. <div>
  981. <h4>Parameters</h4>
  982. <table class="graybox">
  983. <tbody>
  984. <tr>
  985. <td>
  986. <code>
  987. <em>key</em>
  988. </code>
  989. </td>
  990. <td>
  991. <div>
  992. <p>Key of the query component.</p>
  993. </div>
  994. </td>
  995. </tr>
  996. <tr>
  997. <td>
  998. <code>
  999. <em>value</em>
  1000. </code>
  1001. </td>
  1002. <td>
  1003. <div>
  1004. <p>Value of the query component.</p>
  1005. </div>
  1006. </td>
  1007. </tr>
  1008. </tbody>
  1009. </table>
  1010. </div>
  1011. <div>
  1012. <h4>Return Value</h4>
  1013. <p>The percent-escaped, URL encoded query string components.</p>
  1014. </div>
  1015. </section>
  1016. </div>
  1017. </li>
  1018. <li class="item">
  1019. <div>
  1020. <code>
  1021. <a name="/s:9Alamofire11URLEncodingV6escapeyS2SF"></a>
  1022. <a name="//apple_ref/swift/Method/escape(_:)" class="dashAnchor"></a>
  1023. <a class="token" href="#/s:9Alamofire11URLEncodingV6escapeyS2SF">escape(_:<wbr>)</a>
  1024. </code>
  1025. </div>
  1026. <div class="height-container">
  1027. <div class="pointer-container"></div>
  1028. <section class="section">
  1029. <div class="pointer"></div>
  1030. <div class="abstract">
  1031. <p>Creates a percent-escaped string following RFC 3986 for a query string key or value.</p>
  1032. </div>
  1033. <div class="declaration">
  1034. <h4>Declaration</h4>
  1035. <div class="language">
  1036. <p class="aside-title">Swift</p>
  1037. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">escape</span><span class="p">(</span><span class="n">_</span> <span class="nv">string</span><span class="p">:</span> <span class="kt">String</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">String</span></code></pre>
  1038. </div>
  1039. </div>
  1040. <div>
  1041. <h4>Parameters</h4>
  1042. <table class="graybox">
  1043. <tbody>
  1044. <tr>
  1045. <td>
  1046. <code>
  1047. <em>string</em>
  1048. </code>
  1049. </td>
  1050. <td>
  1051. <div>
  1052. <p><code>String</code> to be percent-escaped.</p>
  1053. </div>
  1054. </td>
  1055. </tr>
  1056. </tbody>
  1057. </table>
  1058. </div>
  1059. <div>
  1060. <h4>Return Value</h4>
  1061. <p>The percent-escaped <code>String</code>.</p>
  1062. </div>
  1063. </section>
  1064. </div>
  1065. </li>
  1066. </ul>
  1067. </div>
  1068. </div>
  1069. </section>
  1070. </article>
  1071. </div>
  1072. <section class="footer">
  1073. <p>&copy; 2025 <a class="link" href="http://alamofire.org/" target="_blank" rel="external noopener">Alamofire Software Foundation</a>. All rights reserved. (Last updated: 2025-12-20)</p>
  1074. <p>Generated by <a class="link" href="https://github.com/realm/jazzy" target="_blank" rel="external noopener">jazzy ♪♫ v0.15.4</a>, a <a class="link" href="https://realm.io" target="_blank" rel="external noopener">Realm</a> project.</p>
  1075. </section>
  1076. </body>
  1077. </html>