AF.html 142 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <title>AF Enumeration 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/Enum/AF" class="dashAnchor"></a>
  16. <a title="AF Enumeration Reference"></a>
  17. <header class="header">
  18. <p class="header-col header-col--primary">
  19. <a class="header-link" href="../index.html">
  20. Alamofire Docs
  21. </a>
  22. (98% documented)
  23. </p>
  24. <p class="header-col--secondary">
  25. <form role="search" action="../search.json">
  26. <input type="text" placeholder="Search documentation" data-typeahead>
  27. </form>
  28. </p>
  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"/>
  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%2Egithub%2Eio%2FAlamofire%2Fdocsets%2FAlamofire%2Exml">
  37. <img class="header-icon" src="../img/dash.png"/>
  38. Install in Dash
  39. </a>
  40. </p>
  41. </header>
  42. <p class="breadcrumbs">
  43. <a class="breadcrumb" href="../index.html">Alamofire Reference</a>
  44. <img class="carat" src="../img/carat.png" />
  45. AF Enumeration Reference
  46. </p>
  47. <div class="content-wrapper">
  48. <nav class="navigation">
  49. <ul class="nav-groups">
  50. <li class="nav-group-name">
  51. <a class="nav-group-name-link" href="../Classes.html">Classes</a>
  52. <ul class="nav-group-tasks">
  53. <li class="nav-group-task">
  54. <a class="nav-group-task-link" href="../Classes/Adapter.html">Adapter</a>
  55. </li>
  56. <li class="nav-group-task">
  57. <a class="nav-group-task-link" href="../Classes/AlamofireNotifications.html">AlamofireNotifications</a>
  58. </li>
  59. <li class="nav-group-task">
  60. <a class="nav-group-task-link" href="../Classes/ClosureEventMonitor.html">ClosureEventMonitor</a>
  61. </li>
  62. <li class="nav-group-task">
  63. <a class="nav-group-task-link" href="../Classes/CompositeEventMonitor.html">CompositeEventMonitor</a>
  64. </li>
  65. <li class="nav-group-task">
  66. <a class="nav-group-task-link" href="../Classes/CompositeTrustEvaluator.html">CompositeTrustEvaluator</a>
  67. </li>
  68. <li class="nav-group-task">
  69. <a class="nav-group-task-link" href="../Classes/ConnectionLostRetryPolicy.html">ConnectionLostRetryPolicy</a>
  70. </li>
  71. <li class="nav-group-task">
  72. <a class="nav-group-task-link" href="../Classes/DataRequest.html">DataRequest</a>
  73. </li>
  74. <li class="nav-group-task">
  75. <a class="nav-group-task-link" href="../Classes/DataResponseSerializer.html">DataResponseSerializer</a>
  76. </li>
  77. <li class="nav-group-task">
  78. <a class="nav-group-task-link" href="../Classes/DecodableResponseSerializer.html">DecodableResponseSerializer</a>
  79. </li>
  80. <li class="nav-group-task">
  81. <a class="nav-group-task-link" href="../Classes/DefaultTrustEvaluator.html">DefaultTrustEvaluator</a>
  82. </li>
  83. <li class="nav-group-task">
  84. <a class="nav-group-task-link" href="../Classes/DisabledEvaluator.html">DisabledEvaluator</a>
  85. </li>
  86. <li class="nav-group-task">
  87. <a class="nav-group-task-link" href="../Classes/DownloadRequest.html">DownloadRequest</a>
  88. </li>
  89. <li class="nav-group-task">
  90. <a class="nav-group-task-link" href="../Classes/DownloadRequest/Options.html">– Options</a>
  91. </li>
  92. <li class="nav-group-task">
  93. <a class="nav-group-task-link" href="../Classes/DownloadRequest/Downloadable.html">– Downloadable</a>
  94. </li>
  95. <li class="nav-group-task">
  96. <a class="nav-group-task-link" href="../Classes/Interceptor.html">Interceptor</a>
  97. </li>
  98. <li class="nav-group-task">
  99. <a class="nav-group-task-link" href="../Classes/JSONParameterEncoder.html">JSONParameterEncoder</a>
  100. </li>
  101. <li class="nav-group-task">
  102. <a class="nav-group-task-link" href="../Classes/JSONResponseSerializer.html">JSONResponseSerializer</a>
  103. </li>
  104. <li class="nav-group-task">
  105. <a class="nav-group-task-link" href="../Classes/MultipartFormData.html">MultipartFormData</a>
  106. </li>
  107. <li class="nav-group-task">
  108. <a class="nav-group-task-link" href="../Classes/NetworkReachabilityManager.html">NetworkReachabilityManager</a>
  109. </li>
  110. <li class="nav-group-task">
  111. <a class="nav-group-task-link" href="../Classes/NetworkReachabilityManager/NetworkReachabilityStatus.html">– NetworkReachabilityStatus</a>
  112. </li>
  113. <li class="nav-group-task">
  114. <a class="nav-group-task-link" href="../Classes/NetworkReachabilityManager/ConnectionType.html">– ConnectionType</a>
  115. </li>
  116. <li class="nav-group-task">
  117. <a class="nav-group-task-link" href="../Classes/PinnedCertificatesTrustEvaluator.html">PinnedCertificatesTrustEvaluator</a>
  118. </li>
  119. <li class="nav-group-task">
  120. <a class="nav-group-task-link" href="../Classes/PublicKeysTrustEvaluator.html">PublicKeysTrustEvaluator</a>
  121. </li>
  122. <li class="nav-group-task">
  123. <a class="nav-group-task-link" href="../Classes/Request.html">Request</a>
  124. </li>
  125. <li class="nav-group-task">
  126. <a class="nav-group-task-link" href="../Classes/Request/State.html">– State</a>
  127. </li>
  128. <li class="nav-group-task">
  129. <a class="nav-group-task-link" href="../Classes/Retrier.html">Retrier</a>
  130. </li>
  131. <li class="nav-group-task">
  132. <a class="nav-group-task-link" href="../Classes/RetryPolicy.html">RetryPolicy</a>
  133. </li>
  134. <li class="nav-group-task">
  135. <a class="nav-group-task-link" href="../Classes/RevocationTrustEvaluator.html">RevocationTrustEvaluator</a>
  136. </li>
  137. <li class="nav-group-task">
  138. <a class="nav-group-task-link" href="../Classes/RevocationTrustEvaluator/Options.html">– Options</a>
  139. </li>
  140. <li class="nav-group-task">
  141. <a class="nav-group-task-link" href="../Classes/ServerTrustManager.html">ServerTrustManager</a>
  142. </li>
  143. <li class="nav-group-task">
  144. <a class="nav-group-task-link" href="../Classes/Session.html">Session</a>
  145. </li>
  146. <li class="nav-group-task">
  147. <a class="nav-group-task-link" href="../Classes/SessionDelegate.html">SessionDelegate</a>
  148. </li>
  149. <li class="nav-group-task">
  150. <a class="nav-group-task-link" href="../Classes/StringResponseSerializer.html">StringResponseSerializer</a>
  151. </li>
  152. <li class="nav-group-task">
  153. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder.html">URLEncodedFormEncoder</a>
  154. </li>
  155. <li class="nav-group-task">
  156. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/ArrayEncoding.html">– ArrayEncoding</a>
  157. </li>
  158. <li class="nav-group-task">
  159. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/BoolEncoding.html">– BoolEncoding</a>
  160. </li>
  161. <li class="nav-group-task">
  162. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/DataEncoding.html">– DataEncoding</a>
  163. </li>
  164. <li class="nav-group-task">
  165. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/DateEncoding.html">– DateEncoding</a>
  166. </li>
  167. <li class="nav-group-task">
  168. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/KeyEncoding.html">– KeyEncoding</a>
  169. </li>
  170. <li class="nav-group-task">
  171. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/SpaceEncoding.html">– SpaceEncoding</a>
  172. </li>
  173. <li class="nav-group-task">
  174. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/Error.html">– Error</a>
  175. </li>
  176. <li class="nav-group-task">
  177. <a class="nav-group-task-link" href="../Classes/URLEncodedFormParameterEncoder.html">URLEncodedFormParameterEncoder</a>
  178. </li>
  179. <li class="nav-group-task">
  180. <a class="nav-group-task-link" href="../Classes/URLEncodedFormParameterEncoder/Destination.html">– Destination</a>
  181. </li>
  182. <li class="nav-group-task">
  183. <a class="nav-group-task-link" href="../Classes/UploadRequest.html">UploadRequest</a>
  184. </li>
  185. <li class="nav-group-task">
  186. <a class="nav-group-task-link" href="../Classes/UploadRequest/Uploadable.html">– Uploadable</a>
  187. </li>
  188. </ul>
  189. </li>
  190. <li class="nav-group-name">
  191. <a class="nav-group-name-link" href="../Enums.html">Enumerations</a>
  192. <ul class="nav-group-tasks">
  193. <li class="nav-group-task">
  194. <a class="nav-group-task-link" href="../Enums/AF.html">AF</a>
  195. </li>
  196. <li class="nav-group-task">
  197. <a class="nav-group-task-link" href="../Enums/AFError.html">AFError</a>
  198. </li>
  199. <li class="nav-group-task">
  200. <a class="nav-group-task-link" href="../Enums/AFError/ParameterEncodingFailureReason.html">– ParameterEncodingFailureReason</a>
  201. </li>
  202. <li class="nav-group-task">
  203. <a class="nav-group-task-link" href="../Enums/AFError/ParameterEncoderFailureReason.html">– ParameterEncoderFailureReason</a>
  204. </li>
  205. <li class="nav-group-task">
  206. <a class="nav-group-task-link" href="../Enums/AFError/MultipartEncodingFailureReason.html">– MultipartEncodingFailureReason</a>
  207. </li>
  208. <li class="nav-group-task">
  209. <a class="nav-group-task-link" href="../Enums/AFError/ResponseValidationFailureReason.html">– ResponseValidationFailureReason</a>
  210. </li>
  211. <li class="nav-group-task">
  212. <a class="nav-group-task-link" href="../Enums/AFError/ResponseSerializationFailureReason.html">– ResponseSerializationFailureReason</a>
  213. </li>
  214. <li class="nav-group-task">
  215. <a class="nav-group-task-link" href="../Enums/AFError/ServerTrustFailureReason.html">– ServerTrustFailureReason</a>
  216. </li>
  217. <li class="nav-group-task">
  218. <a class="nav-group-task-link" href="../Enums/HTTPMethod.html">HTTPMethod</a>
  219. </li>
  220. <li class="nav-group-task">
  221. <a class="nav-group-task-link" href="../Enums/RetryResult.html">RetryResult</a>
  222. </li>
  223. </ul>
  224. </li>
  225. <li class="nav-group-name">
  226. <a class="nav-group-name-link" href="../Extensions.html">Extensions</a>
  227. <ul class="nav-group-tasks">
  228. <li class="nav-group-task">
  229. <a class="nav-group-task-link" href="../Extensions/Array.html">Array</a>
  230. </li>
  231. <li class="nav-group-task">
  232. <a class="nav-group-task-link" href="../Extensions/CharacterSet.html">CharacterSet</a>
  233. </li>
  234. <li class="nav-group-task">
  235. <a class="nav-group-task-link" href="../Extensions/Error.html">Error</a>
  236. </li>
  237. <li class="nav-group-task">
  238. <a class="nav-group-task-link" href="../Extensions/HTTPURLResponse.html">HTTPURLResponse</a>
  239. </li>
  240. <li class="nav-group-task">
  241. <a class="nav-group-task-link" href="../Extensions/Notification.html">Notification</a>
  242. </li>
  243. <li class="nav-group-task">
  244. <a class="nav-group-task-link" href="../Extensions/String.html">String</a>
  245. </li>
  246. <li class="nav-group-task">
  247. <a class="nav-group-task-link" href="../Extensions/URL.html">URL</a>
  248. </li>
  249. <li class="nav-group-task">
  250. <a class="nav-group-task-link" href="../Extensions/URLComponents.html">URLComponents</a>
  251. </li>
  252. <li class="nav-group-task">
  253. <a class="nav-group-task-link" href="../Extensions/URLRequest.html">URLRequest</a>
  254. </li>
  255. <li class="nav-group-task">
  256. <a class="nav-group-task-link" href="../Extensions/URLSessionConfiguration.html">URLSessionConfiguration</a>
  257. </li>
  258. </ul>
  259. </li>
  260. <li class="nav-group-name">
  261. <a class="nav-group-name-link" href="../Protocols.html">Protocols</a>
  262. <ul class="nav-group-tasks">
  263. <li class="nav-group-task">
  264. <a class="nav-group-task-link" href="../Protocols/AlamofireExtended.html">AlamofireExtended</a>
  265. </li>
  266. <li class="nav-group-task">
  267. <a class="nav-group-task-link" href="../Protocols/CachedResponseHandler.html">CachedResponseHandler</a>
  268. </li>
  269. <li class="nav-group-task">
  270. <a class="nav-group-task-link" href="../Protocols/DataDecoder.html">DataDecoder</a>
  271. </li>
  272. <li class="nav-group-task">
  273. <a class="nav-group-task-link" href="../Protocols/DataResponseSerializerProtocol.html">DataResponseSerializerProtocol</a>
  274. </li>
  275. <li class="nav-group-task">
  276. <a class="nav-group-task-link" href="../Protocols/DownloadResponseSerializerProtocol.html">DownloadResponseSerializerProtocol</a>
  277. </li>
  278. <li class="nav-group-task">
  279. <a class="nav-group-task-link" href="../Protocols/EmptyResponse.html">EmptyResponse</a>
  280. </li>
  281. <li class="nav-group-task">
  282. <a class="nav-group-task-link" href="../Protocols/EventMonitor.html">EventMonitor</a>
  283. </li>
  284. <li class="nav-group-task">
  285. <a class="nav-group-task-link" href="../Protocols/ParameterEncoder.html">ParameterEncoder</a>
  286. </li>
  287. <li class="nav-group-task">
  288. <a class="nav-group-task-link" href="../Protocols/ParameterEncoding.html">ParameterEncoding</a>
  289. </li>
  290. <li class="nav-group-task">
  291. <a class="nav-group-task-link" href="../Protocols/RedirectHandler.html">RedirectHandler</a>
  292. </li>
  293. <li class="nav-group-task">
  294. <a class="nav-group-task-link" href="../Protocols/RequestAdapter.html">RequestAdapter</a>
  295. </li>
  296. <li class="nav-group-task">
  297. <a class="nav-group-task-link" href="../Protocols/RequestDelegate.html">RequestDelegate</a>
  298. </li>
  299. <li class="nav-group-task">
  300. <a class="nav-group-task-link" href="../Protocols/RequestInterceptor.html">RequestInterceptor</a>
  301. </li>
  302. <li class="nav-group-task">
  303. <a class="nav-group-task-link" href="../Protocols/RequestRetrier.html">RequestRetrier</a>
  304. </li>
  305. <li class="nav-group-task">
  306. <a class="nav-group-task-link" href="../Protocols/ResponseSerializer.html">ResponseSerializer</a>
  307. </li>
  308. <li class="nav-group-task">
  309. <a class="nav-group-task-link" href="../Protocols/ServerTrustEvaluating.html">ServerTrustEvaluating</a>
  310. </li>
  311. <li class="nav-group-task">
  312. <a class="nav-group-task-link" href="../Protocols/URLConvertible.html">URLConvertible</a>
  313. </li>
  314. <li class="nav-group-task">
  315. <a class="nav-group-task-link" href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a>
  316. </li>
  317. <li class="nav-group-task">
  318. <a class="nav-group-task-link" href="../Protocols.html#/s:9Alamofire17UploadConvertibleP">UploadConvertible</a>
  319. </li>
  320. <li class="nav-group-task">
  321. <a class="nav-group-task-link" href="../Protocols/UploadableConvertible.html">UploadableConvertible</a>
  322. </li>
  323. </ul>
  324. </li>
  325. <li class="nav-group-name">
  326. <a class="nav-group-name-link" href="../Structs.html">Structures</a>
  327. <ul class="nav-group-tasks">
  328. <li class="nav-group-task">
  329. <a class="nav-group-task-link" href="../Structs/AlamofireExtension.html">AlamofireExtension</a>
  330. </li>
  331. <li class="nav-group-task">
  332. <a class="nav-group-task-link" href="../Structs/DataResponse.html">DataResponse</a>
  333. </li>
  334. <li class="nav-group-task">
  335. <a class="nav-group-task-link" href="../Structs/DownloadResponse.html">DownloadResponse</a>
  336. </li>
  337. <li class="nav-group-task">
  338. <a class="nav-group-task-link" href="../Structs/Empty.html">Empty</a>
  339. </li>
  340. <li class="nav-group-task">
  341. <a class="nav-group-task-link" href="../Structs/HTTPHeader.html">HTTPHeader</a>
  342. </li>
  343. <li class="nav-group-task">
  344. <a class="nav-group-task-link" href="../Structs/HTTPHeaders.html">HTTPHeaders</a>
  345. </li>
  346. <li class="nav-group-task">
  347. <a class="nav-group-task-link" href="../Structs/JSONEncoding.html">JSONEncoding</a>
  348. </li>
  349. <li class="nav-group-task">
  350. <a class="nav-group-task-link" href="../Structs/Redirector.html">Redirector</a>
  351. </li>
  352. <li class="nav-group-task">
  353. <a class="nav-group-task-link" href="../Structs/Redirector/Behavior.html">– Behavior</a>
  354. </li>
  355. <li class="nav-group-task">
  356. <a class="nav-group-task-link" href="../Structs/ResponseCacher.html">ResponseCacher</a>
  357. </li>
  358. <li class="nav-group-task">
  359. <a class="nav-group-task-link" href="../Structs/ResponseCacher/Behavior.html">– Behavior</a>
  360. </li>
  361. <li class="nav-group-task">
  362. <a class="nav-group-task-link" href="../Structs/URLEncoding.html">URLEncoding</a>
  363. </li>
  364. <li class="nav-group-task">
  365. <a class="nav-group-task-link" href="../Structs/URLEncoding/Destination.html">– Destination</a>
  366. </li>
  367. <li class="nav-group-task">
  368. <a class="nav-group-task-link" href="../Structs/URLEncoding/ArrayEncoding.html">– ArrayEncoding</a>
  369. </li>
  370. <li class="nav-group-task">
  371. <a class="nav-group-task-link" href="../Structs/URLEncoding/BoolEncoding.html">– BoolEncoding</a>
  372. </li>
  373. </ul>
  374. </li>
  375. <li class="nav-group-name">
  376. <a class="nav-group-name-link" href="../Typealiases.html">Type Aliases</a>
  377. <ul class="nav-group-tasks">
  378. <li class="nav-group-task">
  379. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire8AFResulta">AFResult</a>
  380. </li>
  381. <li class="nav-group-task">
  382. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire12AdaptHandlera">AdaptHandler</a>
  383. </li>
  384. <li class="nav-group-task">
  385. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a>
  386. </li>
  387. <li class="nav-group-task">
  388. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire12RetryHandlera">RetryHandler</a>
  389. </li>
  390. </ul>
  391. </li>
  392. </ul>
  393. </nav>
  394. <article class="main-content">
  395. <section class="section">
  396. <div class="section-content">
  397. <h1>AF</h1>
  398. <div class="declaration">
  399. <div class="language">
  400. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">enum</span> <span class="kt">AF</span></code></pre>
  401. </div>
  402. </div>
  403. <p>Global namespace containing API for the <code>default</code> <code><a href="../Classes/Session.html">Session</a></code> instance.</p>
  404. </div>
  405. </section>
  406. <section class="section">
  407. <div class="section-content">
  408. <div class="task-group">
  409. <div class="task-name-container">
  410. <a name="/Data%20Request"></a>
  411. <a name="//apple_ref/swift/Section/Data Request" class="dashAnchor"></a>
  412. <a href="#/Data%20Request">
  413. <h3 class="section-name">Data Request</h3>
  414. </a>
  415. </div>
  416. <ul class="item-container">
  417. <li class="item">
  418. <div>
  419. <code>
  420. <a name="/s:9Alamofire2AFO7request_6method10parameters8encoding7headers11interceptorAA11DataRequestCAA14URLConvertible_p_AA10HTTPMethodOSDySSypGSgAA17ParameterEncoding_pAA11HTTPHeadersVSgAA0J11Interceptor_pSgtFZ"></a>
  421. <a name="//apple_ref/swift/Method/request(_:method:parameters:encoding:headers:interceptor:)" class="dashAnchor"></a>
  422. <a class="token" href="#/s:9Alamofire2AFO7request_6method10parameters8encoding7headers11interceptorAA11DataRequestCAA14URLConvertible_p_AA10HTTPMethodOSDySSypGSgAA17ParameterEncoding_pAA11HTTPHeadersVSgAA0J11Interceptor_pSgtFZ">request(_:method:parameters:encoding:headers:interceptor:)</a>
  423. </code>
  424. </div>
  425. <div class="height-container">
  426. <div class="pointer-container"></div>
  427. <section class="section">
  428. <div class="pointer"></div>
  429. <div class="abstract">
  430. <p>Creates a <code><a href="../Classes/DataRequest.html">DataRequest</a></code> using <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">Session.default</a></code> to retrive the contents of the specified <code>url</code>
  431. using the <code>method</code>, <code>parameters</code>, <code>encoding</code>, and <code>headers</code> provided.</p>
  432. </div>
  433. <div class="declaration">
  434. <h4>Declaration</h4>
  435. <div class="language">
  436. <p class="aside-title">Swift</p>
  437. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">request</span><span class="p">(</span><span class="n">_</span> <span class="nv">url</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  438. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Enums/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="k">get</span><span class="p">,</span>
  439. <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="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  440. <span class="nv">encoding</span><span class="p">:</span> <span class="kt"><a href="../Protocols/ParameterEncoding.html">ParameterEncoding</a></span> <span class="o">=</span> <span class="kt"><a href="../Structs/URLEncoding.html">URLEncoding</a></span><span class="o">.</span><span class="k">default</span><span class="p">,</span>
  441. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  442. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/DataRequest.html">DataRequest</a></span></code></pre>
  443. </div>
  444. </div>
  445. <div>
  446. <h4>Parameters</h4>
  447. <table class="graybox">
  448. <tbody>
  449. <tr>
  450. <td>
  451. <code>
  452. <em>url</em>
  453. </code>
  454. </td>
  455. <td>
  456. <div>
  457. <p>The <code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value.</p>
  458. </div>
  459. </td>
  460. </tr>
  461. <tr>
  462. <td>
  463. <code>
  464. <em>method</em>
  465. </code>
  466. </td>
  467. <td>
  468. <div>
  469. <p>The <code><a href="../Enums/HTTPMethod.html">HTTPMethod</a></code>, <code>.get</code> by default.</p>
  470. </div>
  471. </td>
  472. </tr>
  473. <tr>
  474. <td>
  475. <code>
  476. <em>parameters</em>
  477. </code>
  478. </td>
  479. <td>
  480. <div>
  481. <p>The <code><a href="../Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a></code>, <code>nil</code> by default.</p>
  482. </div>
  483. </td>
  484. </tr>
  485. <tr>
  486. <td>
  487. <code>
  488. <em>encoding</em>
  489. </code>
  490. </td>
  491. <td>
  492. <div>
  493. <p>The <code><a href="../Protocols/ParameterEncoding.html">ParameterEncoding</a></code>, <code><a href="../Structs/URLEncoding.html#/s:9Alamofire11URLEncodingV7defaultACvpZ">URLEncoding.default</a></code> by default.</p>
  494. </div>
  495. </td>
  496. </tr>
  497. <tr>
  498. <td>
  499. <code>
  500. <em>headers</em>
  501. </code>
  502. </td>
  503. <td>
  504. <div>
  505. <p>The <code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code>, <code>nil</code> by default.</p>
  506. </div>
  507. </td>
  508. </tr>
  509. <tr>
  510. <td>
  511. <code>
  512. <em>interceptor</em>
  513. </code>
  514. </td>
  515. <td>
  516. <div>
  517. <p>The <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>, <code>nil</code> by default.</p>
  518. </div>
  519. </td>
  520. </tr>
  521. </tbody>
  522. </table>
  523. </div>
  524. <div>
  525. <h4>Return Value</h4>
  526. <p>The created <code><a href="../Classes/DataRequest.html">DataRequest</a></code>.</p>
  527. </div>
  528. </section>
  529. </div>
  530. </li>
  531. <li class="item">
  532. <div>
  533. <code>
  534. <a name="/s:9Alamofire2AFO7request_6method10parameters7encoder7headers11interceptorAA11DataRequestCAA14URLConvertible_p_AA10HTTPMethodOxSgAA16ParameterEncoder_pAA11HTTPHeadersVSgAA0J11Interceptor_pSgtSERzlFZ"></a>
  535. <a name="//apple_ref/swift/Method/request(_:method:parameters:encoder:headers:interceptor:)" class="dashAnchor"></a>
  536. <a class="token" href="#/s:9Alamofire2AFO7request_6method10parameters7encoder7headers11interceptorAA11DataRequestCAA14URLConvertible_p_AA10HTTPMethodOxSgAA16ParameterEncoder_pAA11HTTPHeadersVSgAA0J11Interceptor_pSgtSERzlFZ">request(_:method:parameters:encoder:headers:interceptor:)</a>
  537. </code>
  538. </div>
  539. <div class="height-container">
  540. <div class="pointer-container"></div>
  541. <section class="section">
  542. <div class="pointer"></div>
  543. <div class="abstract">
  544. <p>Creates a <code><a href="../Classes/DataRequest.html">DataRequest</a></code> using <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">Session.default</a></code> to retrive the contents of the specified <code>url</code>
  545. using the <code>method</code>, <code>parameters</code>, <code>encoding</code>, and <code>headers</code> provided.</p>
  546. </div>
  547. <div class="declaration">
  548. <h4>Declaration</h4>
  549. <div class="language">
  550. <p class="aside-title">Swift</p>
  551. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="n">request</span><span class="o">&lt;</span><span class="kt"><a href="../Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a></span><span class="p">:</span> <span class="kt">Encodable</span><span class="o">&gt;</span><span class="p">(</span><span class="n">_</span> <span class="nv">url</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  552. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Enums/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="k">get</span><span class="p">,</span>
  553. <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="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  554. <span class="nv">encoder</span><span class="p">:</span> <span class="kt"><a href="../Protocols/ParameterEncoder.html">ParameterEncoder</a></span> <span class="o">=</span> <span class="kt"><a href="../Classes/URLEncodedFormParameterEncoder.html">URLEncodedFormParameterEncoder</a></span><span class="o">.</span><span class="k">default</span><span class="p">,</span>
  555. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  556. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/DataRequest.html">DataRequest</a></span></code></pre>
  557. </div>
  558. </div>
  559. <div>
  560. <h4>Parameters</h4>
  561. <table class="graybox">
  562. <tbody>
  563. <tr>
  564. <td>
  565. <code>
  566. <em>url</em>
  567. </code>
  568. </td>
  569. <td>
  570. <div>
  571. <p>The <code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value.</p>
  572. </div>
  573. </td>
  574. </tr>
  575. <tr>
  576. <td>
  577. <code>
  578. <em>method</em>
  579. </code>
  580. </td>
  581. <td>
  582. <div>
  583. <p>The <code><a href="../Enums/HTTPMethod.html">HTTPMethod</a></code>, <code>.get</code> by default.</p>
  584. </div>
  585. </td>
  586. </tr>
  587. <tr>
  588. <td>
  589. <code>
  590. <em>parameters</em>
  591. </code>
  592. </td>
  593. <td>
  594. <div>
  595. <p>The <code>Encodable</code> parameters, <code>nil</code> by default.</p>
  596. </div>
  597. </td>
  598. </tr>
  599. <tr>
  600. <td>
  601. <code>
  602. <em>encoding</em>
  603. </code>
  604. </td>
  605. <td>
  606. <div>
  607. <p>The <code><a href="../Protocols/ParameterEncoder.html">ParameterEncoder</a></code>, <code><a href="../Classes/URLEncodedFormParameterEncoder.html#/s:9Alamofire30URLEncodedFormParameterEncoderC7defaultACvpZ">URLEncodedFormParameterEncoder.default</a></code> by default.</p>
  608. </div>
  609. </td>
  610. </tr>
  611. <tr>
  612. <td>
  613. <code>
  614. <em>headers</em>
  615. </code>
  616. </td>
  617. <td>
  618. <div>
  619. <p>The <code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code>, <code>nil</code> by default.</p>
  620. </div>
  621. </td>
  622. </tr>
  623. <tr>
  624. <td>
  625. <code>
  626. <em>interceptor</em>
  627. </code>
  628. </td>
  629. <td>
  630. <div>
  631. <p>The <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>, <code>nil</code> by default.</p>
  632. </div>
  633. </td>
  634. </tr>
  635. </tbody>
  636. </table>
  637. </div>
  638. <div>
  639. <h4>Return Value</h4>
  640. <p>The created <code><a href="../Classes/DataRequest.html">DataRequest</a></code>.</p>
  641. </div>
  642. </section>
  643. </div>
  644. </li>
  645. <li class="item">
  646. <div>
  647. <code>
  648. <a name="/s:9Alamofire2AFO7request_11interceptorAA11DataRequestCAA21URLRequestConvertible_p_AA0F11Interceptor_pSgtFZ"></a>
  649. <a name="//apple_ref/swift/Method/request(_:interceptor:)" class="dashAnchor"></a>
  650. <a class="token" href="#/s:9Alamofire2AFO7request_11interceptorAA11DataRequestCAA21URLRequestConvertible_p_AA0F11Interceptor_pSgtFZ">request(_:interceptor:)</a>
  651. </code>
  652. </div>
  653. <div class="height-container">
  654. <div class="pointer-container"></div>
  655. <section class="section">
  656. <div class="pointer"></div>
  657. <div class="abstract">
  658. <p>Creates a <code><a href="../Classes/DataRequest.html">DataRequest</a></code> using <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">Session.default</a></code> to execute the specified <code>urlRequest</code>.</p>
  659. </div>
  660. <div class="declaration">
  661. <h4>Declaration</h4>
  662. <div class="language">
  663. <p class="aside-title">Swift</p>
  664. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">request</span><span class="p">(</span><span class="n">_</span> <span class="nv">urlRequest</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">,</span> <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/DataRequest.html">DataRequest</a></span></code></pre>
  665. </div>
  666. </div>
  667. <div>
  668. <h4>Parameters</h4>
  669. <table class="graybox">
  670. <tbody>
  671. <tr>
  672. <td>
  673. <code>
  674. <em>urlRequest</em>
  675. </code>
  676. </td>
  677. <td>
  678. <div>
  679. <p>The <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value.</p>
  680. </div>
  681. </td>
  682. </tr>
  683. <tr>
  684. <td>
  685. <code>
  686. <em>interceptor</em>
  687. </code>
  688. </td>
  689. <td>
  690. <div>
  691. <p>The <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>, <code>nil</code> by default.</p>
  692. </div>
  693. </td>
  694. </tr>
  695. </tbody>
  696. </table>
  697. </div>
  698. <div>
  699. <h4>Return Value</h4>
  700. <p>The created <code><a href="../Classes/DataRequest.html">DataRequest</a></code>.</p>
  701. </div>
  702. </section>
  703. </div>
  704. </li>
  705. </ul>
  706. </div>
  707. <div class="task-group">
  708. <div class="task-name-container">
  709. <a name="/Download%20Request"></a>
  710. <a name="//apple_ref/swift/Section/Download Request" class="dashAnchor"></a>
  711. <a href="#/Download%20Request">
  712. <h3 class="section-name">Download Request</h3>
  713. </a>
  714. </div>
  715. <ul class="item-container">
  716. <li class="item">
  717. <div>
  718. <code>
  719. <a name="/s:9Alamofire2AFO8download_6method10parameters8encoding7headers11interceptor2toAA15DownloadRequestCAA14URLConvertible_p_AA10HTTPMethodOSDySSypGSgAA17ParameterEncoding_pAA11HTTPHeadersVSgAA0K11Interceptor_pSg10Foundation3URLV011destinationS0_AL7OptionsV7optionstAZ_So17NSHTTPURLResponseCtcSgtFZ"></a>
  720. <a name="//apple_ref/swift/Method/download(_:method:parameters:encoding:headers:interceptor:to:)" class="dashAnchor"></a>
  721. <a class="token" href="#/s:9Alamofire2AFO8download_6method10parameters8encoding7headers11interceptor2toAA15DownloadRequestCAA14URLConvertible_p_AA10HTTPMethodOSDySSypGSgAA17ParameterEncoding_pAA11HTTPHeadersVSgAA0K11Interceptor_pSg10Foundation3URLV011destinationS0_AL7OptionsV7optionstAZ_So17NSHTTPURLResponseCtcSgtFZ">download(_:method:parameters:encoding:headers:interceptor:to:)</a>
  722. </code>
  723. </div>
  724. <div class="height-container">
  725. <div class="pointer-container"></div>
  726. <section class="section">
  727. <div class="pointer"></div>
  728. <div class="abstract">
  729. <p>Creates a <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code> using <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">Session.default</a></code> to download the contents of the specified <code>url</code> to
  730. the provided <code>destination</code> using the <code>method</code>, <code>parameters</code>, <code>encoding</code>, and <code>headers</code> provided.</p>
  731. <p>If <code>destination</code> is not specified, the download will be moved to a temporary location determined by Alamofire.</p>
  732. </div>
  733. <div class="declaration">
  734. <h4>Declaration</h4>
  735. <div class="language">
  736. <p class="aside-title">Swift</p>
  737. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">download</span><span class="p">(</span><span class="n">_</span> <span class="nv">url</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  738. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Enums/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="k">get</span><span class="p">,</span>
  739. <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="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  740. <span class="nv">encoding</span><span class="p">:</span> <span class="kt"><a href="../Protocols/ParameterEncoding.html">ParameterEncoding</a></span> <span class="o">=</span> <span class="kt"><a href="../Structs/URLEncoding.html">URLEncoding</a></span><span class="o">.</span><span class="k">default</span><span class="p">,</span>
  741. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  742. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  743. <span class="n">to</span> <span class="nv">destination</span><span class="p">:</span> <span class="kt"><a href="../Classes/DownloadRequest.html">DownloadRequest</a></span><span class="o">.</span><span class="kt">Destination</span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/DownloadRequest.html">DownloadRequest</a></span></code></pre>
  744. </div>
  745. </div>
  746. <div>
  747. <h4>Parameters</h4>
  748. <table class="graybox">
  749. <tbody>
  750. <tr>
  751. <td>
  752. <code>
  753. <em>url</em>
  754. </code>
  755. </td>
  756. <td>
  757. <div>
  758. <p>The <code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value.</p>
  759. </div>
  760. </td>
  761. </tr>
  762. <tr>
  763. <td>
  764. <code>
  765. <em>method</em>
  766. </code>
  767. </td>
  768. <td>
  769. <div>
  770. <p>The <code><a href="../Enums/HTTPMethod.html">HTTPMethod</a></code>, <code>.get</code> by default.</p>
  771. </div>
  772. </td>
  773. </tr>
  774. <tr>
  775. <td>
  776. <code>
  777. <em>parameters</em>
  778. </code>
  779. </td>
  780. <td>
  781. <div>
  782. <p>The <code><a href="../Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a></code>, <code>nil</code> by default.</p>
  783. </div>
  784. </td>
  785. </tr>
  786. <tr>
  787. <td>
  788. <code>
  789. <em>encoding</em>
  790. </code>
  791. </td>
  792. <td>
  793. <div>
  794. <p>The <code><a href="../Protocols/ParameterEncoding.html">ParameterEncoding</a></code>, <code><a href="../Structs/URLEncoding.html#/s:9Alamofire11URLEncodingV7defaultACvpZ">URLEncoding.default</a></code> by default.</p>
  795. </div>
  796. </td>
  797. </tr>
  798. <tr>
  799. <td>
  800. <code>
  801. <em>headers</em>
  802. </code>
  803. </td>
  804. <td>
  805. <div>
  806. <p>The <code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code>, <code>nil</code> by default.</p>
  807. </div>
  808. </td>
  809. </tr>
  810. <tr>
  811. <td>
  812. <code>
  813. <em>interceptor</em>
  814. </code>
  815. </td>
  816. <td>
  817. <div>
  818. <p>The <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>, <code>nil</code> by default.</p>
  819. </div>
  820. </td>
  821. </tr>
  822. <tr>
  823. <td>
  824. <code>
  825. <em>destination</em>
  826. </code>
  827. </td>
  828. <td>
  829. <div>
  830. <p>The <code><a href="../Classes/DownloadRequest.html#/s:9Alamofire15DownloadRequestC11Destinationa">DownloadRequest.Destination</a></code> closure used the determine the destination of the
  831. downloaded file. <code>nil</code> by default.</p>
  832. </div>
  833. </td>
  834. </tr>
  835. </tbody>
  836. </table>
  837. </div>
  838. <div>
  839. <h4>Return Value</h4>
  840. <p>The created <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code>.</p>
  841. </div>
  842. </section>
  843. </div>
  844. </li>
  845. <li class="item">
  846. <div>
  847. <code>
  848. <a name="/s:9Alamofire2AFO8download_6method10parameters7encoder7headers11interceptor2toAA15DownloadRequestCAA14URLConvertible_p_AA10HTTPMethodOxSgAA16ParameterEncoder_pAA11HTTPHeadersVSgAA0K11Interceptor_pSg10Foundation3URLV011destinationS0_AL7OptionsV7optionstAY_So17NSHTTPURLResponseCtcSgtSERzlFZ"></a>
  849. <a name="//apple_ref/swift/Method/download(_:method:parameters:encoder:headers:interceptor:to:)" class="dashAnchor"></a>
  850. <a class="token" href="#/s:9Alamofire2AFO8download_6method10parameters7encoder7headers11interceptor2toAA15DownloadRequestCAA14URLConvertible_p_AA10HTTPMethodOxSgAA16ParameterEncoder_pAA11HTTPHeadersVSgAA0K11Interceptor_pSg10Foundation3URLV011destinationS0_AL7OptionsV7optionstAY_So17NSHTTPURLResponseCtcSgtSERzlFZ">download(_:method:parameters:encoder:headers:interceptor:to:)</a>
  851. </code>
  852. </div>
  853. <div class="height-container">
  854. <div class="pointer-container"></div>
  855. <section class="section">
  856. <div class="pointer"></div>
  857. <div class="abstract">
  858. <p>Creates a <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code> using <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">Session.default</a></code> to download the contents of the specified <code>url</code> to the
  859. provided <code>destination</code> using the <code>method</code>, encodable <code>parameters</code>, <code>encoder</code>, and <code>headers</code> provided.</p>
  860. <div class="aside aside-note">
  861. <p class="aside-title">Note</p>
  862. <p>If <code>destination</code> is not specified, the download will be moved to a temporary location determined by
  863. Alamofire.</p>
  864. </div>
  865. </div>
  866. <div class="declaration">
  867. <h4>Declaration</h4>
  868. <div class="language">
  869. <p class="aside-title">Swift</p>
  870. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="n">download</span><span class="o">&lt;</span><span class="kt"><a href="../Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a></span><span class="p">:</span> <span class="kt">Encodable</span><span class="o">&gt;</span><span class="p">(</span><span class="n">_</span> <span class="nv">url</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  871. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Enums/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="k">get</span><span class="p">,</span>
  872. <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="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  873. <span class="nv">encoder</span><span class="p">:</span> <span class="kt"><a href="../Protocols/ParameterEncoder.html">ParameterEncoder</a></span> <span class="o">=</span> <span class="kt"><a href="../Classes/URLEncodedFormParameterEncoder.html">URLEncodedFormParameterEncoder</a></span><span class="o">.</span><span class="k">default</span><span class="p">,</span>
  874. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  875. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  876. <span class="n">to</span> <span class="nv">destination</span><span class="p">:</span> <span class="kt"><a href="../Classes/DownloadRequest.html">DownloadRequest</a></span><span class="o">.</span><span class="kt">Destination</span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/DownloadRequest.html">DownloadRequest</a></span></code></pre>
  877. </div>
  878. </div>
  879. <div>
  880. <h4>Parameters</h4>
  881. <table class="graybox">
  882. <tbody>
  883. <tr>
  884. <td>
  885. <code>
  886. <em>url</em>
  887. </code>
  888. </td>
  889. <td>
  890. <div>
  891. <p>The <code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value.</p>
  892. </div>
  893. </td>
  894. </tr>
  895. <tr>
  896. <td>
  897. <code>
  898. <em>method</em>
  899. </code>
  900. </td>
  901. <td>
  902. <div>
  903. <p>The <code><a href="../Enums/HTTPMethod.html">HTTPMethod</a></code>, <code>.get</code> by default.</p>
  904. </div>
  905. </td>
  906. </tr>
  907. <tr>
  908. <td>
  909. <code>
  910. <em>parameters</em>
  911. </code>
  912. </td>
  913. <td>
  914. <div>
  915. <p>The <code>Encodable</code> parameters, <code>nil</code> by default.</p>
  916. </div>
  917. </td>
  918. </tr>
  919. <tr>
  920. <td>
  921. <code>
  922. <em>encoder</em>
  923. </code>
  924. </td>
  925. <td>
  926. <div>
  927. <p>The <code><a href="../Protocols/ParameterEncoder.html">ParameterEncoder</a></code>, <code><a href="../Classes/URLEncodedFormParameterEncoder.html#/s:9Alamofire30URLEncodedFormParameterEncoderC7defaultACvpZ">URLEncodedFormParameterEncoder.default</a></code> by default.</p>
  928. </div>
  929. </td>
  930. </tr>
  931. <tr>
  932. <td>
  933. <code>
  934. <em>headers</em>
  935. </code>
  936. </td>
  937. <td>
  938. <div>
  939. <p>The <code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code>, <code>nil</code> by default.</p>
  940. </div>
  941. </td>
  942. </tr>
  943. <tr>
  944. <td>
  945. <code>
  946. <em>interceptor</em>
  947. </code>
  948. </td>
  949. <td>
  950. <div>
  951. <p>The <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>, <code>nil</code> by default.</p>
  952. </div>
  953. </td>
  954. </tr>
  955. <tr>
  956. <td>
  957. <code>
  958. <em>destination</em>
  959. </code>
  960. </td>
  961. <td>
  962. <div>
  963. <p>The <code><a href="../Classes/DownloadRequest.html#/s:9Alamofire15DownloadRequestC11Destinationa">DownloadRequest.Destination</a></code> closure used the determine the destination of the
  964. downloaded file. <code>nil</code> by default.</p>
  965. </div>
  966. </td>
  967. </tr>
  968. </tbody>
  969. </table>
  970. </div>
  971. <div>
  972. <h4>Return Value</h4>
  973. <p>The created <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code>.</p>
  974. </div>
  975. </section>
  976. </div>
  977. </li>
  978. </ul>
  979. </div>
  980. <div class="task-group">
  981. <div class="task-name-container">
  982. <a name="/URLRequest"></a>
  983. <a name="//apple_ref/swift/Section/URLRequest" class="dashAnchor"></a>
  984. <a href="#/URLRequest">
  985. <h3 class="section-name">URLRequest</h3>
  986. </a>
  987. </div>
  988. <ul class="item-container">
  989. <li class="item">
  990. <div>
  991. <code>
  992. <a name="/s:9Alamofire2AFO8download_11interceptor2toAA15DownloadRequestCAA21URLRequestConvertible_p_AA0G11Interceptor_pSg10Foundation3URLV011destinationL0_AH7OptionsV7optionstAN_So17NSHTTPURLResponseCtcSgtFZ"></a>
  993. <a name="//apple_ref/swift/Method/download(_:interceptor:to:)" class="dashAnchor"></a>
  994. <a class="token" href="#/s:9Alamofire2AFO8download_11interceptor2toAA15DownloadRequestCAA21URLRequestConvertible_p_AA0G11Interceptor_pSg10Foundation3URLV011destinationL0_AH7OptionsV7optionstAN_So17NSHTTPURLResponseCtcSgtFZ">download(_:interceptor:to:)</a>
  995. </code>
  996. </div>
  997. <div class="height-container">
  998. <div class="pointer-container"></div>
  999. <section class="section">
  1000. <div class="pointer"></div>
  1001. <div class="abstract">
  1002. <p>Creates a <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code> using <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">Session.default</a></code> to execute the specified <code>urlRequest</code> and download
  1003. the result to the provided <code>destination</code>.</p>
  1004. </div>
  1005. <div class="declaration">
  1006. <h4>Declaration</h4>
  1007. <div class="language">
  1008. <p class="aside-title">Swift</p>
  1009. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">download</span><span class="p">(</span><span class="n">_</span> <span class="nv">urlRequest</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">,</span>
  1010. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  1011. <span class="n">to</span> <span class="nv">destination</span><span class="p">:</span> <span class="kt"><a href="../Classes/DownloadRequest.html">DownloadRequest</a></span><span class="o">.</span><span class="kt">Destination</span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/DownloadRequest.html">DownloadRequest</a></span></code></pre>
  1012. </div>
  1013. </div>
  1014. <div>
  1015. <h4>Parameters</h4>
  1016. <table class="graybox">
  1017. <tbody>
  1018. <tr>
  1019. <td>
  1020. <code>
  1021. <em>urlRequest</em>
  1022. </code>
  1023. </td>
  1024. <td>
  1025. <div>
  1026. <p>The <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value.</p>
  1027. </div>
  1028. </td>
  1029. </tr>
  1030. <tr>
  1031. <td>
  1032. <code>
  1033. <em>interceptor</em>
  1034. </code>
  1035. </td>
  1036. <td>
  1037. <div>
  1038. <p>The <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>, <code>nil</code> by default.</p>
  1039. </div>
  1040. </td>
  1041. </tr>
  1042. <tr>
  1043. <td>
  1044. <code>
  1045. <em>destination</em>
  1046. </code>
  1047. </td>
  1048. <td>
  1049. <div>
  1050. <p>The <code><a href="../Classes/DownloadRequest.html#/s:9Alamofire15DownloadRequestC11Destinationa">DownloadRequest.Destination</a></code> closure used the determine the destination of the
  1051. downloaded file. <code>nil</code> by default.</p>
  1052. </div>
  1053. </td>
  1054. </tr>
  1055. </tbody>
  1056. </table>
  1057. </div>
  1058. <div>
  1059. <h4>Return Value</h4>
  1060. <p>The created <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code>.</p>
  1061. </div>
  1062. </section>
  1063. </div>
  1064. </li>
  1065. </ul>
  1066. </div>
  1067. <div class="task-group">
  1068. <div class="task-name-container">
  1069. <a name="/Resume%20Data"></a>
  1070. <a name="//apple_ref/swift/Section/Resume Data" class="dashAnchor"></a>
  1071. <a href="#/Resume%20Data">
  1072. <h3 class="section-name">Resume Data</h3>
  1073. </a>
  1074. </div>
  1075. <ul class="item-container">
  1076. <li class="item">
  1077. <div>
  1078. <code>
  1079. <a name="/s:9Alamofire2AFO8download12resumingWith11interceptor2toAA15DownloadRequestC10Foundation4DataV_AA0I11Interceptor_pSgAJ3URLV011destinationM0_AI7OptionsV7optionstAP_So17NSHTTPURLResponseCtcSgtFZ"></a>
  1080. <a name="//apple_ref/swift/Method/download(resumingWith:interceptor:to:)" class="dashAnchor"></a>
  1081. <a class="token" href="#/s:9Alamofire2AFO8download12resumingWith11interceptor2toAA15DownloadRequestC10Foundation4DataV_AA0I11Interceptor_pSgAJ3URLV011destinationM0_AI7OptionsV7optionstAP_So17NSHTTPURLResponseCtcSgtFZ">download(resumingWith:interceptor:to:)</a>
  1082. </code>
  1083. </div>
  1084. <div class="height-container">
  1085. <div class="pointer-container"></div>
  1086. <section class="section">
  1087. <div class="pointer"></div>
  1088. <div class="abstract">
  1089. <p>Creates a <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code> using the <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">Session.default</a></code> from the <code>resumeData</code> produced from a previous
  1090. <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code> cancellation to retrieve the contents of the original request and save them to the <code>destination</code>.</p>
  1091. <div class="aside aside-note">
  1092. <p class="aside-title">Note</p>
  1093. <p>If <code>destination</code> is not specified, the download will be moved to a temporary location determined by
  1094. Alamofire.</p>
  1095. </div>
  1096. <div class="aside aside-note">
  1097. <p class="aside-title">Note</p>
  1098. <p>On some versions of all Apple platforms (iOS 10 - 10.2, macOS 10.12 - 10.12.2, tvOS 10 - 10.1, watchOS 3 - 3.1.1),
  1099. <code>resumeData</code> is broken on background URL session configurations. There&rsquo;s an underlying bug in the <code>resumeData</code>
  1100. generation logic where the data is written incorrectly and will always fail to resume the download. For more
  1101. information about the bug and possible workarounds, please refer to the <a href="http://stackoverflow.com/a/39347461/1342462">this Stack Overflow post</a>.</p>
  1102. </div>
  1103. </div>
  1104. <div class="declaration">
  1105. <h4>Declaration</h4>
  1106. <div class="language">
  1107. <p class="aside-title">Swift</p>
  1108. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">download</span><span class="p">(</span><span class="n">resumingWith</span> <span class="nv">resumeData</span><span class="p">:</span> <span class="kt">Data</span><span class="p">,</span>
  1109. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  1110. <span class="n">to</span> <span class="nv">destination</span><span class="p">:</span> <span class="kt"><a href="../Classes/DownloadRequest.html">DownloadRequest</a></span><span class="o">.</span><span class="kt">Destination</span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/DownloadRequest.html">DownloadRequest</a></span></code></pre>
  1111. </div>
  1112. </div>
  1113. <div>
  1114. <h4>Parameters</h4>
  1115. <table class="graybox">
  1116. <tbody>
  1117. <tr>
  1118. <td>
  1119. <code>
  1120. <em>resumeData</em>
  1121. </code>
  1122. </td>
  1123. <td>
  1124. <div>
  1125. <p>The resume <code>Data</code>. This is an opaque blob produced by <code>URLSessionDownloadTask</code> when a task is
  1126. cancelled. See <a href="https://developer.apple.com/documentation/foundation/urlsessiondownloadtask/1411634-cancel">Apple&rsquo;s documentation</a>
  1127. for more information.</p>
  1128. </div>
  1129. </td>
  1130. </tr>
  1131. <tr>
  1132. <td>
  1133. <code>
  1134. <em>interceptor</em>
  1135. </code>
  1136. </td>
  1137. <td>
  1138. <div>
  1139. <p>The <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>, <code>nil</code> by default.</p>
  1140. </div>
  1141. </td>
  1142. </tr>
  1143. <tr>
  1144. <td>
  1145. <code>
  1146. <em>destination</em>
  1147. </code>
  1148. </td>
  1149. <td>
  1150. <div>
  1151. <p>The <code><a href="../Classes/DownloadRequest.html#/s:9Alamofire15DownloadRequestC11Destinationa">DownloadRequest.Destination</a></code> closure used to determine the destination of the downloaded
  1152. file. <code>nil</code> by default.</p>
  1153. </div>
  1154. </td>
  1155. </tr>
  1156. </tbody>
  1157. </table>
  1158. </div>
  1159. <div>
  1160. <h4>Return Value</h4>
  1161. <p>The created <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code>.</p>
  1162. </div>
  1163. </section>
  1164. </div>
  1165. </li>
  1166. </ul>
  1167. </div>
  1168. <div class="task-group">
  1169. <div class="task-name-container">
  1170. <a name="/File"></a>
  1171. <a name="//apple_ref/swift/Section/File" class="dashAnchor"></a>
  1172. <a href="#/File">
  1173. <h3 class="section-name">File</h3>
  1174. </a>
  1175. </div>
  1176. <ul class="item-container">
  1177. <li class="item">
  1178. <div>
  1179. <code>
  1180. <a name="/s:9Alamofire2AFO6upload_2to6method7headers11interceptorAA13UploadRequestC10Foundation3URLV_AA14URLConvertible_pAA10HTTPMethodOAA11HTTPHeadersVSgAA0I11Interceptor_pSgtFZ"></a>
  1181. <a name="//apple_ref/swift/Method/upload(_:to:method:headers:interceptor:)" class="dashAnchor"></a>
  1182. <a class="token" href="#/s:9Alamofire2AFO6upload_2to6method7headers11interceptorAA13UploadRequestC10Foundation3URLV_AA14URLConvertible_pAA10HTTPMethodOAA11HTTPHeadersVSgAA0I11Interceptor_pSgtFZ">upload(_:to:method:headers:interceptor:)</a>
  1183. </code>
  1184. </div>
  1185. <div class="height-container">
  1186. <div class="pointer-container"></div>
  1187. <section class="section">
  1188. <div class="pointer"></div>
  1189. <div class="abstract">
  1190. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> using <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">Session.default</a></code> to upload the contents of the <code>fileURL</code> specified
  1191. using the <code>url</code>, <code>method</code> and <code>headers</code> provided.</p>
  1192. </div>
  1193. <div class="declaration">
  1194. <h4>Declaration</h4>
  1195. <div class="language">
  1196. <p class="aside-title">Swift</p>
  1197. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span><span class="n">_</span> <span class="nv">fileURL</span><span class="p">:</span> <span class="kt">URL</span><span class="p">,</span>
  1198. <span class="n">to</span> <span class="nv">url</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  1199. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Enums/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="n">post</span><span class="p">,</span>
  1200. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  1201. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  1202. </div>
  1203. </div>
  1204. <div>
  1205. <h4>Parameters</h4>
  1206. <table class="graybox">
  1207. <tbody>
  1208. <tr>
  1209. <td>
  1210. <code>
  1211. <em>fileURL</em>
  1212. </code>
  1213. </td>
  1214. <td>
  1215. <div>
  1216. <p>The <code>URL</code> of the file to upload.</p>
  1217. </div>
  1218. </td>
  1219. </tr>
  1220. <tr>
  1221. <td>
  1222. <code>
  1223. <em>url</em>
  1224. </code>
  1225. </td>
  1226. <td>
  1227. <div>
  1228. <p>The <code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value.</p>
  1229. </div>
  1230. </td>
  1231. </tr>
  1232. <tr>
  1233. <td>
  1234. <code>
  1235. <em>method</em>
  1236. </code>
  1237. </td>
  1238. <td>
  1239. <div>
  1240. <p>The <code><a href="../Enums/HTTPMethod.html">HTTPMethod</a></code>, <code>.post</code> by default.</p>
  1241. </div>
  1242. </td>
  1243. </tr>
  1244. <tr>
  1245. <td>
  1246. <code>
  1247. <em>headers</em>
  1248. </code>
  1249. </td>
  1250. <td>
  1251. <div>
  1252. <p>The <code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code>, <code>nil</code> by default.</p>
  1253. </div>
  1254. </td>
  1255. </tr>
  1256. <tr>
  1257. <td>
  1258. <code>
  1259. <em>interceptor</em>
  1260. </code>
  1261. </td>
  1262. <td>
  1263. <div>
  1264. <p>The <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>, <code>nil</code> by default.</p>
  1265. </div>
  1266. </td>
  1267. </tr>
  1268. </tbody>
  1269. </table>
  1270. </div>
  1271. <div>
  1272. <h4>Return Value</h4>
  1273. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  1274. </div>
  1275. </section>
  1276. </div>
  1277. </li>
  1278. <li class="item">
  1279. <div>
  1280. <code>
  1281. <a name="/s:9Alamofire2AFO6upload_4with11interceptorAA13UploadRequestC10Foundation3URLV_AA21URLRequestConvertible_pAA0G11Interceptor_pSgtFZ"></a>
  1282. <a name="//apple_ref/swift/Method/upload(_:with:interceptor:)" class="dashAnchor"></a>
  1283. <a class="token" href="#/s:9Alamofire2AFO6upload_4with11interceptorAA13UploadRequestC10Foundation3URLV_AA21URLRequestConvertible_pAA0G11Interceptor_pSgtFZ">upload(_:with:interceptor:)</a>
  1284. </code>
  1285. </div>
  1286. <div class="height-container">
  1287. <div class="pointer-container"></div>
  1288. <section class="section">
  1289. <div class="pointer"></div>
  1290. <div class="abstract">
  1291. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> using the <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">Session.default</a></code> to upload the contents of the <code>fileURL</code> specificed
  1292. using the <code>urlRequest</code> provided.</p>
  1293. </div>
  1294. <div class="declaration">
  1295. <h4>Declaration</h4>
  1296. <div class="language">
  1297. <p class="aside-title">Swift</p>
  1298. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span><span class="n">_</span> <span class="nv">fileURL</span><span class="p">:</span> <span class="kt">URL</span><span class="p">,</span>
  1299. <span class="n">with</span> <span class="nv">urlRequest</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">,</span>
  1300. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  1301. </div>
  1302. </div>
  1303. <div>
  1304. <h4>Parameters</h4>
  1305. <table class="graybox">
  1306. <tbody>
  1307. <tr>
  1308. <td>
  1309. <code>
  1310. <em>fileURL</em>
  1311. </code>
  1312. </td>
  1313. <td>
  1314. <div>
  1315. <p>The <code>URL</code> of the file to upload.</p>
  1316. </div>
  1317. </td>
  1318. </tr>
  1319. <tr>
  1320. <td>
  1321. <code>
  1322. <em>urlRequest</em>
  1323. </code>
  1324. </td>
  1325. <td>
  1326. <div>
  1327. <p>The <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value.</p>
  1328. </div>
  1329. </td>
  1330. </tr>
  1331. <tr>
  1332. <td>
  1333. <code>
  1334. <em>interceptor</em>
  1335. </code>
  1336. </td>
  1337. <td>
  1338. <div>
  1339. <p>The <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>, <code>nil</code> by default.</p>
  1340. </div>
  1341. </td>
  1342. </tr>
  1343. </tbody>
  1344. </table>
  1345. </div>
  1346. <div>
  1347. <h4>Return Value</h4>
  1348. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  1349. </div>
  1350. </section>
  1351. </div>
  1352. </li>
  1353. </ul>
  1354. </div>
  1355. <div class="task-group">
  1356. <div class="task-name-container">
  1357. <a name="/Data"></a>
  1358. <a name="//apple_ref/swift/Section/Data" class="dashAnchor"></a>
  1359. <a href="#/Data">
  1360. <h3 class="section-name">Data</h3>
  1361. </a>
  1362. </div>
  1363. <ul class="item-container">
  1364. <li class="item">
  1365. <div>
  1366. <code>
  1367. <a name="/s:9Alamofire2AFO6upload_2to6method7headers11interceptorAA13UploadRequestC10Foundation4DataV_AA14URLConvertible_pAA10HTTPMethodOAA11HTTPHeadersVSgAA0I11Interceptor_pSgtFZ"></a>
  1368. <a name="//apple_ref/swift/Method/upload(_:to:method:headers:interceptor:)" class="dashAnchor"></a>
  1369. <a class="token" href="#/s:9Alamofire2AFO6upload_2to6method7headers11interceptorAA13UploadRequestC10Foundation4DataV_AA14URLConvertible_pAA10HTTPMethodOAA11HTTPHeadersVSgAA0I11Interceptor_pSgtFZ">upload(_:to:method:headers:interceptor:)</a>
  1370. </code>
  1371. </div>
  1372. <div class="height-container">
  1373. <div class="pointer-container"></div>
  1374. <section class="section">
  1375. <div class="pointer"></div>
  1376. <div class="abstract">
  1377. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> using <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">Session.default</a></code> to upload the contents of the <code>data</code> specified using
  1378. the <code>url</code>, <code>method</code> and <code>headers</code> provided.</p>
  1379. </div>
  1380. <div class="declaration">
  1381. <h4>Declaration</h4>
  1382. <div class="language">
  1383. <p class="aside-title">Swift</p>
  1384. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span><span class="n">_</span> <span class="nv">data</span><span class="p">:</span> <span class="kt">Data</span><span class="p">,</span>
  1385. <span class="n">to</span> <span class="nv">url</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  1386. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Enums/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="n">post</span><span class="p">,</span>
  1387. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  1388. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  1389. </div>
  1390. </div>
  1391. <div>
  1392. <h4>Parameters</h4>
  1393. <table class="graybox">
  1394. <tbody>
  1395. <tr>
  1396. <td>
  1397. <code>
  1398. <em>data</em>
  1399. </code>
  1400. </td>
  1401. <td>
  1402. <div>
  1403. <p>The <code>Data</code> to upload.</p>
  1404. </div>
  1405. </td>
  1406. </tr>
  1407. <tr>
  1408. <td>
  1409. <code>
  1410. <em>url</em>
  1411. </code>
  1412. </td>
  1413. <td>
  1414. <div>
  1415. <p>The <code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value.</p>
  1416. </div>
  1417. </td>
  1418. </tr>
  1419. <tr>
  1420. <td>
  1421. <code>
  1422. <em>method</em>
  1423. </code>
  1424. </td>
  1425. <td>
  1426. <div>
  1427. <p>The <code><a href="../Enums/HTTPMethod.html">HTTPMethod</a></code>, <code>.post</code> by default.</p>
  1428. </div>
  1429. </td>
  1430. </tr>
  1431. <tr>
  1432. <td>
  1433. <code>
  1434. <em>headers</em>
  1435. </code>
  1436. </td>
  1437. <td>
  1438. <div>
  1439. <p>The <code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code>, <code>nil</code> by default.</p>
  1440. </div>
  1441. </td>
  1442. </tr>
  1443. <tr>
  1444. <td>
  1445. <code>
  1446. <em>interceptor</em>
  1447. </code>
  1448. </td>
  1449. <td>
  1450. <div>
  1451. <p>The <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>, <code>nil</code> by default.</p>
  1452. </div>
  1453. </td>
  1454. </tr>
  1455. <tr>
  1456. <td>
  1457. <code>
  1458. <em>retryPolicies</em>
  1459. </code>
  1460. </td>
  1461. <td>
  1462. <div>
  1463. <p>The <code><a href="../Classes/RetryPolicy.html">RetryPolicy</a></code> types, <code>[]</code> by default.</p>
  1464. </div>
  1465. </td>
  1466. </tr>
  1467. </tbody>
  1468. </table>
  1469. </div>
  1470. <div>
  1471. <h4>Return Value</h4>
  1472. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  1473. </div>
  1474. </section>
  1475. </div>
  1476. </li>
  1477. <li class="item">
  1478. <div>
  1479. <code>
  1480. <a name="/s:9Alamofire2AFO6upload_4with11interceptorAA13UploadRequestC10Foundation4DataV_AA21URLRequestConvertible_pAA0G11Interceptor_pSgtFZ"></a>
  1481. <a name="//apple_ref/swift/Method/upload(_:with:interceptor:)" class="dashAnchor"></a>
  1482. <a class="token" href="#/s:9Alamofire2AFO6upload_4with11interceptorAA13UploadRequestC10Foundation4DataV_AA21URLRequestConvertible_pAA0G11Interceptor_pSgtFZ">upload(_:with:interceptor:)</a>
  1483. </code>
  1484. </div>
  1485. <div class="height-container">
  1486. <div class="pointer-container"></div>
  1487. <section class="section">
  1488. <div class="pointer"></div>
  1489. <div class="abstract">
  1490. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> using <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">Session.default</a></code> to upload the contents of the <code>data</code> specified using the
  1491. <code>urlRequest</code> provided.</p>
  1492. </div>
  1493. <div class="declaration">
  1494. <h4>Declaration</h4>
  1495. <div class="language">
  1496. <p class="aside-title">Swift</p>
  1497. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span><span class="n">_</span> <span class="nv">data</span><span class="p">:</span> <span class="kt">Data</span><span class="p">,</span>
  1498. <span class="n">with</span> <span class="nv">urlRequest</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">,</span>
  1499. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  1500. </div>
  1501. </div>
  1502. <div>
  1503. <h4>Parameters</h4>
  1504. <table class="graybox">
  1505. <tbody>
  1506. <tr>
  1507. <td>
  1508. <code>
  1509. <em>data</em>
  1510. </code>
  1511. </td>
  1512. <td>
  1513. <div>
  1514. <p>The <code>Data</code> to upload.</p>
  1515. </div>
  1516. </td>
  1517. </tr>
  1518. <tr>
  1519. <td>
  1520. <code>
  1521. <em>urlRequest</em>
  1522. </code>
  1523. </td>
  1524. <td>
  1525. <div>
  1526. <p>The <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value.</p>
  1527. </div>
  1528. </td>
  1529. </tr>
  1530. <tr>
  1531. <td>
  1532. <code>
  1533. <em>interceptor</em>
  1534. </code>
  1535. </td>
  1536. <td>
  1537. <div>
  1538. <p>The <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>, <code>nil</code> by default.</p>
  1539. </div>
  1540. </td>
  1541. </tr>
  1542. </tbody>
  1543. </table>
  1544. </div>
  1545. <div>
  1546. <h4>Return Value</h4>
  1547. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  1548. </div>
  1549. </section>
  1550. </div>
  1551. </li>
  1552. </ul>
  1553. </div>
  1554. <div class="task-group">
  1555. <div class="task-name-container">
  1556. <a name="/InputStream"></a>
  1557. <a name="//apple_ref/swift/Section/InputStream" class="dashAnchor"></a>
  1558. <a href="#/InputStream">
  1559. <h3 class="section-name">InputStream</h3>
  1560. </a>
  1561. </div>
  1562. <ul class="item-container">
  1563. <li class="item">
  1564. <div>
  1565. <code>
  1566. <a name="/s:9Alamofire2AFO6upload_2to6method7headers11interceptorAA13UploadRequestCSo13NSInputStreamC_AA14URLConvertible_pAA10HTTPMethodOAA11HTTPHeadersVSgAA0I11Interceptor_pSgtFZ"></a>
  1567. <a name="//apple_ref/swift/Method/upload(_:to:method:headers:interceptor:)" class="dashAnchor"></a>
  1568. <a class="token" href="#/s:9Alamofire2AFO6upload_2to6method7headers11interceptorAA13UploadRequestCSo13NSInputStreamC_AA14URLConvertible_pAA10HTTPMethodOAA11HTTPHeadersVSgAA0I11Interceptor_pSgtFZ">upload(_:to:method:headers:interceptor:)</a>
  1569. </code>
  1570. </div>
  1571. <div class="height-container">
  1572. <div class="pointer-container"></div>
  1573. <section class="section">
  1574. <div class="pointer"></div>
  1575. <div class="abstract">
  1576. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> using <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">Session.default</a></code> to upload the content provided by the <code>stream</code> specified
  1577. using the <code>url</code>, <code>method</code> and <code>headers</code> provided.</p>
  1578. </div>
  1579. <div class="declaration">
  1580. <h4>Declaration</h4>
  1581. <div class="language">
  1582. <p class="aside-title">Swift</p>
  1583. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span><span class="n">_</span> <span class="nv">stream</span><span class="p">:</span> <span class="kt">InputStream</span><span class="p">,</span>
  1584. <span class="n">to</span> <span class="nv">url</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  1585. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Enums/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="n">post</span><span class="p">,</span>
  1586. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  1587. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  1588. </div>
  1589. </div>
  1590. <div>
  1591. <h4>Parameters</h4>
  1592. <table class="graybox">
  1593. <tbody>
  1594. <tr>
  1595. <td>
  1596. <code>
  1597. <em>stream</em>
  1598. </code>
  1599. </td>
  1600. <td>
  1601. <div>
  1602. <p>The <code>InputStream</code> to upload.</p>
  1603. </div>
  1604. </td>
  1605. </tr>
  1606. <tr>
  1607. <td>
  1608. <code>
  1609. <em>url</em>
  1610. </code>
  1611. </td>
  1612. <td>
  1613. <div>
  1614. <p>The <code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value.</p>
  1615. </div>
  1616. </td>
  1617. </tr>
  1618. <tr>
  1619. <td>
  1620. <code>
  1621. <em>method</em>
  1622. </code>
  1623. </td>
  1624. <td>
  1625. <div>
  1626. <p>The <code><a href="../Enums/HTTPMethod.html">HTTPMethod</a></code>, <code>.post</code> by default.</p>
  1627. </div>
  1628. </td>
  1629. </tr>
  1630. <tr>
  1631. <td>
  1632. <code>
  1633. <em>headers</em>
  1634. </code>
  1635. </td>
  1636. <td>
  1637. <div>
  1638. <p>The <code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code>, <code>nil</code> by default.</p>
  1639. </div>
  1640. </td>
  1641. </tr>
  1642. <tr>
  1643. <td>
  1644. <code>
  1645. <em>interceptor</em>
  1646. </code>
  1647. </td>
  1648. <td>
  1649. <div>
  1650. <p>The <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>, <code>nil</code> by default.</p>
  1651. </div>
  1652. </td>
  1653. </tr>
  1654. </tbody>
  1655. </table>
  1656. </div>
  1657. <div>
  1658. <h4>Return Value</h4>
  1659. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  1660. </div>
  1661. </section>
  1662. </div>
  1663. </li>
  1664. <li class="item">
  1665. <div>
  1666. <code>
  1667. <a name="/s:9Alamofire2AFO6upload_4with11interceptorAA13UploadRequestCSo13NSInputStreamC_AA21URLRequestConvertible_pAA0G11Interceptor_pSgtFZ"></a>
  1668. <a name="//apple_ref/swift/Method/upload(_:with:interceptor:)" class="dashAnchor"></a>
  1669. <a class="token" href="#/s:9Alamofire2AFO6upload_4with11interceptorAA13UploadRequestCSo13NSInputStreamC_AA21URLRequestConvertible_pAA0G11Interceptor_pSgtFZ">upload(_:with:interceptor:)</a>
  1670. </code>
  1671. </div>
  1672. <div class="height-container">
  1673. <div class="pointer-container"></div>
  1674. <section class="section">
  1675. <div class="pointer"></div>
  1676. <div class="abstract">
  1677. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> using <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">Session.default</a></code> to upload the content provided by the <code>stream</code>
  1678. specified using the <code>urlRequest</code> specified.</p>
  1679. </div>
  1680. <div class="declaration">
  1681. <h4>Declaration</h4>
  1682. <div class="language">
  1683. <p class="aside-title">Swift</p>
  1684. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span><span class="n">_</span> <span class="nv">stream</span><span class="p">:</span> <span class="kt">InputStream</span><span class="p">,</span>
  1685. <span class="n">with</span> <span class="nv">urlRequest</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">,</span>
  1686. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  1687. </div>
  1688. </div>
  1689. <div>
  1690. <h4>Parameters</h4>
  1691. <table class="graybox">
  1692. <tbody>
  1693. <tr>
  1694. <td>
  1695. <code>
  1696. <em>stream</em>
  1697. </code>
  1698. </td>
  1699. <td>
  1700. <div>
  1701. <p>The <code>InputStream</code> to upload.</p>
  1702. </div>
  1703. </td>
  1704. </tr>
  1705. <tr>
  1706. <td>
  1707. <code>
  1708. <em>urlRequest</em>
  1709. </code>
  1710. </td>
  1711. <td>
  1712. <div>
  1713. <p>The <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value.</p>
  1714. </div>
  1715. </td>
  1716. </tr>
  1717. <tr>
  1718. <td>
  1719. <code>
  1720. <em>interceptor</em>
  1721. </code>
  1722. </td>
  1723. <td>
  1724. <div>
  1725. <p>The <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>, <code>nil</code> by default.</p>
  1726. </div>
  1727. </td>
  1728. </tr>
  1729. </tbody>
  1730. </table>
  1731. </div>
  1732. <div>
  1733. <h4>Return Value</h4>
  1734. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  1735. </div>
  1736. </section>
  1737. </div>
  1738. </li>
  1739. </ul>
  1740. </div>
  1741. <div class="task-group">
  1742. <div class="task-name-container">
  1743. <a name="/MultipartFormData"></a>
  1744. <a name="//apple_ref/swift/Section/MultipartFormData" class="dashAnchor"></a>
  1745. <a href="#/MultipartFormData">
  1746. <h3 class="section-name">MultipartFormData</h3>
  1747. </a>
  1748. </div>
  1749. <ul class="item-container">
  1750. <li class="item">
  1751. <div>
  1752. <code>
  1753. <a name="/s:9Alamofire2AFO6upload17multipartFormData14usingThreshold11fileManager2to6method7headers11interceptorAA13UploadRequestCyAA09MultiparteF0Cc_s6UInt64VSo06NSFileJ0CAA14URLConvertible_pAA10HTTPMethodOAA11HTTPHeadersVSgAA0P11Interceptor_pSgtFZ"></a>
  1754. <a name="//apple_ref/swift/Method/upload(multipartFormData:usingThreshold:fileManager:to:method:headers:interceptor:)" class="dashAnchor"></a>
  1755. <a class="token" href="#/s:9Alamofire2AFO6upload17multipartFormData14usingThreshold11fileManager2to6method7headers11interceptorAA13UploadRequestCyAA09MultiparteF0Cc_s6UInt64VSo06NSFileJ0CAA14URLConvertible_pAA10HTTPMethodOAA11HTTPHeadersVSgAA0P11Interceptor_pSgtFZ">upload(multipartFormData:usingThreshold:fileManager:to:method:headers:interceptor:)</a>
  1756. </code>
  1757. </div>
  1758. <div class="height-container">
  1759. <div class="pointer-container"></div>
  1760. <section class="section">
  1761. <div class="pointer"></div>
  1762. <div class="abstract">
  1763. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> for the multipart form data built using a closure and sent using the provided
  1764. <code>URLRequest</code> components and <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  1765. <p>It is important to understand the memory implications of uploading <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code>. If the cummulative
  1766. payload is small, encoding the data in-memory and directly uploading to a server is the by far the most
  1767. efficient approach. However, if the payload is too large, encoding the data in-memory could cause your app to
  1768. be terminated. Larger payloads must first be written to disk using input and output streams to keep the memory
  1769. footprint low, then the data can be uploaded as a stream from the resulting file. Streaming from disk MUST be
  1770. used for larger payloads such as video content.</p>
  1771. <p>The <code>encodingMemoryThreshold</code> parameter allows Alamofire to automatically determine whether to encode in-memory
  1772. or stream from disk. If the content length of the <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code> is below the <code>encodingMemoryThreshold</code>,
  1773. encoding takes place in-memory. If the content length exceeds the threshold, the data is streamed to disk
  1774. during the encoding process. Then the result is uploaded as data or as a stream depending on which encoding
  1775. technique was used.</p>
  1776. </div>
  1777. <div class="declaration">
  1778. <h4>Declaration</h4>
  1779. <div class="language">
  1780. <p class="aside-title">Swift</p>
  1781. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span><span class="nv">multipartFormData</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="p">(</span><span class="kt"><a href="../Classes/MultipartFormData.html">MultipartFormData</a></span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">,</span>
  1782. <span class="n">usingThreshold</span> <span class="nv">encodingMemoryThreshold</span><span class="p">:</span> <span class="kt">UInt64</span> <span class="o">=</span> <span class="kt"><a href="../Classes/MultipartFormData.html">MultipartFormData</a></span><span class="o">.</span><span class="n">encodingMemoryThreshold</span><span class="p">,</span>
  1783. <span class="nv">fileManager</span><span class="p">:</span> <span class="kt">FileManager</span> <span class="o">=</span> <span class="o">.</span><span class="k">default</span><span class="p">,</span>
  1784. <span class="n">to</span> <span class="nv">url</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  1785. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Enums/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="n">post</span><span class="p">,</span>
  1786. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  1787. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  1788. </div>
  1789. </div>
  1790. <div>
  1791. <h4>Parameters</h4>
  1792. <table class="graybox">
  1793. <tbody>
  1794. <tr>
  1795. <td>
  1796. <code>
  1797. <em>multipartFormData</em>
  1798. </code>
  1799. </td>
  1800. <td>
  1801. <div>
  1802. <p><code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code> building closure.</p>
  1803. </div>
  1804. </td>
  1805. </tr>
  1806. <tr>
  1807. <td>
  1808. <code>
  1809. <em>encodingMemoryThreshold</em>
  1810. </code>
  1811. </td>
  1812. <td>
  1813. <div>
  1814. <p>Byte threshold used to determine whether the form data is encoded into memory or
  1815. onto disk before being uploaded. <code><a href="../Classes/MultipartFormData.html#/s:9Alamofire17MultipartFormDataC23encodingMemoryThresholds6UInt64VvpZ">MultipartFormData.encodingMemoryThreshold</a></code> by default.</p>
  1816. </div>
  1817. </td>
  1818. </tr>
  1819. <tr>
  1820. <td>
  1821. <code>
  1822. <em>fileManager</em>
  1823. </code>
  1824. </td>
  1825. <td>
  1826. <div>
  1827. <p><code>FileManager</code> to be used if the form data exceeds the memory threshold and is
  1828. written to disk before being uploaded.</p>
  1829. </div>
  1830. </td>
  1831. </tr>
  1832. <tr>
  1833. <td>
  1834. <code>
  1835. <em>convertible</em>
  1836. </code>
  1837. </td>
  1838. <td>
  1839. <div>
  1840. <p><code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value to be used as the <code>URLRequest</code>&lsquo;s <code>URL</code>.</p>
  1841. </div>
  1842. </td>
  1843. </tr>
  1844. <tr>
  1845. <td>
  1846. <code>
  1847. <em>method</em>
  1848. </code>
  1849. </td>
  1850. <td>
  1851. <div>
  1852. <p><code><a href="../Enums/HTTPMethod.html">HTTPMethod</a></code> for the <code>URLRequest</code>. <code>.post</code> by default.</p>
  1853. </div>
  1854. </td>
  1855. </tr>
  1856. <tr>
  1857. <td>
  1858. <code>
  1859. <em>headers</em>
  1860. </code>
  1861. </td>
  1862. <td>
  1863. <div>
  1864. <p><code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code> value to be added to the <code>URLRequest</code>. <code>nil</code> by default.</p>
  1865. </div>
  1866. </td>
  1867. </tr>
  1868. <tr>
  1869. <td>
  1870. <code>
  1871. <em>interceptor</em>
  1872. </code>
  1873. </td>
  1874. <td>
  1875. <div>
  1876. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code> by default.</p>
  1877. </div>
  1878. </td>
  1879. </tr>
  1880. </tbody>
  1881. </table>
  1882. </div>
  1883. <div>
  1884. <h4>Return Value</h4>
  1885. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  1886. </div>
  1887. </section>
  1888. </div>
  1889. </li>
  1890. <li class="item">
  1891. <div>
  1892. <code>
  1893. <a name="/s:9Alamofire2AFO6upload17multipartFormData14usingThreshold11fileManager4with11interceptorAA13UploadRequestCyAA09MultiparteF0Cc_s6UInt64VSo06NSFileJ0CAA21URLRequestConvertible_pAA0N11Interceptor_pSgtFZ"></a>
  1894. <a name="//apple_ref/swift/Method/upload(multipartFormData:usingThreshold:fileManager:with:interceptor:)" class="dashAnchor"></a>
  1895. <a class="token" href="#/s:9Alamofire2AFO6upload17multipartFormData14usingThreshold11fileManager4with11interceptorAA13UploadRequestCyAA09MultiparteF0Cc_s6UInt64VSo06NSFileJ0CAA21URLRequestConvertible_pAA0N11Interceptor_pSgtFZ">upload(multipartFormData:usingThreshold:fileManager:with:interceptor:)</a>
  1896. </code>
  1897. </div>
  1898. <div class="height-container">
  1899. <div class="pointer-container"></div>
  1900. <section class="section">
  1901. <div class="pointer"></div>
  1902. <div class="abstract">
  1903. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> using a <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code> building closure, the provided <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code>
  1904. value, and a <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  1905. <p>It is important to understand the memory implications of uploading <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code>. If the cummulative
  1906. payload is small, encoding the data in-memory and directly uploading to a server is the by far the most
  1907. efficient approach. However, if the payload is too large, encoding the data in-memory could cause your app to
  1908. be terminated. Larger payloads must first be written to disk using input and output streams to keep the memory
  1909. footprint low, then the data can be uploaded as a stream from the resulting file. Streaming from disk MUST be
  1910. used for larger payloads such as video content.</p>
  1911. <p>The <code>encodingMemoryThreshold</code> parameter allows Alamofire to automatically determine whether to encode in-memory
  1912. or stream from disk. If the content length of the <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code> is below the <code>encodingMemoryThreshold</code>,
  1913. encoding takes place in-memory. If the content length exceeds the threshold, the data is streamed to disk
  1914. during the encoding process. Then the result is uploaded as data or as a stream depending on which encoding
  1915. technique was used.</p>
  1916. </div>
  1917. <div class="declaration">
  1918. <h4>Declaration</h4>
  1919. <div class="language">
  1920. <p class="aside-title">Swift</p>
  1921. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span><span class="nv">multipartFormData</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="p">(</span><span class="kt"><a href="../Classes/MultipartFormData.html">MultipartFormData</a></span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">,</span>
  1922. <span class="n">usingThreshold</span> <span class="nv">encodingMemoryThreshold</span><span class="p">:</span> <span class="kt">UInt64</span> <span class="o">=</span> <span class="kt"><a href="../Classes/MultipartFormData.html">MultipartFormData</a></span><span class="o">.</span><span class="n">encodingMemoryThreshold</span><span class="p">,</span>
  1923. <span class="nv">fileManager</span><span class="p">:</span> <span class="kt">FileManager</span> <span class="o">=</span> <span class="o">.</span><span class="k">default</span><span class="p">,</span>
  1924. <span class="n">with</span> <span class="nv">request</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">,</span>
  1925. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  1926. </div>
  1927. </div>
  1928. <div>
  1929. <h4>Parameters</h4>
  1930. <table class="graybox">
  1931. <tbody>
  1932. <tr>
  1933. <td>
  1934. <code>
  1935. <em>multipartFormData</em>
  1936. </code>
  1937. </td>
  1938. <td>
  1939. <div>
  1940. <p><code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code> building closure.</p>
  1941. </div>
  1942. </td>
  1943. </tr>
  1944. <tr>
  1945. <td>
  1946. <code>
  1947. <em>encodingMemoryThreshold</em>
  1948. </code>
  1949. </td>
  1950. <td>
  1951. <div>
  1952. <p>Byte threshold used to determine whether the form data is encoded into memory or
  1953. onto disk before being uploaded. <code><a href="../Classes/MultipartFormData.html#/s:9Alamofire17MultipartFormDataC23encodingMemoryThresholds6UInt64VvpZ">MultipartFormData.encodingMemoryThreshold</a></code> by default.</p>
  1954. </div>
  1955. </td>
  1956. </tr>
  1957. <tr>
  1958. <td>
  1959. <code>
  1960. <em>fileManager</em>
  1961. </code>
  1962. </td>
  1963. <td>
  1964. <div>
  1965. <p><code>FileManager</code> to be used if the form data exceeds the memory threshold and is
  1966. written to disk before being uploaded.</p>
  1967. </div>
  1968. </td>
  1969. </tr>
  1970. <tr>
  1971. <td>
  1972. <code>
  1973. <em>request</em>
  1974. </code>
  1975. </td>
  1976. <td>
  1977. <div>
  1978. <p><code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value to be used to create the <code>URLRequest</code>.</p>
  1979. </div>
  1980. </td>
  1981. </tr>
  1982. <tr>
  1983. <td>
  1984. <code>
  1985. <em>interceptor</em>
  1986. </code>
  1987. </td>
  1988. <td>
  1989. <div>
  1990. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code> by default.</p>
  1991. </div>
  1992. </td>
  1993. </tr>
  1994. </tbody>
  1995. </table>
  1996. </div>
  1997. <div>
  1998. <h4>Return Value</h4>
  1999. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  2000. </div>
  2001. </section>
  2002. </div>
  2003. </li>
  2004. <li class="item">
  2005. <div>
  2006. <code>
  2007. <a name="/s:9Alamofire2AFO6upload17multipartFormData14usingThreshold2to6method7headers11interceptorAA13UploadRequestCAA09MultiparteF0C_s6UInt64VAA14URLConvertible_pAA10HTTPMethodOAA11HTTPHeadersVSgAA0N11Interceptor_pSgtFZ"></a>
  2008. <a name="//apple_ref/swift/Method/upload(multipartFormData:usingThreshold:to:method:headers:interceptor:)" class="dashAnchor"></a>
  2009. <a class="token" href="#/s:9Alamofire2AFO6upload17multipartFormData14usingThreshold2to6method7headers11interceptorAA13UploadRequestCAA09MultiparteF0C_s6UInt64VAA14URLConvertible_pAA10HTTPMethodOAA11HTTPHeadersVSgAA0N11Interceptor_pSgtFZ">upload(multipartFormData:usingThreshold:to:method:headers:interceptor:)</a>
  2010. </code>
  2011. </div>
  2012. <div class="height-container">
  2013. <div class="pointer-container"></div>
  2014. <section class="section">
  2015. <div class="pointer"></div>
  2016. <div class="abstract">
  2017. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> for the prebuilt <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code> value using the provided <code>URLRequest</code> components
  2018. and <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  2019. <p>It is important to understand the memory implications of uploading <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code>. If the cummulative
  2020. payload is small, encoding the data in-memory and directly uploading to a server is the by far the most
  2021. efficient approach. However, if the payload is too large, encoding the data in-memory could cause your app to
  2022. be terminated. Larger payloads must first be written to disk using input and output streams to keep the memory
  2023. footprint low, then the data can be uploaded as a stream from the resulting file. Streaming from disk MUST be
  2024. used for larger payloads such as video content.</p>
  2025. <p>The <code>encodingMemoryThreshold</code> parameter allows Alamofire to automatically determine whether to encode in-memory
  2026. or stream from disk. If the content length of the <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code> is below the <code>encodingMemoryThreshold</code>,
  2027. encoding takes place in-memory. If the content length exceeds the threshold, the data is streamed to disk
  2028. during the encoding process. Then the result is uploaded as data or as a stream depending on which encoding
  2029. technique was used.</p>
  2030. </div>
  2031. <div class="declaration">
  2032. <h4>Declaration</h4>
  2033. <div class="language">
  2034. <p class="aside-title">Swift</p>
  2035. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span><span class="nv">multipartFormData</span><span class="p">:</span> <span class="kt"><a href="../Classes/MultipartFormData.html">MultipartFormData</a></span><span class="p">,</span>
  2036. <span class="n">usingThreshold</span> <span class="nv">encodingMemoryThreshold</span><span class="p">:</span> <span class="kt">UInt64</span> <span class="o">=</span> <span class="kt"><a href="../Classes/MultipartFormData.html">MultipartFormData</a></span><span class="o">.</span><span class="n">encodingMemoryThreshold</span><span class="p">,</span>
  2037. <span class="n">to</span> <span class="nv">url</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  2038. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Enums/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="n">post</span><span class="p">,</span>
  2039. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  2040. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  2041. </div>
  2042. </div>
  2043. <div>
  2044. <h4>Parameters</h4>
  2045. <table class="graybox">
  2046. <tbody>
  2047. <tr>
  2048. <td>
  2049. <code>
  2050. <em>multipartFormData</em>
  2051. </code>
  2052. </td>
  2053. <td>
  2054. <div>
  2055. <p><code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code> instance to upload.</p>
  2056. </div>
  2057. </td>
  2058. </tr>
  2059. <tr>
  2060. <td>
  2061. <code>
  2062. <em>encodingMemoryThreshold</em>
  2063. </code>
  2064. </td>
  2065. <td>
  2066. <div>
  2067. <p>Byte threshold used to determine whether the form data is encoded into memory or
  2068. onto disk before being uploaded. <code><a href="../Classes/MultipartFormData.html#/s:9Alamofire17MultipartFormDataC23encodingMemoryThresholds6UInt64VvpZ">MultipartFormData.encodingMemoryThreshold</a></code> by default.</p>
  2069. </div>
  2070. </td>
  2071. </tr>
  2072. <tr>
  2073. <td>
  2074. <code>
  2075. <em>url</em>
  2076. </code>
  2077. </td>
  2078. <td>
  2079. <div>
  2080. <p><code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value to be used as the <code>URLRequest</code>&lsquo;s <code>URL</code>.</p>
  2081. </div>
  2082. </td>
  2083. </tr>
  2084. <tr>
  2085. <td>
  2086. <code>
  2087. <em>method</em>
  2088. </code>
  2089. </td>
  2090. <td>
  2091. <div>
  2092. <p><code><a href="../Enums/HTTPMethod.html">HTTPMethod</a></code> for the <code>URLRequest</code>. <code>.post</code> by default.</p>
  2093. </div>
  2094. </td>
  2095. </tr>
  2096. <tr>
  2097. <td>
  2098. <code>
  2099. <em>headers</em>
  2100. </code>
  2101. </td>
  2102. <td>
  2103. <div>
  2104. <p><code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code> value to be added to the <code>URLRequest</code>. <code>nil</code> by default.</p>
  2105. </div>
  2106. </td>
  2107. </tr>
  2108. <tr>
  2109. <td>
  2110. <code>
  2111. <em>interceptor</em>
  2112. </code>
  2113. </td>
  2114. <td>
  2115. <div>
  2116. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code> by default.</p>
  2117. </div>
  2118. </td>
  2119. </tr>
  2120. </tbody>
  2121. </table>
  2122. </div>
  2123. <div>
  2124. <h4>Return Value</h4>
  2125. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  2126. </div>
  2127. </section>
  2128. </div>
  2129. </li>
  2130. <li class="item">
  2131. <div>
  2132. <code>
  2133. <a name="/s:9Alamofire2AFO6upload17multipartFormData14usingThreshold4with11interceptorAA13UploadRequestCAA09MultiparteF0C_s6UInt64VAA21URLRequestConvertible_pAA0L11Interceptor_pSgtFZ"></a>
  2134. <a name="//apple_ref/swift/Method/upload(multipartFormData:usingThreshold:with:interceptor:)" class="dashAnchor"></a>
  2135. <a class="token" href="#/s:9Alamofire2AFO6upload17multipartFormData14usingThreshold4with11interceptorAA13UploadRequestCAA09MultiparteF0C_s6UInt64VAA21URLRequestConvertible_pAA0L11Interceptor_pSgtFZ">upload(multipartFormData:usingThreshold:with:interceptor:)</a>
  2136. </code>
  2137. </div>
  2138. <div class="height-container">
  2139. <div class="pointer-container"></div>
  2140. <section class="section">
  2141. <div class="pointer"></div>
  2142. <div class="abstract">
  2143. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> for the prebuilt <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code> value using the providing <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code>
  2144. value and <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  2145. <p>It is important to understand the memory implications of uploading <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code>. If the cummulative
  2146. payload is small, encoding the data in-memory and directly uploading to a server is the by far the most
  2147. efficient approach. However, if the payload is too large, encoding the data in-memory could cause your app to
  2148. be terminated. Larger payloads must first be written to disk using input and output streams to keep the memory
  2149. footprint low, then the data can be uploaded as a stream from the resulting file. Streaming from disk MUST be
  2150. used for larger payloads such as video content.</p>
  2151. <p>The <code>encodingMemoryThreshold</code> parameter allows Alamofire to automatically determine whether to encode in-memory
  2152. or stream from disk. If the content length of the <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code> is below the <code>encodingMemoryThreshold</code>,
  2153. encoding takes place in-memory. If the content length exceeds the threshold, the data is streamed to disk
  2154. during the encoding process. Then the result is uploaded as data or as a stream depending on which encoding
  2155. technique was used.</p>
  2156. </div>
  2157. <div class="declaration">
  2158. <h4>Declaration</h4>
  2159. <div class="language">
  2160. <p class="aside-title">Swift</p>
  2161. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span><span class="nv">multipartFormData</span><span class="p">:</span> <span class="kt"><a href="../Classes/MultipartFormData.html">MultipartFormData</a></span><span class="p">,</span>
  2162. <span class="n">usingThreshold</span> <span class="nv">encodingMemoryThreshold</span><span class="p">:</span> <span class="kt">UInt64</span> <span class="o">=</span> <span class="kt"><a href="../Classes/MultipartFormData.html">MultipartFormData</a></span><span class="o">.</span><span class="n">encodingMemoryThreshold</span><span class="p">,</span>
  2163. <span class="n">with</span> <span class="nv">request</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">,</span>
  2164. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  2165. </div>
  2166. </div>
  2167. <div>
  2168. <h4>Parameters</h4>
  2169. <table class="graybox">
  2170. <tbody>
  2171. <tr>
  2172. <td>
  2173. <code>
  2174. <em>multipartFormData</em>
  2175. </code>
  2176. </td>
  2177. <td>
  2178. <div>
  2179. <p><code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code> instance to upload.</p>
  2180. </div>
  2181. </td>
  2182. </tr>
  2183. <tr>
  2184. <td>
  2185. <code>
  2186. <em>encodingMemoryThreshold</em>
  2187. </code>
  2188. </td>
  2189. <td>
  2190. <div>
  2191. <p>Byte threshold used to determine whether the form data is encoded into memory or
  2192. onto disk before being uploaded. <code><a href="../Classes/MultipartFormData.html#/s:9Alamofire17MultipartFormDataC23encodingMemoryThresholds6UInt64VvpZ">MultipartFormData.encodingMemoryThreshold</a></code> by
  2193. default.</p>
  2194. </div>
  2195. </td>
  2196. </tr>
  2197. <tr>
  2198. <td>
  2199. <code>
  2200. <em>request</em>
  2201. </code>
  2202. </td>
  2203. <td>
  2204. <div>
  2205. <p><code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value to be used to create the <code>URLRequest</code>.</p>
  2206. </div>
  2207. </td>
  2208. </tr>
  2209. <tr>
  2210. <td>
  2211. <code>
  2212. <em>interceptor</em>
  2213. </code>
  2214. </td>
  2215. <td>
  2216. <div>
  2217. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code> by default.</p>
  2218. </div>
  2219. </td>
  2220. </tr>
  2221. </tbody>
  2222. </table>
  2223. </div>
  2224. <div>
  2225. <h4>Return Value</h4>
  2226. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  2227. </div>
  2228. </section>
  2229. </div>
  2230. </li>
  2231. </ul>
  2232. </div>
  2233. </div>
  2234. </section>
  2235. </article>
  2236. </div>
  2237. <section class="footer">
  2238. <p>&copy; 2019 <a class="link" href="http://alamofire.org/" target="_blank" rel="external">Alamofire Software Foundation</a>. All rights reserved. (Last updated: 2019-07-29)</p>
  2239. <p>Generated by <a class="link" href="https://github.com/realm/jazzy" target="_blank" rel="external">jazzy ♪♫ v0.10.0</a>, a <a class="link" href="https://realm.io" target="_blank" rel="external">Realm</a> project.</p>
  2240. </section>
  2241. </body>
  2242. </div>
  2243. </html>