Struct curl::easy::Part
pub struct Part<'form, 'data> { /* fields hidden */ }Documentation
One part in a multipart upload, added to a Form.
Implementations
impl<'form, 'data> Part<'form, 'data>
pub fn contents(&mut Self, contents: &'data [u8]) -> &mut Self
A pointer to the contents of this part, the actual data to send away.
pub fn file_content<P>(&mut Self, file: P) -> &mut Self
where
P: AsRef<Path>
where
P: AsRef<Path>
Causes this file to be read and its contents used as data in this part
This part does not automatically become a file upload part simply because its data was read from a file.
Errors
If the filename has any internal nul bytes or if on Windows it does not
contain a unicode filename then the add function will eventually
return an error.
pub fn file<P: ?Sized>(&mut Self, file: &'data P) -> &mut Self
where
P: AsRef<Path>
where
P: AsRef<Path>
Makes this part a file upload part of the given file.
Sets the filename field to the basename of the provided file name, and it reads the contents of the file and passes them as data and sets the content type if the given file matches one of the internally known file extensions.
The given upload file must exist entirely on the filesystem before the upload is started because libcurl needs to read the size of it beforehand.
Multiple files can be uploaded by calling this method multiple times and content types can also be configured for each file (by calling that next).
Errors
If the filename has any internal nul bytes or if on Windows it does not
contain a unicode filename then this function will cause add to return
an error when called.
pub fn content_type(&mut Self, content_type: &'data str) -> &mut Self
pub fn buffer<P: ?Sized>(
&mut Self,
name: &'data P,
data: Vec<u8>
) -> &mut Self
where
P: AsRef<Path>
&mut Self,
name: &'data P,
data: Vec<u8>
) -> &mut Self
where
P: AsRef<Path>
This is used to provide a custom file upload part without using the
file method above.
The first parameter is for the filename field and the second is the in-memory contents.
Errors
If name contains an internal nul byte, or if on Windows the path is
not valid unicode then this function will return an error when add is
called.
pub fn content_header(&mut Self, headers: List) -> &mut Self
Specifies extra headers for the form POST section.
Appends the list of headers to those libcurl automatically generates.
Trait Implementations
impl<'form, 'data> Debug for Part<'form, 'data>
fn fmt(&Self, f: &mut fmt::Formatter<'_>) -> fmt::ResultAuto Trait Implementations
impl<'form, 'data> !UnwindSafe for Part<'form, 'data>impl<'form, 'data> RefUnwindSafe for Part<'form, 'data>Blanket Implementations
impl<T> BorrowMut<T> for T
where
T: ?Sized,
where
T: ?Sized,
fn borrow_mut(&mut Self) -> &mut T