range (property)
The range of bytes to request.
Syntax
@property (nonatomic,readwrite,assign,getter=range,setter=setRange:) NSString* range; - (NSString*)range; - (void)setRange:(NSString*)newRange;
public var range: String { get {...}
set {...} }
Default Value
""
Remarks
This property specifies the range of bytes to request from the server. If this property is non-empty when a GetObject request is being constructed, a header like Range: bytes=Range will be added to the request, with Range substituted with the specified value.
There are two valid formats for this property's value:
- StartByte-
- StartByte-EndByte
Note: If the StartByte property is greater than zero when GetObject is called (i.e., when a download is being resumed), and this property is non-empty, the class will automatically advance the StartByte value in the specified range by StartByte bytes when sending the Range header to the server. This ensures that the previously-downloaded data at the start of the specified range is not downloaded again when the download is resumed.