背景知识介绍
- 什么是自定义字符串内插处理程序?
- 简单来讲就是自定义一个高性能的字符串拼接程序 通过
$"{a}{b}"
的方式.
- 简单来讲就是自定义一个高性能的字符串拼接程序 通过
- 什么是CallerArgumentExpression?
- 获得传进来的参数表达式的文本形式. F(string s, [CallerArgumentExpression("s")] sExpression); F(Datetime.Now.ToString()); //sExpression is "Datetime.Now.ToString()"
臆想的一个场景: 拼接字符串, 要求自动包含字符串变量的名字和值, 并用":,"分割.
PS:仅仅是为了探索这2个特性的用法, 编码规范和实用性不在考虑范围内
- input: 有参数 [a,b,c]
- output "a:{a}, b:{b}, c:{c}";
{}
中表示该参数的值.
利用字符串内插的方式实现这个场景
定义一个F方法并通过字符串内插传入需要拼接的参数, 如F($"{a}{b}{c}")
实现自定义的字符串内插处理程序
[InterpolatedStringHandler]
public ref struct MyInterpolatedStringHandler
{
DefaultInterpolatedStringHandler _default;
bool firstAppend = false;
public MyInterpolatedStringHandler(int literalLength, int formattedCount)
{
_default = new DefaultInterpolatedStringHandler(literalLength + (formattedCount * 16), formattedCount);
// 在DefaultInterpolatedStringHandler 内部初始化char buffer 大小用的计算方法是: literalLength + formattedCount*11
// 所以我们假定我们的单个参数表达式的长度是13, 然后在加固定的3个字符" , :" 一共16个字符. 所以有了(formattedCount * 16)
// 当然, 我们可以在这里吧要写入的对象传入进来(利用InterpolatedStringHandlerArgument特性), 比如说官方例子里面的Logger对象.
// 参考 https://docs.microsoft.com/zh-cn/dotnet/csharp/whats-new/tutorials/interpolated-string-handler#add-more-capabilities-to-the-handler
}
public void AppendLiteral(string s)
{
_default.AppendLiteral(s); // AppendLiteral处理内插字符串中的字面量, 意思就是 `$"aa:{a}"` 中的 `aa:`是字面量
}
public void AppendFormatted<T>(T t, [CallerArgumentExpression("t")] string? tName = null)
{
// 按照我们想要的格式拼接字符串.
if (!append) _default.AppendLiteral(", ");
firstAppend = true;
_default.AppendLiteral(tName);
_default.AppendLiteral(":");
_default.AppendFormatted(t);
}
public string ToStringAndClear()
{
var s = _default.ToStringAndClear();
this = default;
return s;
}
}
实现F方法
void F(MyInterpolatedStringHandler s)=> Console.WriteLine(s.ToStringAndClear());
调用例子
int a=0;
int b=1;
string c=2;
F($"{a}{b}{c}") //output "a:0, b:1, c:2"
如果我们反编译这些代码,会看到和下面代码差不多:
public void Main()
{
int a=0;
int b=1;
string c=2;
MyInterpolatedStringHandler result = new MyInterpolatedStringHandler(0, 3);
result.AppendFormatted(a, "a");
result.AppendFormatted(b, "b");
result.AppendFormatted(c, "c");
F(result);
}
总结
- 这2个特性的更多介绍可以参考上面背景知识中给出的连接. 官方介绍很详细
- 什么场景下适合自定义一个字符串内插程序(string interpolation handler) 可以阅读 新大纲