Functions.html 96 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <title>Functions 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 title="Functions Reference"></a>
  16. <header class="header">
  17. <p class="header-col header-col--primary">
  18. <a class="header-link" href="index.html">
  19. Alamofire Docs
  20. </a>
  21. (87% documented)
  22. </p>
  23. <p class="header-col--secondary">
  24. <form role="search" action="search.json">
  25. <input type="text" placeholder="Search documentation" data-typeahead>
  26. </form>
  27. </p>
  28. <p class="header-col header-col--secondary">
  29. <a class="header-link" href="https://github.com/Alamofire/Alamofire">
  30. <img class="header-icon" src="img/gh.png"/>
  31. View on GitHub
  32. </a>
  33. </p>
  34. </header>
  35. <p class="breadcrumbs">
  36. <a class="breadcrumb" href="index.html">Alamofire Reference</a>
  37. <img class="carat" src="img/carat.png" />
  38. Functions Reference
  39. </p>
  40. <div class="content-wrapper">
  41. <nav class="navigation">
  42. <ul class="nav-groups">
  43. <li class="nav-group-name">
  44. <a class="nav-group-name-link" href="Classes.html">Classes</a>
  45. <ul class="nav-group-tasks">
  46. <li class="nav-group-task">
  47. <a class="nav-group-task-link" href="Classes/DataRequest.html">DataRequest</a>
  48. </li>
  49. <li class="nav-group-task">
  50. <a class="nav-group-task-link" href="Classes/DownloadRequest.html">DownloadRequest</a>
  51. </li>
  52. <li class="nav-group-task">
  53. <a class="nav-group-task-link" href="Classes/DownloadRequest/DownloadOptions.html">– DownloadOptions</a>
  54. </li>
  55. <li class="nav-group-task">
  56. <a class="nav-group-task-link" href="Classes/MultipartFormData.html">MultipartFormData</a>
  57. </li>
  58. <li class="nav-group-task">
  59. <a class="nav-group-task-link" href="Classes/NetworkReachabilityManager.html">NetworkReachabilityManager</a>
  60. </li>
  61. <li class="nav-group-task">
  62. <a class="nav-group-task-link" href="Classes/NetworkReachabilityManager/NetworkReachabilityStatus.html">– NetworkReachabilityStatus</a>
  63. </li>
  64. <li class="nav-group-task">
  65. <a class="nav-group-task-link" href="Classes/NetworkReachabilityManager/ConnectionType.html">– ConnectionType</a>
  66. </li>
  67. <li class="nav-group-task">
  68. <a class="nav-group-task-link" href="Classes/Request.html">Request</a>
  69. </li>
  70. <li class="nav-group-task">
  71. <a class="nav-group-task-link" href="Classes/Request/ValidationResult.html">– ValidationResult</a>
  72. </li>
  73. <li class="nav-group-task">
  74. <a class="nav-group-task-link" href="Classes/ServerTrustPolicyManager.html">ServerTrustPolicyManager</a>
  75. </li>
  76. <li class="nav-group-task">
  77. <a class="nav-group-task-link" href="Classes/SessionDelegate.html">SessionDelegate</a>
  78. </li>
  79. <li class="nav-group-task">
  80. <a class="nav-group-task-link" href="Classes/SessionManager.html">SessionManager</a>
  81. </li>
  82. <li class="nav-group-task">
  83. <a class="nav-group-task-link" href="Classes/SessionManager/MultipartFormDataEncodingResult.html">– MultipartFormDataEncodingResult</a>
  84. </li>
  85. <li class="nav-group-task">
  86. <a class="nav-group-task-link" href="Classes.html#/s:9Alamofire13StreamRequestC">StreamRequest</a>
  87. </li>
  88. <li class="nav-group-task">
  89. <a class="nav-group-task-link" href="Classes/TaskDelegate.html">TaskDelegate</a>
  90. </li>
  91. <li class="nav-group-task">
  92. <a class="nav-group-task-link" href="Classes/UploadRequest.html">UploadRequest</a>
  93. </li>
  94. </ul>
  95. </li>
  96. <li class="nav-group-name">
  97. <a class="nav-group-name-link" href="Enums.html">Enums</a>
  98. <ul class="nav-group-tasks">
  99. <li class="nav-group-task">
  100. <a class="nav-group-task-link" href="Enums/AFError.html">AFError</a>
  101. </li>
  102. <li class="nav-group-task">
  103. <a class="nav-group-task-link" href="Enums/AFError/ParameterEncodingFailureReason.html">– ParameterEncodingFailureReason</a>
  104. </li>
  105. <li class="nav-group-task">
  106. <a class="nav-group-task-link" href="Enums/AFError/MultipartEncodingFailureReason.html">– MultipartEncodingFailureReason</a>
  107. </li>
  108. <li class="nav-group-task">
  109. <a class="nav-group-task-link" href="Enums/AFError/ResponseValidationFailureReason.html">– ResponseValidationFailureReason</a>
  110. </li>
  111. <li class="nav-group-task">
  112. <a class="nav-group-task-link" href="Enums/AFError/ResponseSerializationFailureReason.html">– ResponseSerializationFailureReason</a>
  113. </li>
  114. <li class="nav-group-task">
  115. <a class="nav-group-task-link" href="Enums/HTTPMethod.html">HTTPMethod</a>
  116. </li>
  117. <li class="nav-group-task">
  118. <a class="nav-group-task-link" href="Enums/Result.html">Result</a>
  119. </li>
  120. <li class="nav-group-task">
  121. <a class="nav-group-task-link" href="Enums/ServerTrustPolicy.html">ServerTrustPolicy</a>
  122. </li>
  123. </ul>
  124. </li>
  125. <li class="nav-group-name">
  126. <a class="nav-group-name-link" href="Extensions.html">Extensions</a>
  127. <ul class="nav-group-tasks">
  128. <li class="nav-group-task">
  129. <a class="nav-group-task-link" href="Extensions/Notification.html">Notification</a>
  130. </li>
  131. <li class="nav-group-task">
  132. <a class="nav-group-task-link" href="Extensions/Notification/Name.html">– Name</a>
  133. </li>
  134. <li class="nav-group-task">
  135. <a class="nav-group-task-link" href="Extensions/Notification/Key.html">– Key</a>
  136. </li>
  137. <li class="nav-group-task">
  138. <a class="nav-group-task-link" href="Extensions/String.html">String</a>
  139. </li>
  140. <li class="nav-group-task">
  141. <a class="nav-group-task-link" href="Extensions/URL.html">URL</a>
  142. </li>
  143. <li class="nav-group-task">
  144. <a class="nav-group-task-link" href="Extensions/URLComponents.html">URLComponents</a>
  145. </li>
  146. <li class="nav-group-task">
  147. <a class="nav-group-task-link" href="Extensions/URLRequest.html">URLRequest</a>
  148. </li>
  149. </ul>
  150. </li>
  151. <li class="nav-group-name">
  152. <a class="nav-group-name-link" href="Functions.html">Functions</a>
  153. <ul class="nav-group-tasks">
  154. <li class="nav-group-task">
  155. <a class="nav-group-task-link" href="Functions.html#/s:9Alamofire2eeoiSbAA26NetworkReachabilityManagerC0cD6StatusO_AFtF">==(_:_:)</a>
  156. </li>
  157. <li class="nav-group-task">
  158. <a class="nav-group-task-link" href="Functions.html#/s:9Alamofire8downloadAA15DownloadRequestCAA14URLConvertible_p_AA10HTTPMethodO6methods10DictionaryVySSypGSg10parametersAA17ParameterEncoding_p8encodingAJyS2SGSg7headers10Foundation3URLV011destinationO0_AD0C7OptionsV7optionstAU_So15HTTPURLResponseCtcSg2totF">download(_:method:parameters:encoding:headers:to:)</a>
  159. </li>
  160. <li class="nav-group-task">
  161. <a class="nav-group-task-link" href="Functions.html#/s:9Alamofire8downloadAA15DownloadRequestCAA21URLRequestConvertible_p_10Foundation3URLV011destinationH0_AD0C7OptionsV7optionstAH_So15HTTPURLResponseCtcSg2totF">download(_:to:)</a>
  162. </li>
  163. <li class="nav-group-task">
  164. <a class="nav-group-task-link" href="Functions.html#/s:9Alamofire8downloadAA15DownloadRequestC10Foundation4DataV12resumingWith_AE3URLV011destinationI0_AD0C7OptionsV7optionstAJ_So15HTTPURLResponseCtcSg2totF">download(resumingWith:to:)</a>
  165. </li>
  166. <li class="nav-group-task">
  167. <a class="nav-group-task-link" href="Functions.html#/s:9Alamofire7requestAA11DataRequestCAA21URLRequestConvertible_pF">request(_:)</a>
  168. </li>
  169. <li class="nav-group-task">
  170. <a class="nav-group-task-link" href="Functions.html#/s:9Alamofire7requestAA11DataRequestCAA14URLConvertible_p_AA10HTTPMethodO6methods10DictionaryVySSypGSg10parametersAA17ParameterEncoding_p8encodingAJyS2SGSg7headerstF">request(_:method:parameters:encoding:headers:)</a>
  171. </li>
  172. <li class="nav-group-task">
  173. <a class="nav-group-task-link" href="Functions.html#/s:9Alamofire6streamAA13StreamRequestCSo10NetServiceC4with_tF">stream(with:)</a>
  174. </li>
  175. <li class="nav-group-task">
  176. <a class="nav-group-task-link" href="Functions.html#/s:9Alamofire6streamAA13StreamRequestCSS12withHostName_Si4porttF">stream(withHostName:port:)</a>
  177. </li>
  178. <li class="nav-group-task">
  179. <a class="nav-group-task-link" href="Functions.html#/s:9Alamofire6uploadAA13UploadRequestC10Foundation3URLV_AA14URLConvertible_p2toAA10HTTPMethodO6methods10DictionaryVyS2SGSg7headerstF">upload(_:to:method:headers:)</a>
  180. </li>
  181. <li class="nav-group-task">
  182. <a class="nav-group-task-link" href="Functions.html#/s:9Alamofire6uploadAA13UploadRequestC10Foundation4DataV_AA14URLConvertible_p2toAA10HTTPMethodO6methods10DictionaryVyS2SGSg7headerstF">upload(_:to:method:headers:)</a>
  183. </li>
  184. <li class="nav-group-task">
  185. <a class="nav-group-task-link" href="Functions.html#/s:9Alamofire6uploadAA13UploadRequestCSo11InputStreamC_AA14URLConvertible_p2toAA10HTTPMethodO6methods10DictionaryVyS2SGSg7headerstF">upload(_:to:method:headers:)</a>
  186. </li>
  187. <li class="nav-group-task">
  188. <a class="nav-group-task-link" href="Functions.html#/s:9Alamofire6uploadAA13UploadRequestC10Foundation3URLV_AA21URLRequestConvertible_p4withtF">upload(_:with:)</a>
  189. </li>
  190. <li class="nav-group-task">
  191. <a class="nav-group-task-link" href="Functions.html#/s:9Alamofire6uploadAA13UploadRequestC10Foundation4DataV_AA21URLRequestConvertible_p4withtF">upload(_:with:)</a>
  192. </li>
  193. <li class="nav-group-task">
  194. <a class="nav-group-task-link" href="Functions.html#/s:9Alamofire6uploadAA13UploadRequestCSo11InputStreamC_AA21URLRequestConvertible_p4withtF">upload(_:with:)</a>
  195. </li>
  196. <li class="nav-group-task">
  197. <a class="nav-group-task-link" href="Functions.html#/s:9Alamofire6uploadyyAA17MultipartFormDataCc09multipartdE0_s6UInt64V14usingThresholdAA14URLConvertible_p2toAA10HTTPMethodO6methods10DictionaryVyS2SGSg7headersyAA14SessionManagerC0cdE14EncodingResultOcSg18encodingCompletiontF">upload(multipartFormData:usingThreshold:to:method:headers:encodingCompletion:)</a>
  198. </li>
  199. <li class="nav-group-task">
  200. <a class="nav-group-task-link" href="Functions.html#/s:9Alamofire6uploadyyAA17MultipartFormDataCc09multipartdE0_s6UInt64V14usingThresholdAA21URLRequestConvertible_p4withyAA14SessionManagerC0cdE14EncodingResultOcSg18encodingCompletiontF">upload(multipartFormData:usingThreshold:with:encodingCompletion:)</a>
  201. </li>
  202. </ul>
  203. </li>
  204. <li class="nav-group-name">
  205. <a class="nav-group-name-link" href="Protocols.html">Protocols</a>
  206. <ul class="nav-group-tasks">
  207. <li class="nav-group-task">
  208. <a class="nav-group-task-link" href="Protocols/DataResponseSerializerProtocol.html">DataResponseSerializerProtocol</a>
  209. </li>
  210. <li class="nav-group-task">
  211. <a class="nav-group-task-link" href="Protocols/DownloadResponseSerializerProtocol.html">DownloadResponseSerializerProtocol</a>
  212. </li>
  213. <li class="nav-group-task">
  214. <a class="nav-group-task-link" href="Protocols/ParameterEncoding.html">ParameterEncoding</a>
  215. </li>
  216. <li class="nav-group-task">
  217. <a class="nav-group-task-link" href="Protocols/RequestAdapter.html">RequestAdapter</a>
  218. </li>
  219. <li class="nav-group-task">
  220. <a class="nav-group-task-link" href="Protocols/RequestRetrier.html">RequestRetrier</a>
  221. </li>
  222. <li class="nav-group-task">
  223. <a class="nav-group-task-link" href="Protocols/URLConvertible.html">URLConvertible</a>
  224. </li>
  225. <li class="nav-group-task">
  226. <a class="nav-group-task-link" href="Protocols/URLRequestConvertible.html">URLRequestConvertible</a>
  227. </li>
  228. </ul>
  229. </li>
  230. <li class="nav-group-name">
  231. <a class="nav-group-name-link" href="Structs.html">Structs</a>
  232. <ul class="nav-group-tasks">
  233. <li class="nav-group-task">
  234. <a class="nav-group-task-link" href="Structs/DataResponse.html">DataResponse</a>
  235. </li>
  236. <li class="nav-group-task">
  237. <a class="nav-group-task-link" href="Structs/DataResponseSerializer.html">DataResponseSerializer</a>
  238. </li>
  239. <li class="nav-group-task">
  240. <a class="nav-group-task-link" href="Structs/DefaultDataResponse.html">DefaultDataResponse</a>
  241. </li>
  242. <li class="nav-group-task">
  243. <a class="nav-group-task-link" href="Structs/DefaultDownloadResponse.html">DefaultDownloadResponse</a>
  244. </li>
  245. <li class="nav-group-task">
  246. <a class="nav-group-task-link" href="Structs/DownloadResponse.html">DownloadResponse</a>
  247. </li>
  248. <li class="nav-group-task">
  249. <a class="nav-group-task-link" href="Structs/DownloadResponseSerializer.html">DownloadResponseSerializer</a>
  250. </li>
  251. <li class="nav-group-task">
  252. <a class="nav-group-task-link" href="Structs/JSONEncoding.html">JSONEncoding</a>
  253. </li>
  254. <li class="nav-group-task">
  255. <a class="nav-group-task-link" href="Structs/PropertyListEncoding.html">PropertyListEncoding</a>
  256. </li>
  257. <li class="nav-group-task">
  258. <a class="nav-group-task-link" href="Structs/Timeline.html">Timeline</a>
  259. </li>
  260. <li class="nav-group-task">
  261. <a class="nav-group-task-link" href="Structs/URLEncoding.html">URLEncoding</a>
  262. </li>
  263. <li class="nav-group-task">
  264. <a class="nav-group-task-link" href="Structs/URLEncoding/Destination.html">– Destination</a>
  265. </li>
  266. </ul>
  267. </li>
  268. <li class="nav-group-name">
  269. <a class="nav-group-name-link" href="Typealiases.html">Typealiases</a>
  270. <ul class="nav-group-tasks">
  271. <li class="nav-group-task">
  272. <a class="nav-group-task-link" href="Typealiases.html#/s:9Alamofire11HTTPHeadersa">HTTPHeaders</a>
  273. </li>
  274. <li class="nav-group-task">
  275. <a class="nav-group-task-link" href="Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a>
  276. </li>
  277. <li class="nav-group-task">
  278. <a class="nav-group-task-link" href="Typealiases.html#/s:9Alamofire22RequestRetryCompletiona">RequestRetryCompletion</a>
  279. </li>
  280. </ul>
  281. </li>
  282. </ul>
  283. </nav>
  284. <article class="main-content">
  285. <section class="section">
  286. <div class="section-content">
  287. <h1>Functions</h1>
  288. <p>The following functions are available globally.</p>
  289. </div>
  290. </section>
  291. <section class="section">
  292. <div class="section-content">
  293. <div class="task-group">
  294. <div class="task-name-container">
  295. <a name="/Data%20Request"></a>
  296. <a name="//apple_ref/swift/Section/Data Request" class="dashAnchor"></a>
  297. <a href="#/Data%20Request">
  298. <h3 class="section-name">Data Request</h3>
  299. </a>
  300. </div>
  301. <ul class="item-container">
  302. <li class="item">
  303. <div>
  304. <code>
  305. <a name="/s:9Alamofire7requestAA11DataRequestCAA14URLConvertible_p_AA10HTTPMethodO6methods10DictionaryVySSypGSg10parametersAA17ParameterEncoding_p8encodingAJyS2SGSg7headerstF"></a>
  306. <a name="//apple_ref/swift/Function/request(_:method:parameters:encoding:headers:)" class="dashAnchor"></a>
  307. <a class="token" href="#/s:9Alamofire7requestAA11DataRequestCAA14URLConvertible_p_AA10HTTPMethodO6methods10DictionaryVySSypGSg10parametersAA17ParameterEncoding_p8encodingAJyS2SGSg7headerstF">request(_:method:parameters:encoding:headers:)</a>
  308. </code>
  309. </div>
  310. <div class="height-container">
  311. <div class="pointer-container"></div>
  312. <section class="section">
  313. <div class="pointer"></div>
  314. <div class="abstract">
  315. <p>Creates a <code><a href="Classes/DataRequest.html">DataRequest</a></code> using the default <code><a href="Classes/SessionManager.html">SessionManager</a></code> to retrieve the contents of the specified <code>url</code>,
  316. <code>method</code>, <code>parameters</code>, <code>encoding</code> and <code>headers</code>.</p>
  317. </div>
  318. <div class="declaration">
  319. <h4>Declaration</h4>
  320. <div class="language">
  321. <p class="aside-title">Swift</p>
  322. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">request</span><span class="p">(</span>
  323. <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>
  324. <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>
  325. <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>
  326. <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>
  327. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="Typealiases.html#/s:9Alamofire11HTTPHeadersa">HTTPHeaders</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span>
  328. <span class="o">-&gt;</span> <span class="kt"><a href="Classes/DataRequest.html">DataRequest</a></span></code></pre>
  329. </div>
  330. </div>
  331. <div>
  332. <h4>Parameters</h4>
  333. <table class="graybox">
  334. <tbody>
  335. <tr>
  336. <td>
  337. <code>
  338. <em>url</em>
  339. </code>
  340. </td>
  341. <td>
  342. <div>
  343. <p>The URL.</p>
  344. </div>
  345. </td>
  346. </tr>
  347. <tr>
  348. <td>
  349. <code>
  350. <em>method</em>
  351. </code>
  352. </td>
  353. <td>
  354. <div>
  355. <p>The HTTP method. <code>.get</code> by default.</p>
  356. </div>
  357. </td>
  358. </tr>
  359. <tr>
  360. <td>
  361. <code>
  362. <em>parameters</em>
  363. </code>
  364. </td>
  365. <td>
  366. <div>
  367. <p>The parameters. <code>nil</code> by default.</p>
  368. </div>
  369. </td>
  370. </tr>
  371. <tr>
  372. <td>
  373. <code>
  374. <em>encoding</em>
  375. </code>
  376. </td>
  377. <td>
  378. <div>
  379. <p>The parameter encoding. <code>URLEncoding.default</code> by default.</p>
  380. </div>
  381. </td>
  382. </tr>
  383. <tr>
  384. <td>
  385. <code>
  386. <em>headers</em>
  387. </code>
  388. </td>
  389. <td>
  390. <div>
  391. <p>The HTTP headers. <code>nil</code> by default.</p>
  392. </div>
  393. </td>
  394. </tr>
  395. </tbody>
  396. </table>
  397. </div>
  398. <div>
  399. <h4>Return Value</h4>
  400. <p>The created <code><a href="Classes/DataRequest.html">DataRequest</a></code>.</p>
  401. </div>
  402. </section>
  403. </div>
  404. </li>
  405. <li class="item">
  406. <div>
  407. <code>
  408. <a name="/s:9Alamofire7requestAA11DataRequestCAA21URLRequestConvertible_pF"></a>
  409. <a name="//apple_ref/swift/Function/request(_:)" class="dashAnchor"></a>
  410. <a class="token" href="#/s:9Alamofire7requestAA11DataRequestCAA21URLRequestConvertible_pF">request(_:)</a>
  411. </code>
  412. </div>
  413. <div class="height-container">
  414. <div class="pointer-container"></div>
  415. <section class="section">
  416. <div class="pointer"></div>
  417. <div class="abstract">
  418. <p>Creates a <code><a href="Classes/DataRequest.html">DataRequest</a></code> using the default <code><a href="Classes/SessionManager.html">SessionManager</a></code> to retrieve the contents of a URL based on the
  419. specified <code>urlRequest</code>.</p>
  420. </div>
  421. <div class="declaration">
  422. <h4>Declaration</h4>
  423. <div class="language">
  424. <p class="aside-title">Swift</p>
  425. <pre class="highlight"><code><span class="kd">public</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="o">-&gt;</span> <span class="kt"><a href="Classes/DataRequest.html">DataRequest</a></span></code></pre>
  426. </div>
  427. </div>
  428. <div>
  429. <h4>Parameters</h4>
  430. <table class="graybox">
  431. <tbody>
  432. <tr>
  433. <td>
  434. <code>
  435. <em>urlRequest</em>
  436. </code>
  437. </td>
  438. <td>
  439. <div>
  440. <p>The URL request</p>
  441. </div>
  442. </td>
  443. </tr>
  444. </tbody>
  445. </table>
  446. </div>
  447. <div>
  448. <h4>Return Value</h4>
  449. <p>The created <code><a href="Classes/DataRequest.html">DataRequest</a></code>.</p>
  450. </div>
  451. </section>
  452. </div>
  453. </li>
  454. </ul>
  455. </div>
  456. <div class="task-group">
  457. <div class="task-name-container">
  458. <a name="/URL%20Request"></a>
  459. <a name="//apple_ref/swift/Section/URL Request" class="dashAnchor"></a>
  460. <a href="#/URL%20Request">
  461. <h3 class="section-name">URL Request</h3>
  462. </a>
  463. </div>
  464. <ul class="item-container">
  465. <li class="item">
  466. <div>
  467. <code>
  468. <a name="/s:9Alamofire8downloadAA15DownloadRequestCAA14URLConvertible_p_AA10HTTPMethodO6methods10DictionaryVySSypGSg10parametersAA17ParameterEncoding_p8encodingAJyS2SGSg7headers10Foundation3URLV011destinationO0_AD0C7OptionsV7optionstAU_So15HTTPURLResponseCtcSg2totF"></a>
  469. <a name="//apple_ref/swift/Function/download(_:method:parameters:encoding:headers:to:)" class="dashAnchor"></a>
  470. <a class="token" href="#/s:9Alamofire8downloadAA15DownloadRequestCAA14URLConvertible_p_AA10HTTPMethodO6methods10DictionaryVySSypGSg10parametersAA17ParameterEncoding_p8encodingAJyS2SGSg7headers10Foundation3URLV011destinationO0_AD0C7OptionsV7optionstAU_So15HTTPURLResponseCtcSg2totF">download(_:method:parameters:encoding:headers:to:)</a>
  471. </code>
  472. </div>
  473. <div class="height-container">
  474. <div class="pointer-container"></div>
  475. <section class="section">
  476. <div class="pointer"></div>
  477. <div class="abstract">
  478. <p>Creates a <code><a href="Classes/DownloadRequest.html">DownloadRequest</a></code> using the default <code><a href="Classes/SessionManager.html">SessionManager</a></code> to retrieve the contents of the specified <code>url</code>,
  479. <code>method</code>, <code>parameters</code>, <code>encoding</code>, <code>headers</code> and save them to the <code>destination</code>.</p>
  480. <p>If <code>destination</code> is not specified, the contents will remain in the temporary location determined by the
  481. underlying URL session.</p>
  482. </div>
  483. <div class="declaration">
  484. <h4>Declaration</h4>
  485. <div class="language">
  486. <p class="aside-title">Swift</p>
  487. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">download</span><span class="p">(</span>
  488. <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>
  489. <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>
  490. <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>
  491. <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>
  492. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="Typealiases.html#/s:9Alamofire11HTTPHeadersa">HTTPHeaders</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  493. <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">DownloadFileDestination</span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span>
  494. <span class="o">-&gt;</span> <span class="kt"><a href="Classes/DownloadRequest.html">DownloadRequest</a></span></code></pre>
  495. </div>
  496. </div>
  497. <div>
  498. <h4>Parameters</h4>
  499. <table class="graybox">
  500. <tbody>
  501. <tr>
  502. <td>
  503. <code>
  504. <em>url</em>
  505. </code>
  506. </td>
  507. <td>
  508. <div>
  509. <p>The URL.</p>
  510. </div>
  511. </td>
  512. </tr>
  513. <tr>
  514. <td>
  515. <code>
  516. <em>method</em>
  517. </code>
  518. </td>
  519. <td>
  520. <div>
  521. <p>The HTTP method. <code>.get</code> by default.</p>
  522. </div>
  523. </td>
  524. </tr>
  525. <tr>
  526. <td>
  527. <code>
  528. <em>parameters</em>
  529. </code>
  530. </td>
  531. <td>
  532. <div>
  533. <p>The parameters. <code>nil</code> by default.</p>
  534. </div>
  535. </td>
  536. </tr>
  537. <tr>
  538. <td>
  539. <code>
  540. <em>encoding</em>
  541. </code>
  542. </td>
  543. <td>
  544. <div>
  545. <p>The parameter encoding. <code>URLEncoding.default</code> by default.</p>
  546. </div>
  547. </td>
  548. </tr>
  549. <tr>
  550. <td>
  551. <code>
  552. <em>headers</em>
  553. </code>
  554. </td>
  555. <td>
  556. <div>
  557. <p>The HTTP headers. <code>nil</code> by default.</p>
  558. </div>
  559. </td>
  560. </tr>
  561. <tr>
  562. <td>
  563. <code>
  564. <em>destination</em>
  565. </code>
  566. </td>
  567. <td>
  568. <div>
  569. <p>The closure used to determine the destination of the downloaded file. <code>nil</code> by default.</p>
  570. </div>
  571. </td>
  572. </tr>
  573. </tbody>
  574. </table>
  575. </div>
  576. <div>
  577. <h4>Return Value</h4>
  578. <p>The created <code><a href="Classes/DownloadRequest.html">DownloadRequest</a></code>.</p>
  579. </div>
  580. </section>
  581. </div>
  582. </li>
  583. <li class="item">
  584. <div>
  585. <code>
  586. <a name="/s:9Alamofire8downloadAA15DownloadRequestCAA21URLRequestConvertible_p_10Foundation3URLV011destinationH0_AD0C7OptionsV7optionstAH_So15HTTPURLResponseCtcSg2totF"></a>
  587. <a name="//apple_ref/swift/Function/download(_:to:)" class="dashAnchor"></a>
  588. <a class="token" href="#/s:9Alamofire8downloadAA15DownloadRequestCAA21URLRequestConvertible_p_10Foundation3URLV011destinationH0_AD0C7OptionsV7optionstAH_So15HTTPURLResponseCtcSg2totF">download(_:to:)</a>
  589. </code>
  590. </div>
  591. <div class="height-container">
  592. <div class="pointer-container"></div>
  593. <section class="section">
  594. <div class="pointer"></div>
  595. <div class="abstract">
  596. <p>Creates a <code><a href="Classes/DownloadRequest.html">DownloadRequest</a></code> using the default <code><a href="Classes/SessionManager.html">SessionManager</a></code> to retrieve the contents of a URL based on the
  597. specified <code>urlRequest</code> and save them to the <code>destination</code>.</p>
  598. <p>If <code>destination</code> is not specified, the contents will remain in the temporary location determined by the
  599. underlying URL session.</p>
  600. </div>
  601. <div class="declaration">
  602. <h4>Declaration</h4>
  603. <div class="language">
  604. <p class="aside-title">Swift</p>
  605. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">download</span><span class="p">(</span>
  606. <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>
  607. <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">DownloadFileDestination</span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span>
  608. <span class="o">-&gt;</span> <span class="kt"><a href="Classes/DownloadRequest.html">DownloadRequest</a></span></code></pre>
  609. </div>
  610. </div>
  611. <div>
  612. <h4>Parameters</h4>
  613. <table class="graybox">
  614. <tbody>
  615. <tr>
  616. <td>
  617. <code>
  618. <em>urlRequest</em>
  619. </code>
  620. </td>
  621. <td>
  622. <div>
  623. <p>The URL request.</p>
  624. </div>
  625. </td>
  626. </tr>
  627. <tr>
  628. <td>
  629. <code>
  630. <em>destination</em>
  631. </code>
  632. </td>
  633. <td>
  634. <div>
  635. <p>The closure used to determine the destination of the downloaded file. <code>nil</code> by default.</p>
  636. </div>
  637. </td>
  638. </tr>
  639. </tbody>
  640. </table>
  641. </div>
  642. <div>
  643. <h4>Return Value</h4>
  644. <p>The created <code><a href="Classes/DownloadRequest.html">DownloadRequest</a></code>.</p>
  645. </div>
  646. </section>
  647. </div>
  648. </li>
  649. </ul>
  650. </div>
  651. <div class="task-group">
  652. <div class="task-name-container">
  653. <a name="/Resume%20Data"></a>
  654. <a name="//apple_ref/swift/Section/Resume Data" class="dashAnchor"></a>
  655. <a href="#/Resume%20Data">
  656. <h3 class="section-name">Resume Data</h3>
  657. </a>
  658. </div>
  659. <ul class="item-container">
  660. <li class="item">
  661. <div>
  662. <code>
  663. <a name="/s:9Alamofire8downloadAA15DownloadRequestC10Foundation4DataV12resumingWith_AE3URLV011destinationI0_AD0C7OptionsV7optionstAJ_So15HTTPURLResponseCtcSg2totF"></a>
  664. <a name="//apple_ref/swift/Function/download(resumingWith:to:)" class="dashAnchor"></a>
  665. <a class="token" href="#/s:9Alamofire8downloadAA15DownloadRequestC10Foundation4DataV12resumingWith_AE3URLV011destinationI0_AD0C7OptionsV7optionstAJ_So15HTTPURLResponseCtcSg2totF">download(resumingWith:to:)</a>
  666. </code>
  667. </div>
  668. <div class="height-container">
  669. <div class="pointer-container"></div>
  670. <section class="section">
  671. <div class="pointer"></div>
  672. <div class="abstract">
  673. <p>Creates a <code><a href="Classes/DownloadRequest.html">DownloadRequest</a></code> using the default <code><a href="Classes/SessionManager.html">SessionManager</a></code> from the <code>resumeData</code> produced from a
  674. previous request cancellation to retrieve the contents of the original request and save them to the <code>destination</code>.</p>
  675. <p>If <code>destination</code> is not specified, the contents will remain in the temporary location determined by the
  676. underlying URL session.</p>
  677. <p>On the latest release of all the Apple platforms (iOS 10, macOS 10.12, tvOS 10, watchOS 3), <code>resumeData</code> is broken
  678. on background URL session configurations. There&rsquo;s an underlying bug in the <code>resumeData</code> generation logic where the
  679. data is written incorrectly and will always fail to resume the download. For more information about the bug and
  680. possible workarounds, please refer to the following Stack Overflow post:</p>
  681. <ul>
  682. <li><p><a href="http://stackoverflow.com/a/39347461/1342462">http://stackoverflow.com/a/39347461/1342462</a></p></li>
  683. </ul>
  684. </div>
  685. <div class="declaration">
  686. <h4>Declaration</h4>
  687. <div class="language">
  688. <p class="aside-title">Swift</p>
  689. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">download</span><span class="p">(</span>
  690. <span class="n">resumingWith</span> <span class="nv">resumeData</span><span class="p">:</span> <span class="kt">Data</span><span class="p">,</span>
  691. <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">DownloadFileDestination</span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span>
  692. <span class="o">-&gt;</span> <span class="kt"><a href="Classes/DownloadRequest.html">DownloadRequest</a></span></code></pre>
  693. </div>
  694. </div>
  695. <div>
  696. <h4>Parameters</h4>
  697. <table class="graybox">
  698. <tbody>
  699. <tr>
  700. <td>
  701. <code>
  702. <em>resumeData</em>
  703. </code>
  704. </td>
  705. <td>
  706. <div>
  707. <p>The resume data. This is an opaque data blob produced by <code>URLSessionDownloadTask</code>
  708. when a task is cancelled. See <code>URLSession -downloadTask(withResumeData:)</code> for additional
  709. information.</p>
  710. </div>
  711. </td>
  712. </tr>
  713. <tr>
  714. <td>
  715. <code>
  716. <em>destination</em>
  717. </code>
  718. </td>
  719. <td>
  720. <div>
  721. <p>The closure used to determine the destination of the downloaded file. <code>nil</code> by default.</p>
  722. </div>
  723. </td>
  724. </tr>
  725. </tbody>
  726. </table>
  727. </div>
  728. <div>
  729. <h4>Return Value</h4>
  730. <p>The created <code><a href="Classes/DownloadRequest.html">DownloadRequest</a></code>.</p>
  731. </div>
  732. </section>
  733. </div>
  734. </li>
  735. </ul>
  736. </div>
  737. <div class="task-group">
  738. <div class="task-name-container">
  739. <a name="/File"></a>
  740. <a name="//apple_ref/swift/Section/File" class="dashAnchor"></a>
  741. <a href="#/File">
  742. <h3 class="section-name">File</h3>
  743. </a>
  744. </div>
  745. <ul class="item-container">
  746. <li class="item">
  747. <div>
  748. <code>
  749. <a name="/s:9Alamofire6uploadAA13UploadRequestC10Foundation3URLV_AA14URLConvertible_p2toAA10HTTPMethodO6methods10DictionaryVyS2SGSg7headerstF"></a>
  750. <a name="//apple_ref/swift/Function/upload(_:to:method:headers:)" class="dashAnchor"></a>
  751. <a class="token" href="#/s:9Alamofire6uploadAA13UploadRequestC10Foundation3URLV_AA14URLConvertible_p2toAA10HTTPMethodO6methods10DictionaryVyS2SGSg7headerstF">upload(_:to:method:headers:)</a>
  752. </code>
  753. </div>
  754. <div class="height-container">
  755. <div class="pointer-container"></div>
  756. <section class="section">
  757. <div class="pointer"></div>
  758. <div class="abstract">
  759. <p>Creates an <code><a href="Classes/UploadRequest.html">UploadRequest</a></code> using the default <code><a href="Classes/SessionManager.html">SessionManager</a></code> from the specified <code>url</code>, <code>method</code> and <code>headers</code>
  760. for uploading the <code>file</code>.</p>
  761. </div>
  762. <div class="declaration">
  763. <h4>Declaration</h4>
  764. <div class="language">
  765. <p class="aside-title">Swift</p>
  766. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span>
  767. <span class="n">_</span> <span class="nv">fileURL</span><span class="p">:</span> <span class="kt">URL</span><span class="p">,</span>
  768. <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>
  769. <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>
  770. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="Typealiases.html#/s:9Alamofire11HTTPHeadersa">HTTPHeaders</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span>
  771. <span class="o">-&gt;</span> <span class="kt"><a href="Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  772. </div>
  773. </div>
  774. <div>
  775. <h4>Parameters</h4>
  776. <table class="graybox">
  777. <tbody>
  778. <tr>
  779. <td>
  780. <code>
  781. <em>file</em>
  782. </code>
  783. </td>
  784. <td>
  785. <div>
  786. <p>The file to upload.</p>
  787. </div>
  788. </td>
  789. </tr>
  790. <tr>
  791. <td>
  792. <code>
  793. <em>url</em>
  794. </code>
  795. </td>
  796. <td>
  797. <div>
  798. <p>The URL.</p>
  799. </div>
  800. </td>
  801. </tr>
  802. <tr>
  803. <td>
  804. <code>
  805. <em>method</em>
  806. </code>
  807. </td>
  808. <td>
  809. <div>
  810. <p>The HTTP method. <code>.post</code> by default.</p>
  811. </div>
  812. </td>
  813. </tr>
  814. <tr>
  815. <td>
  816. <code>
  817. <em>headers</em>
  818. </code>
  819. </td>
  820. <td>
  821. <div>
  822. <p>The HTTP headers. <code>nil</code> by default.</p>
  823. </div>
  824. </td>
  825. </tr>
  826. </tbody>
  827. </table>
  828. </div>
  829. <div>
  830. <h4>Return Value</h4>
  831. <p>The created <code><a href="Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  832. </div>
  833. </section>
  834. </div>
  835. </li>
  836. <li class="item">
  837. <div>
  838. <code>
  839. <a name="/s:9Alamofire6uploadAA13UploadRequestC10Foundation3URLV_AA21URLRequestConvertible_p4withtF"></a>
  840. <a name="//apple_ref/swift/Function/upload(_:with:)" class="dashAnchor"></a>
  841. <a class="token" href="#/s:9Alamofire6uploadAA13UploadRequestC10Foundation3URLV_AA21URLRequestConvertible_p4withtF">upload(_:with:)</a>
  842. </code>
  843. </div>
  844. <div class="height-container">
  845. <div class="pointer-container"></div>
  846. <section class="section">
  847. <div class="pointer"></div>
  848. <div class="abstract">
  849. <p>Creates a <code><a href="Classes/UploadRequest.html">UploadRequest</a></code> using the default <code><a href="Classes/SessionManager.html">SessionManager</a></code> from the specified <code>urlRequest</code> for
  850. uploading the <code>file</code>.</p>
  851. </div>
  852. <div class="declaration">
  853. <h4>Declaration</h4>
  854. <div class="language">
  855. <p class="aside-title">Swift</p>
  856. <pre class="highlight"><code><span class="kd">public</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> <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> <span class="o">-&gt;</span> <span class="kt"><a href="Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  857. </div>
  858. </div>
  859. <div>
  860. <h4>Parameters</h4>
  861. <table class="graybox">
  862. <tbody>
  863. <tr>
  864. <td>
  865. <code>
  866. <em>file</em>
  867. </code>
  868. </td>
  869. <td>
  870. <div>
  871. <p>The file to upload.</p>
  872. </div>
  873. </td>
  874. </tr>
  875. <tr>
  876. <td>
  877. <code>
  878. <em>urlRequest</em>
  879. </code>
  880. </td>
  881. <td>
  882. <div>
  883. <p>The URL request.</p>
  884. </div>
  885. </td>
  886. </tr>
  887. </tbody>
  888. </table>
  889. </div>
  890. <div>
  891. <h4>Return Value</h4>
  892. <p>The created <code><a href="Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  893. </div>
  894. </section>
  895. </div>
  896. </li>
  897. </ul>
  898. </div>
  899. <div class="task-group">
  900. <div class="task-name-container">
  901. <a name="/Data"></a>
  902. <a name="//apple_ref/swift/Section/Data" class="dashAnchor"></a>
  903. <a href="#/Data">
  904. <h3 class="section-name">Data</h3>
  905. </a>
  906. </div>
  907. <ul class="item-container">
  908. <li class="item">
  909. <div>
  910. <code>
  911. <a name="/s:9Alamofire6uploadAA13UploadRequestC10Foundation4DataV_AA14URLConvertible_p2toAA10HTTPMethodO6methods10DictionaryVyS2SGSg7headerstF"></a>
  912. <a name="//apple_ref/swift/Function/upload(_:to:method:headers:)" class="dashAnchor"></a>
  913. <a class="token" href="#/s:9Alamofire6uploadAA13UploadRequestC10Foundation4DataV_AA14URLConvertible_p2toAA10HTTPMethodO6methods10DictionaryVyS2SGSg7headerstF">upload(_:to:method:headers:)</a>
  914. </code>
  915. </div>
  916. <div class="height-container">
  917. <div class="pointer-container"></div>
  918. <section class="section">
  919. <div class="pointer"></div>
  920. <div class="abstract">
  921. <p>Creates an <code><a href="Classes/UploadRequest.html">UploadRequest</a></code> using the default <code><a href="Classes/SessionManager.html">SessionManager</a></code> from the specified <code>url</code>, <code>method</code> and <code>headers</code>
  922. for uploading the <code>data</code>.</p>
  923. </div>
  924. <div class="declaration">
  925. <h4>Declaration</h4>
  926. <div class="language">
  927. <p class="aside-title">Swift</p>
  928. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span>
  929. <span class="n">_</span> <span class="nv">data</span><span class="p">:</span> <span class="kt">Data</span><span class="p">,</span>
  930. <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>
  931. <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>
  932. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="Typealiases.html#/s:9Alamofire11HTTPHeadersa">HTTPHeaders</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span>
  933. <span class="o">-&gt;</span> <span class="kt"><a href="Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  934. </div>
  935. </div>
  936. <div>
  937. <h4>Parameters</h4>
  938. <table class="graybox">
  939. <tbody>
  940. <tr>
  941. <td>
  942. <code>
  943. <em>data</em>
  944. </code>
  945. </td>
  946. <td>
  947. <div>
  948. <p>The data to upload.</p>
  949. </div>
  950. </td>
  951. </tr>
  952. <tr>
  953. <td>
  954. <code>
  955. <em>url</em>
  956. </code>
  957. </td>
  958. <td>
  959. <div>
  960. <p>The URL.</p>
  961. </div>
  962. </td>
  963. </tr>
  964. <tr>
  965. <td>
  966. <code>
  967. <em>method</em>
  968. </code>
  969. </td>
  970. <td>
  971. <div>
  972. <p>The HTTP method. <code>.post</code> by default.</p>
  973. </div>
  974. </td>
  975. </tr>
  976. <tr>
  977. <td>
  978. <code>
  979. <em>headers</em>
  980. </code>
  981. </td>
  982. <td>
  983. <div>
  984. <p>The HTTP headers. <code>nil</code> by default.</p>
  985. </div>
  986. </td>
  987. </tr>
  988. </tbody>
  989. </table>
  990. </div>
  991. <div>
  992. <h4>Return Value</h4>
  993. <p>The created <code><a href="Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  994. </div>
  995. </section>
  996. </div>
  997. </li>
  998. <li class="item">
  999. <div>
  1000. <code>
  1001. <a name="/s:9Alamofire6uploadAA13UploadRequestC10Foundation4DataV_AA21URLRequestConvertible_p4withtF"></a>
  1002. <a name="//apple_ref/swift/Function/upload(_:with:)" class="dashAnchor"></a>
  1003. <a class="token" href="#/s:9Alamofire6uploadAA13UploadRequestC10Foundation4DataV_AA21URLRequestConvertible_p4withtF">upload(_:with:)</a>
  1004. </code>
  1005. </div>
  1006. <div class="height-container">
  1007. <div class="pointer-container"></div>
  1008. <section class="section">
  1009. <div class="pointer"></div>
  1010. <div class="abstract">
  1011. <p>Creates an <code><a href="Classes/UploadRequest.html">UploadRequest</a></code> using the default <code><a href="Classes/SessionManager.html">SessionManager</a></code> from the specified <code>urlRequest</code> for
  1012. uploading the <code>data</code>.</p>
  1013. </div>
  1014. <div class="declaration">
  1015. <h4>Declaration</h4>
  1016. <div class="language">
  1017. <p class="aside-title">Swift</p>
  1018. <pre class="highlight"><code><span class="kd">public</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> <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> <span class="o">-&gt;</span> <span class="kt"><a href="Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  1019. </div>
  1020. </div>
  1021. <div>
  1022. <h4>Parameters</h4>
  1023. <table class="graybox">
  1024. <tbody>
  1025. <tr>
  1026. <td>
  1027. <code>
  1028. <em>data</em>
  1029. </code>
  1030. </td>
  1031. <td>
  1032. <div>
  1033. <p>The data to upload.</p>
  1034. </div>
  1035. </td>
  1036. </tr>
  1037. <tr>
  1038. <td>
  1039. <code>
  1040. <em>urlRequest</em>
  1041. </code>
  1042. </td>
  1043. <td>
  1044. <div>
  1045. <p>The URL request.</p>
  1046. </div>
  1047. </td>
  1048. </tr>
  1049. </tbody>
  1050. </table>
  1051. </div>
  1052. <div>
  1053. <h4>Return Value</h4>
  1054. <p>The created <code><a href="Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  1055. </div>
  1056. </section>
  1057. </div>
  1058. </li>
  1059. </ul>
  1060. </div>
  1061. <div class="task-group">
  1062. <div class="task-name-container">
  1063. <a name="/InputStream"></a>
  1064. <a name="//apple_ref/swift/Section/InputStream" class="dashAnchor"></a>
  1065. <a href="#/InputStream">
  1066. <h3 class="section-name">InputStream</h3>
  1067. </a>
  1068. </div>
  1069. <ul class="item-container">
  1070. <li class="item">
  1071. <div>
  1072. <code>
  1073. <a name="/s:9Alamofire6uploadAA13UploadRequestCSo11InputStreamC_AA14URLConvertible_p2toAA10HTTPMethodO6methods10DictionaryVyS2SGSg7headerstF"></a>
  1074. <a name="//apple_ref/swift/Function/upload(_:to:method:headers:)" class="dashAnchor"></a>
  1075. <a class="token" href="#/s:9Alamofire6uploadAA13UploadRequestCSo11InputStreamC_AA14URLConvertible_p2toAA10HTTPMethodO6methods10DictionaryVyS2SGSg7headerstF">upload(_:to:method:headers:)</a>
  1076. </code>
  1077. </div>
  1078. <div class="height-container">
  1079. <div class="pointer-container"></div>
  1080. <section class="section">
  1081. <div class="pointer"></div>
  1082. <div class="abstract">
  1083. <p>Creates an <code><a href="Classes/UploadRequest.html">UploadRequest</a></code> using the default <code><a href="Classes/SessionManager.html">SessionManager</a></code> from the specified <code>url</code>, <code>method</code> and <code>headers</code>
  1084. for uploading the <code>stream</code>.</p>
  1085. </div>
  1086. <div class="declaration">
  1087. <h4>Declaration</h4>
  1088. <div class="language">
  1089. <p class="aside-title">Swift</p>
  1090. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span>
  1091. <span class="n">_</span> <span class="nv">stream</span><span class="p">:</span> <span class="kt">InputStream</span><span class="p">,</span>
  1092. <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>
  1093. <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>
  1094. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="Typealiases.html#/s:9Alamofire11HTTPHeadersa">HTTPHeaders</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span>
  1095. <span class="o">-&gt;</span> <span class="kt"><a href="Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  1096. </div>
  1097. </div>
  1098. <div>
  1099. <h4>Parameters</h4>
  1100. <table class="graybox">
  1101. <tbody>
  1102. <tr>
  1103. <td>
  1104. <code>
  1105. <em>stream</em>
  1106. </code>
  1107. </td>
  1108. <td>
  1109. <div>
  1110. <p>The stream to upload.</p>
  1111. </div>
  1112. </td>
  1113. </tr>
  1114. <tr>
  1115. <td>
  1116. <code>
  1117. <em>url</em>
  1118. </code>
  1119. </td>
  1120. <td>
  1121. <div>
  1122. <p>The URL.</p>
  1123. </div>
  1124. </td>
  1125. </tr>
  1126. <tr>
  1127. <td>
  1128. <code>
  1129. <em>method</em>
  1130. </code>
  1131. </td>
  1132. <td>
  1133. <div>
  1134. <p>The HTTP method. <code>.post</code> by default.</p>
  1135. </div>
  1136. </td>
  1137. </tr>
  1138. <tr>
  1139. <td>
  1140. <code>
  1141. <em>headers</em>
  1142. </code>
  1143. </td>
  1144. <td>
  1145. <div>
  1146. <p>The HTTP headers. <code>nil</code> by default.</p>
  1147. </div>
  1148. </td>
  1149. </tr>
  1150. </tbody>
  1151. </table>
  1152. </div>
  1153. <div>
  1154. <h4>Return Value</h4>
  1155. <p>The created <code><a href="Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  1156. </div>
  1157. </section>
  1158. </div>
  1159. </li>
  1160. <li class="item">
  1161. <div>
  1162. <code>
  1163. <a name="/s:9Alamofire6uploadAA13UploadRequestCSo11InputStreamC_AA21URLRequestConvertible_p4withtF"></a>
  1164. <a name="//apple_ref/swift/Function/upload(_:with:)" class="dashAnchor"></a>
  1165. <a class="token" href="#/s:9Alamofire6uploadAA13UploadRequestCSo11InputStreamC_AA21URLRequestConvertible_p4withtF">upload(_:with:)</a>
  1166. </code>
  1167. </div>
  1168. <div class="height-container">
  1169. <div class="pointer-container"></div>
  1170. <section class="section">
  1171. <div class="pointer"></div>
  1172. <div class="abstract">
  1173. <p>Creates an <code><a href="Classes/UploadRequest.html">UploadRequest</a></code> using the default <code><a href="Classes/SessionManager.html">SessionManager</a></code> from the specified <code>urlRequest</code> for
  1174. uploading the <code>stream</code>.</p>
  1175. </div>
  1176. <div class="declaration">
  1177. <h4>Declaration</h4>
  1178. <div class="language">
  1179. <p class="aside-title">Swift</p>
  1180. <pre class="highlight"><code><span class="kd">public</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> <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> <span class="o">-&gt;</span> <span class="kt"><a href="Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  1181. </div>
  1182. </div>
  1183. <div>
  1184. <h4>Parameters</h4>
  1185. <table class="graybox">
  1186. <tbody>
  1187. <tr>
  1188. <td>
  1189. <code>
  1190. <em>urlRequest</em>
  1191. </code>
  1192. </td>
  1193. <td>
  1194. <div>
  1195. <p>The URL request.</p>
  1196. </div>
  1197. </td>
  1198. </tr>
  1199. <tr>
  1200. <td>
  1201. <code>
  1202. <em>stream</em>
  1203. </code>
  1204. </td>
  1205. <td>
  1206. <div>
  1207. <p>The stream to upload.</p>
  1208. </div>
  1209. </td>
  1210. </tr>
  1211. </tbody>
  1212. </table>
  1213. </div>
  1214. <div>
  1215. <h4>Return Value</h4>
  1216. <p>The created <code><a href="Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  1217. </div>
  1218. </section>
  1219. </div>
  1220. </li>
  1221. </ul>
  1222. </div>
  1223. <div class="task-group">
  1224. <div class="task-name-container">
  1225. <a name="/MultipartFormData"></a>
  1226. <a name="//apple_ref/swift/Section/MultipartFormData" class="dashAnchor"></a>
  1227. <a href="#/MultipartFormData">
  1228. <h3 class="section-name">MultipartFormData</h3>
  1229. </a>
  1230. </div>
  1231. <ul class="item-container">
  1232. <li class="item">
  1233. <div>
  1234. <code>
  1235. <a name="/s:9Alamofire6uploadyyAA17MultipartFormDataCc09multipartdE0_s6UInt64V14usingThresholdAA14URLConvertible_p2toAA10HTTPMethodO6methods10DictionaryVyS2SGSg7headersyAA14SessionManagerC0cdE14EncodingResultOcSg18encodingCompletiontF"></a>
  1236. <a name="//apple_ref/swift/Function/upload(multipartFormData:usingThreshold:to:method:headers:encodingCompletion:)" class="dashAnchor"></a>
  1237. <a class="token" href="#/s:9Alamofire6uploadyyAA17MultipartFormDataCc09multipartdE0_s6UInt64V14usingThresholdAA14URLConvertible_p2toAA10HTTPMethodO6methods10DictionaryVyS2SGSg7headersyAA14SessionManagerC0cdE14EncodingResultOcSg18encodingCompletiontF">upload(multipartFormData:usingThreshold:to:method:headers:encodingCompletion:)</a>
  1238. </code>
  1239. </div>
  1240. <div class="height-container">
  1241. <div class="pointer-container"></div>
  1242. <section class="section">
  1243. <div class="pointer"></div>
  1244. <div class="abstract">
  1245. <p>Encodes <code>multipartFormData</code> using <code>encodingMemoryThreshold</code> with the default <code><a href="Classes/SessionManager.html">SessionManager</a></code> and calls
  1246. <code>encodingCompletion</code> with new <code><a href="Classes/UploadRequest.html">UploadRequest</a></code> using the <code>url</code>, <code>method</code> and <code>headers</code>.</p>
  1247. <p>It is important to understand the memory implications of uploading <code><a href="Classes/MultipartFormData.html">MultipartFormData</a></code>. If the cummulative
  1248. payload is small, encoding the data in-memory and directly uploading to a server is the by far the most
  1249. efficient approach. However, if the payload is too large, encoding the data in-memory could cause your app to
  1250. be terminated. Larger payloads must first be written to disk using input and output streams to keep the memory
  1251. footprint low, then the data can be uploaded as a stream from the resulting file. Streaming from disk MUST be
  1252. used for larger payloads such as video content.</p>
  1253. <p>The <code>encodingMemoryThreshold</code> parameter allows Alamofire to automatically determine whether to encode in-memory
  1254. 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>,
  1255. encoding takes place in-memory. If the content length exceeds the threshold, the data is streamed to disk
  1256. during the encoding process. Then the result is uploaded as data or as a stream depending on which encoding
  1257. technique was used.</p>
  1258. </div>
  1259. <div class="declaration">
  1260. <h4>Declaration</h4>
  1261. <div class="language">
  1262. <p class="aside-title">Swift</p>
  1263. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span>
  1264. <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>
  1265. <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/SessionManager.html">SessionManager</a></span><span class="o">.</span><span class="n">multipartFormDataEncodingMemoryThreshold</span><span class="p">,</span>
  1266. <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>
  1267. <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>
  1268. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="Typealiases.html#/s:9Alamofire11HTTPHeadersa">HTTPHeaders</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  1269. <span class="nv">encodingCompletion</span><span class="p">:</span> <span class="p">((</span><span class="kt"><a href="Classes/SessionManager.html">SessionManager</a></span><span class="o">.</span><span class="kt">MultipartFormDataEncodingResult</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">)?)</span></code></pre>
  1270. </div>
  1271. </div>
  1272. <div>
  1273. <h4>Parameters</h4>
  1274. <table class="graybox">
  1275. <tbody>
  1276. <tr>
  1277. <td>
  1278. <code>
  1279. <em>multipartFormData</em>
  1280. </code>
  1281. </td>
  1282. <td>
  1283. <div>
  1284. <p>The closure used to append body parts to the <code>MultipartFormData</code>.</p>
  1285. </div>
  1286. </td>
  1287. </tr>
  1288. <tr>
  1289. <td>
  1290. <code>
  1291. <em>encodingMemoryThreshold</em>
  1292. </code>
  1293. </td>
  1294. <td>
  1295. <div>
  1296. <p>The encoding memory threshold in bytes.
  1297. <code>multipartFormDataEncodingMemoryThreshold</code> by default.</p>
  1298. </div>
  1299. </td>
  1300. </tr>
  1301. <tr>
  1302. <td>
  1303. <code>
  1304. <em>url</em>
  1305. </code>
  1306. </td>
  1307. <td>
  1308. <div>
  1309. <p>The URL.</p>
  1310. </div>
  1311. </td>
  1312. </tr>
  1313. <tr>
  1314. <td>
  1315. <code>
  1316. <em>method</em>
  1317. </code>
  1318. </td>
  1319. <td>
  1320. <div>
  1321. <p>The HTTP method. <code>.post</code> by default.</p>
  1322. </div>
  1323. </td>
  1324. </tr>
  1325. <tr>
  1326. <td>
  1327. <code>
  1328. <em>headers</em>
  1329. </code>
  1330. </td>
  1331. <td>
  1332. <div>
  1333. <p>The HTTP headers. <code>nil</code> by default.</p>
  1334. </div>
  1335. </td>
  1336. </tr>
  1337. <tr>
  1338. <td>
  1339. <code>
  1340. <em>encodingCompletion</em>
  1341. </code>
  1342. </td>
  1343. <td>
  1344. <div>
  1345. <p>The closure called when the <code>MultipartFormData</code> encoding is complete.</p>
  1346. </div>
  1347. </td>
  1348. </tr>
  1349. </tbody>
  1350. </table>
  1351. </div>
  1352. </section>
  1353. </div>
  1354. </li>
  1355. <li class="item">
  1356. <div>
  1357. <code>
  1358. <a name="/s:9Alamofire6uploadyyAA17MultipartFormDataCc09multipartdE0_s6UInt64V14usingThresholdAA21URLRequestConvertible_p4withyAA14SessionManagerC0cdE14EncodingResultOcSg18encodingCompletiontF"></a>
  1359. <a name="//apple_ref/swift/Function/upload(multipartFormData:usingThreshold:with:encodingCompletion:)" class="dashAnchor"></a>
  1360. <a class="token" href="#/s:9Alamofire6uploadyyAA17MultipartFormDataCc09multipartdE0_s6UInt64V14usingThresholdAA21URLRequestConvertible_p4withyAA14SessionManagerC0cdE14EncodingResultOcSg18encodingCompletiontF">upload(multipartFormData:usingThreshold:with:encodingCompletion:)</a>
  1361. </code>
  1362. </div>
  1363. <div class="height-container">
  1364. <div class="pointer-container"></div>
  1365. <section class="section">
  1366. <div class="pointer"></div>
  1367. <div class="abstract">
  1368. <p>Encodes <code>multipartFormData</code> using <code>encodingMemoryThreshold</code> and the default <code><a href="Classes/SessionManager.html">SessionManager</a></code> and
  1369. calls <code>encodingCompletion</code> with new <code><a href="Classes/UploadRequest.html">UploadRequest</a></code> using the <code>urlRequest</code>.</p>
  1370. <p>It is important to understand the memory implications of uploading <code><a href="Classes/MultipartFormData.html">MultipartFormData</a></code>. If the cummulative
  1371. payload is small, encoding the data in-memory and directly uploading to a server is the by far the most
  1372. efficient approach. However, if the payload is too large, encoding the data in-memory could cause your app to
  1373. be terminated. Larger payloads must first be written to disk using input and output streams to keep the memory
  1374. footprint low, then the data can be uploaded as a stream from the resulting file. Streaming from disk MUST be
  1375. used for larger payloads such as video content.</p>
  1376. <p>The <code>encodingMemoryThreshold</code> parameter allows Alamofire to automatically determine whether to encode in-memory
  1377. 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>,
  1378. encoding takes place in-memory. If the content length exceeds the threshold, the data is streamed to disk
  1379. during the encoding process. Then the result is uploaded as data or as a stream depending on which encoding
  1380. technique was used.</p>
  1381. </div>
  1382. <div class="declaration">
  1383. <h4>Declaration</h4>
  1384. <div class="language">
  1385. <p class="aside-title">Swift</p>
  1386. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span>
  1387. <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>
  1388. <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/SessionManager.html">SessionManager</a></span><span class="o">.</span><span class="n">multipartFormDataEncodingMemoryThreshold</span><span class="p">,</span>
  1389. <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>
  1390. <span class="nv">encodingCompletion</span><span class="p">:</span> <span class="p">((</span><span class="kt"><a href="Classes/SessionManager.html">SessionManager</a></span><span class="o">.</span><span class="kt">MultipartFormDataEncodingResult</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">)?)</span></code></pre>
  1391. </div>
  1392. </div>
  1393. <div>
  1394. <h4>Parameters</h4>
  1395. <table class="graybox">
  1396. <tbody>
  1397. <tr>
  1398. <td>
  1399. <code>
  1400. <em>multipartFormData</em>
  1401. </code>
  1402. </td>
  1403. <td>
  1404. <div>
  1405. <p>The closure used to append body parts to the <code>MultipartFormData</code>.</p>
  1406. </div>
  1407. </td>
  1408. </tr>
  1409. <tr>
  1410. <td>
  1411. <code>
  1412. <em>encodingMemoryThreshold</em>
  1413. </code>
  1414. </td>
  1415. <td>
  1416. <div>
  1417. <p>The encoding memory threshold in bytes.
  1418. <code>multipartFormDataEncodingMemoryThreshold</code> by default.</p>
  1419. </div>
  1420. </td>
  1421. </tr>
  1422. <tr>
  1423. <td>
  1424. <code>
  1425. <em>urlRequest</em>
  1426. </code>
  1427. </td>
  1428. <td>
  1429. <div>
  1430. <p>The URL request.</p>
  1431. </div>
  1432. </td>
  1433. </tr>
  1434. <tr>
  1435. <td>
  1436. <code>
  1437. <em>encodingCompletion</em>
  1438. </code>
  1439. </td>
  1440. <td>
  1441. <div>
  1442. <p>The closure called when the <code>MultipartFormData</code> encoding is complete.</p>
  1443. </div>
  1444. </td>
  1445. </tr>
  1446. </tbody>
  1447. </table>
  1448. </div>
  1449. </section>
  1450. </div>
  1451. </li>
  1452. </ul>
  1453. </div>
  1454. <div class="task-group">
  1455. <div class="task-name-container">
  1456. <a name="/Hostname%20and%20Port"></a>
  1457. <a name="//apple_ref/swift/Section/Hostname and Port" class="dashAnchor"></a>
  1458. <a href="#/Hostname%20and%20Port">
  1459. <h3 class="section-name">Hostname and Port</h3>
  1460. </a>
  1461. </div>
  1462. <ul class="item-container">
  1463. <li class="item">
  1464. <div>
  1465. <code>
  1466. <a name="/s:9Alamofire6streamAA13StreamRequestCSS12withHostName_Si4porttF"></a>
  1467. <a name="//apple_ref/swift/Function/stream(withHostName:port:)" class="dashAnchor"></a>
  1468. <a class="token" href="#/s:9Alamofire6streamAA13StreamRequestCSS12withHostName_Si4porttF">stream(withHostName:port:)</a>
  1469. </code>
  1470. </div>
  1471. <div class="height-container">
  1472. <div class="pointer-container"></div>
  1473. <section class="section">
  1474. <div class="pointer"></div>
  1475. <div class="abstract">
  1476. <p>Creates a <code><a href="Classes.html#/s:9Alamofire13StreamRequestC">StreamRequest</a></code> using the default <code><a href="Classes/SessionManager.html">SessionManager</a></code> for bidirectional streaming with the <code>hostname</code>
  1477. and <code>port</code>.</p>
  1478. <p>If <code>startRequestsImmediately</code> is <code>true</code>, the request will have <code>resume()</code> called before being returned.</p>
  1479. </div>
  1480. <div class="declaration">
  1481. <h4>Declaration</h4>
  1482. <div class="language">
  1483. <p class="aside-title">Swift</p>
  1484. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">stream</span><span class="p">(</span><span class="n">withHostName</span> <span class="nv">hostName</span><span class="p">:</span> <span class="kt">String</span><span class="p">,</span> <span class="nv">port</span><span class="p">:</span> <span class="kt">Int</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="Classes.html#/s:9Alamofire13StreamRequestC">StreamRequest</a></span></code></pre>
  1485. </div>
  1486. </div>
  1487. <div>
  1488. <h4>Parameters</h4>
  1489. <table class="graybox">
  1490. <tbody>
  1491. <tr>
  1492. <td>
  1493. <code>
  1494. <em>hostName</em>
  1495. </code>
  1496. </td>
  1497. <td>
  1498. <div>
  1499. <p>The hostname of the server to connect to.</p>
  1500. </div>
  1501. </td>
  1502. </tr>
  1503. <tr>
  1504. <td>
  1505. <code>
  1506. <em>port</em>
  1507. </code>
  1508. </td>
  1509. <td>
  1510. <div>
  1511. <p>The port of the server to connect to.</p>
  1512. </div>
  1513. </td>
  1514. </tr>
  1515. </tbody>
  1516. </table>
  1517. </div>
  1518. <div>
  1519. <h4>Return Value</h4>
  1520. <p>The created <code><a href="Classes.html#/s:9Alamofire13StreamRequestC">StreamRequest</a></code>.</p>
  1521. </div>
  1522. </section>
  1523. </div>
  1524. </li>
  1525. </ul>
  1526. </div>
  1527. <div class="task-group">
  1528. <div class="task-name-container">
  1529. <a name="/NetService"></a>
  1530. <a name="//apple_ref/swift/Section/NetService" class="dashAnchor"></a>
  1531. <a href="#/NetService">
  1532. <h3 class="section-name">NetService</h3>
  1533. </a>
  1534. </div>
  1535. <ul class="item-container">
  1536. <li class="item">
  1537. <div>
  1538. <code>
  1539. <a name="/s:9Alamofire6streamAA13StreamRequestCSo10NetServiceC4with_tF"></a>
  1540. <a name="//apple_ref/swift/Function/stream(with:)" class="dashAnchor"></a>
  1541. <a class="token" href="#/s:9Alamofire6streamAA13StreamRequestCSo10NetServiceC4with_tF">stream(with:)</a>
  1542. </code>
  1543. </div>
  1544. <div class="height-container">
  1545. <div class="pointer-container"></div>
  1546. <section class="section">
  1547. <div class="pointer"></div>
  1548. <div class="abstract">
  1549. <p>Creates a <code><a href="Classes.html#/s:9Alamofire13StreamRequestC">StreamRequest</a></code> using the default <code><a href="Classes/SessionManager.html">SessionManager</a></code> for bidirectional streaming with the <code>netService</code>.</p>
  1550. <p>If <code>startRequestsImmediately</code> is <code>true</code>, the request will have <code>resume()</code> called before being returned.</p>
  1551. </div>
  1552. <div class="declaration">
  1553. <h4>Declaration</h4>
  1554. <div class="language">
  1555. <p class="aside-title">Swift</p>
  1556. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">stream</span><span class="p">(</span><span class="n">with</span> <span class="nv">netService</span><span class="p">:</span> <span class="kt">NetService</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="Classes.html#/s:9Alamofire13StreamRequestC">StreamRequest</a></span></code></pre>
  1557. </div>
  1558. </div>
  1559. <div>
  1560. <h4>Parameters</h4>
  1561. <table class="graybox">
  1562. <tbody>
  1563. <tr>
  1564. <td>
  1565. <code>
  1566. <em>netService</em>
  1567. </code>
  1568. </td>
  1569. <td>
  1570. <div>
  1571. <p>The net service used to identify the endpoint.</p>
  1572. </div>
  1573. </td>
  1574. </tr>
  1575. </tbody>
  1576. </table>
  1577. </div>
  1578. <div>
  1579. <h4>Return Value</h4>
  1580. <p>The created <code><a href="Classes.html#/s:9Alamofire13StreamRequestC">StreamRequest</a></code>.</p>
  1581. </div>
  1582. </section>
  1583. </div>
  1584. </li>
  1585. </ul>
  1586. </div>
  1587. <div class="task-group">
  1588. <ul class="item-container">
  1589. <li class="item">
  1590. <div>
  1591. <code>
  1592. <a name="/s:9Alamofire2eeoiSbAA26NetworkReachabilityManagerC0cD6StatusO_AFtF"></a>
  1593. <a name="//apple_ref/swift/Function/==(_:_:)" class="dashAnchor"></a>
  1594. <a class="token" href="#/s:9Alamofire2eeoiSbAA26NetworkReachabilityManagerC0cD6StatusO_AFtF">==(_:_:)</a>
  1595. </code>
  1596. </div>
  1597. <div class="height-container">
  1598. <div class="pointer-container"></div>
  1599. <section class="section">
  1600. <div class="pointer"></div>
  1601. <div class="abstract">
  1602. <p>Returns whether the two network reachability status values are equal.</p>
  1603. </div>
  1604. <div class="declaration">
  1605. <h4>Declaration</h4>
  1606. <div class="language">
  1607. <p class="aside-title">Swift</p>
  1608. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="o">==</span><span class="p">(</span>
  1609. <span class="nv">lhs</span><span class="p">:</span> <span class="kt"><a href="Classes/NetworkReachabilityManager.html">NetworkReachabilityManager</a></span><span class="o">.</span><span class="kt">NetworkReachabilityStatus</span><span class="p">,</span>
  1610. <span class="nv">rhs</span><span class="p">:</span> <span class="kt"><a href="Classes/NetworkReachabilityManager.html">NetworkReachabilityManager</a></span><span class="o">.</span><span class="kt">NetworkReachabilityStatus</span><span class="p">)</span>
  1611. <span class="o">-&gt;</span> <span class="kt">Bool</span></code></pre>
  1612. </div>
  1613. </div>
  1614. <div>
  1615. <h4>Parameters</h4>
  1616. <table class="graybox">
  1617. <tbody>
  1618. <tr>
  1619. <td>
  1620. <code>
  1621. <em>lhs</em>
  1622. </code>
  1623. </td>
  1624. <td>
  1625. <div>
  1626. <p>The left-hand side value to compare.</p>
  1627. </div>
  1628. </td>
  1629. </tr>
  1630. <tr>
  1631. <td>
  1632. <code>
  1633. <em>rhs</em>
  1634. </code>
  1635. </td>
  1636. <td>
  1637. <div>
  1638. <p>The right-hand side value to compare.</p>
  1639. </div>
  1640. </td>
  1641. </tr>
  1642. </tbody>
  1643. </table>
  1644. </div>
  1645. <div>
  1646. <h4>Return Value</h4>
  1647. <p><code>true</code> if the two values are equal, <code>false</code> otherwise.</p>
  1648. </div>
  1649. </section>
  1650. </div>
  1651. </li>
  1652. </ul>
  1653. </div>
  1654. </div>
  1655. </section>
  1656. </article>
  1657. </div>
  1658. <section class="footer">
  1659. <p>&copy; 2017 <a class="link" href="http://alamofire.org/" target="_blank" rel="external">Alamofire Software Foundation</a>. All rights reserved. (Last updated: 2017-08-21)</p>
  1660. <p>Generated by <a class="link" href="https://github.com/realm/jazzy" target="_blank" rel="external">jazzy ♪♫ v0.8.3</a>, a <a class="link" href="http://realm.io" target="_blank" rel="external">Realm</a> project.</p>
  1661. </section>
  1662. </body>
  1663. </div>
  1664. </html>