Skip to content

class RangeHeaderValue

cangjie
public class RangeHeaderValue <: Equatable<RangeHeaderValue>

功能:表示 HTTP Range 请求标头值(RFC 7233)

格式:&lt;unit&gt;=&lt;from1&gt;-&lt;to1&gt;\[, &lt;from2&gt;-&lt;to2&gt;...\] 示例:bytes=0-499bytes=500-999, 1500-

父类型:

成员概览

成员功能
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 标头值是否相等。

参数:

返回值:

  • 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 标头字符串。

返回值:

func tryParse(String)

cangjie
public static func tryParse(input: String): ?RangeHeaderValue

功能:尝试解析 Range 标头字符串,返回 None 表示格式无效

参数:

  • input: String - 待解析的 Range 标头字符串。

返回值:

  • ?RangeHeaderValue - 解析成功时返回 Range 标头值;失败时返回 None