class RangeHeaderValue
cangjie
public class RangeHeaderValue <: Equatable<RangeHeaderValue>功能:表示 HTTP Range 请求标头值(RFC 7233)
格式:<unit>=<from1>-<to1>\[, <from2>-<to2>...\] 示例:bytes=0-499、bytes=500-999, 1500-
父类型:
- Equatable<RangeHeaderValue>
成员概览
| 成员 | 功能 |
|---|---|
| init() | 构造默认 Range 标头(unit = "bytes",无范围项,需手动添加) |
| init(?Int64, ?Int64) | 构造包含单个范围的 Range 标头(unit = "bytes") |
| prop unit | 范围单位(默认 "bytes") |
| prop ranges | 范围项列表(懒初始化) |
| func toString() | 序列化为字符串,如 "bytes=0-499" 或 "bytes=0-499, 1000-1499" |
| func ==(RangeHeaderValue) | 比较两个 Range 标头值是否相等。 |
| func hashCode() | 返回当前 Range 标头值的哈希值。 |
| func parse(String) | 解析 Range 标头字符串,格式非法时抛出异常 |
| func tryParse(String) | 尝试解析 Range 标头字符串,返回 None 表示格式无效 |
init()
cangjie
public init()功能:构造默认 Range 标头(unit = "bytes",无范围项,需手动添加)
init(?Int64, ?Int64)
cangjie
public init(from: ?Int64, to: ?Int64)功能:构造包含单个范围的 Range 标头(unit = "bytes")
参数:
- from:
?Int64- 范围起始位置。 - to:
?Int64- 范围结束位置。
prop unit
cangjie
public mut prop unit: String功能:范围单位(默认 "bytes")
类型:String
prop ranges
cangjie
public prop ranges: ArrayList<RangeItemHeaderValue>功能:范围项列表(懒初始化)
类型:ArrayList<RangeItemHeaderValue>
func toString()
cangjie
public func toString(): String功能:序列化为字符串,如 "bytes=0-499" 或 "bytes=0-499, 1000-1499"
返回值:
String- 当前 Range 标头的字符串表示。
func ==(RangeHeaderValue)
cangjie
public operator func ==(other: RangeHeaderValue): Bool功能:比较两个 Range 标头值是否相等。
参数:
- other: RangeHeaderValue - 要比较的 Range 标头值。
返回值:
Bool- 如果两个 Range 标头值相等则返回 true,否则返回 false。
func hashCode()
cangjie
public func hashCode(): Int64功能:返回当前 Range 标头值的哈希值。
返回值:
Int64- 当前 Range 标头值的哈希值。
func parse(String)
cangjie
public static func parse(input: String): RangeHeaderValue功能:解析 Range 标头字符串,格式非法时抛出异常
参数:
- input:
String- 待解析的 Range 标头字符串。
返回值:
- RangeHeaderValue - 解析得到的 Range 标头值。
func tryParse(String)
cangjie
public static func tryParse(input: String): ?RangeHeaderValue功能:尝试解析 Range 标头字符串,返回 None 表示格式无效
参数:
- input:
String- 待解析的 Range 标头字符串。
返回值:
- ?RangeHeaderValue - 解析成功时返回 Range 标头值;失败时返回
None。