关于NSTextParagraph的paragraphSeparatorRange和paragraphContentRange计算方式的问询

我想了解NSTextParagraph类的paragraphSeparatorRange和paragraphContentRange这两个属性的计算与设置逻辑，以下是观察到的现象及相关思路分析：

直接实例化的现象 #

单独创建NSTextParagraph实例时，这两个属性均未被设置（输出为nil），示例代码如下：

var paragraph = NSTextParagraph(attributedString: NSAttributedString(string: "It was the best of times.\n"))
print("attributes: \(paragraph.attributedString.attributes(at: 0, effectiveRange: nil))")
print("paragraphSeparatorRange: \(String(describing: paragraph.paragraphSeparatorRange))")
print("paragraphContentRange: \(String(describing: paragraph.paragraphContentRange))")

结合文本布局系统的现象 #

当NSTextParagraph被纳入NSTextContentStorage与NSTextLayoutManager的文本系统中时，这两个属性会被正确赋值，示例代码如下：

let layoutManager = NSTextLayoutManager()
let container = NSTextContainer(size: NSSize(width: 400, height: 400))
layoutManager.textContainer = container
let contentStorage = NSTextContentStorage()
contentStorage.textStorage = NSTextStorage(string: "It was the best of times.\n")
contentStorage.addTextLayoutManager(layoutManager)
layoutManager.enumerateTextLayoutFragments(from: contentStorage.documentRange.location, options: .ensuresLayout) { textLayoutFragment in
    print("layoutFragment: \(textLayoutFragment)")
    print("textElement: \(String(describing: textLayoutFragment.textElement))")
    print("textElement.range: \(String(describing: textLayoutFragment.textElement?.elementRange))")
    let paragraph = textLayoutFragment.textElement as! NSTextParagraph
    print("paragraphContentRange: \(String(describing: paragraph.paragraphContentRange))")
    print("paragraphSeparatorRange: \(String(describing: paragraph.paragraphSeparatorRange))")

    return true
}

属性的计算与设置思路 #

核心前提：依赖全局文本上下文 #

paragraphSeparatorRange和paragraphContentRange的取值都是基于整个文本存储（NSTextStorage）的全局范围来确定的。单独实例化NSTextParagraph时，该对象未关联到全局文本上下文，系统无法定位段落内容和分隔符在全局文本中的位置，因此这两个属性保持未设置状态。

系统自动处理流程 #

当NSTextParagraph被NSTextContentStorage管理时，文本系统会自动完成以下步骤来赋值这两个属性：

1. 文本分段拆分：NSTextContentStorage会依据Unicode段落分隔符（如\n、\r\n等）或文本属性指定的规则，将全局NSTextStorage拆分为多个NSTextParagraph实例。
2. 范围计算赋值：
   • paragraphContentRange：对应段落实际内容在全局文本中的范围，即从段落起始位置到分隔符前的最后一个字符的区间。
   • paragraphSeparatorRange：对应段落结尾的分隔符字符在全局文本中的区间。
3. 布局触发确认：当调用NSTextLayoutManager的布局相关方法（如示例中带.ensuresLayout选项的enumerateTextLayoutFragments）时，系统会确保完成文本元素的解析和属性赋值，为后续排版提供准确的范围信息。

关键注意点 #

这两个属性均为只读属性，开发者无法手动设置，只能由文本布局系统在全局上下文环境中自动计算赋值。

内容的提问来源于stack exchange，提问作者georgemp