我的问题是关于命名,设计和实现的选择.我可以看到自己走向两个不同的方向,如何解决问题,我很想知道其他可能遇到类似问题的人会处理这个问题.它是部分美学,部分功能.
关于代码的一点背景......我创建了一个名为的类型ISlice<T>,它提供了对项目源的一部分的引用,这些项目可以是一个集合(例如数组,列表)或字符串.核心支持来自一些实现类,这些类支持快速索引,使用切片的Begin和End标记从原始源获取项目.目的是提供类似于Go语言提供的切片功能,同时使用Python样式索引(即支持正负索引).
为了使创建切片(实例ISlice<T>)更容易和更"流畅",我创建了一组扩展方法.例如:
static public ISlice<T> Slice<T>(this IList<T> source, int begin, int end)
{
return new ListSlice<T>(source, begin, end);
}
static public ISlice<char> Slice(this string source, int begin, int end)
{
return new StringSlice(source, begin, end);
}
还有其他一些,例如提供可选的开始/结束参数,但上面的内容足以满足我的需求.
这些例程运行良好,可以轻松切片集合或字符串.我还需要的是获取切片并将其创建为数组,列表或字符串的方法.这就是事情变得"有趣"的地方.最初,我认为我需要创建ToArray,ToList扩展方法,但后来记得LINQ变体在集合实现时执行优化ICollection<T>.在我的情况下,ISlice<T>它确实继承了它,虽然很多我的懊恼,因为我不喜欢从像Add这样的方法抛出NotSupportedExceptions.无论如何,我免费获得这些.大.
如果没有内置支持将一个IEnumerable<char>轻松转换回字符串,那么转换回一个字符串呢？我发现最接近的是string.Concat重载之一,但它不能尽可能高效地处理字符.从设计角度来看同样重要的是,它不会像"转换"例程一样跳出来.
第一个想法是创建一个ToString扩展方法,但这不起作用,因为ToString是一个实例方法,这意味着它胜过扩展方法,永远不会被调用.我可以覆盖ToString,但行为将是不一致的,因为ListSlice<T>特殊情况需要它的ToString,其中T是一个char.我不喜欢这样,因为当type参数是char时ToString会给出一些有用的东西,但在其他情况下是类名.此外,如果将来创建其他切片类型,我必须创建一个公共基类以确保相同的行为,或者每个类必须实现相同的检查.接口上的扩展方法可以更优雅地处理.
扩展方法引出了一个命名约定问题.显而易见的是使用ToString,但如前所述,它是不允许的.我可以把它命名为不同的东西,但是什么？ToNewString？NewString？CreateString？To-family方法中的某些东西会让它落入ToArray/ToList例程,但是当在intellisense和代码编辑器中看到时,ToNewString突然变成'奇数'.NewString/CreateString不像你必须知道的那样可以发现它们.它不符合To-family方法提供的"转换方法"模式.
去覆盖ToString并接受硬编码到ListSlice<T>实现和其他实现中的不一致行为？使用更灵活,但可能更糟糕的扩展方法路由？我还没有考虑过第三种选择吗？
我的直觉告诉我尽管保留了我的ToString但是,它也发生在我身上......你会不会考虑ToString给你一个集合/可枚举类型的有用输出？这会违反最少惊喜的原则吗？
更新
切片操作的大多数实现提供了来自用于切片的任何源的数据的副本,尽管是子集.这在大多数用例中都是完全可以接受的,因为您只需返回相同的数据类型即可获得干净的API.如果对列表进行切片,则返回一个列表,其中仅包含切片中指定范围内的项目.如果切片字符串,则返回一个字符串.等等.
我在上面描述的切片操作在处理使这种行为不合需要的约束时解决了一个问题.例如,如果使用大型数据集,则切片操作将导致不必要的额外内存分配,更不用说复制数据对性能的影响.如果在获得最终结果之前切片将对其进行进一步处理,则尤其如此.因此,切片实现的目标是引用更大的数据集,以避免对信息进行不必要的复制,直到它变得有益.
问题在于,在处理结束时,希望将基于切片的处理数据转换回更多API和.NET友好类型,如列表,数组和字符串.它使数据更容易传递到其他API.它还允许您丢弃切片,因此也可以丢弃切片引用的大数据集.
我正在使用 Sprache 构建一个简单的命令式语法。我试图找出是否有办法在缺少结束字符（例如]、）、} 时获得更好的错误报告。
如果缺少结束字符，我的语法会正确报告错误。然而，消息传递导致难以理解真正的问题。给定以下要解析的字符串：
sum 10 [multiply 5 4
sprache 报如下错误：
Sprache.ParseException : Parsing failure: unexpected '['; expected newline or end of input (Line 1, Column 8); recently consumed: sum 10
似乎正在发生的事情是解析器试图匹配 myCommandSubstitution并且未能找到结束的']'. 这会导致解析器回退并尝试替代。由于它无法再匹配Things命令，它会尝试匹配CommandTerminator. 因为它不能匹配 a'['它报告错误抱怨预期newline或end of input而不是说，“嘿，伙计，你没有匹配你的括号！”
是否有任何解决方法或建议可以说明如何使用像 Sprache 这样的解析库改进语法以更好地报告？
public static readonly Parser<Word> Word = Parse.Char(IsWordChar, "word character").AtLeastOnce().Text()
.Select(str => new Word(str));
public static readonly Parser<CommandSubstitution> CommandSubstitution = from open in Parse.Char('[').Once()
from …