1	#Region "Microsoft.VisualBasic::f4244d7a0f569380f8807f3c10c1d96d, Microsoft.VisualBasic.Core\Extensions\Trinity\Expression.vb"
2
3	' Author:
4	'
5	'       asuka (amethyst.asuka@gcmodeller.org)
6	'       xie (genetics@smrucc.org)
7	'       xieguigang (xie.guigang@live.com)
8	'
9	' Copyright (c) 2018 GPL3 Licensed
10	'
11	'
12	' GNU GENERAL PUBLIC LICENSE (GPL3)
13	'
14	'
15	' This program is free software: you can redistribute it and/or modify
16	' it under the terms of the GNU General Public License as published by
17	' the Free Software Foundation, either version 3 of the License, or
18	' (at your option) any later version.
19	'
20	' This program is distributed in the hope that it will be useful,
21	' but WITHOUT ANY WARRANTY; without even the implied warranty of
22	' MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
23	' GNU General Public License for more details.
24	'
25	' You should have received a copy of the GNU General Public License
26	' along with this program. If not, see <http://www.gnu.org/licenses/>.
27
28
29
30	' /********************************************************************************/
31
32	' Summaries:
33
34	'     Module Expression
35	'
36	'         Function: Concatenate
37	'
38	'
39	' /********************************************************************************/
40
41	#End Region
42
43	Imports System.Runtime.CompilerServices
44	Imports Microsoft.VisualBasic.Language
45
46	Namespace Data.Trinity
47
48	''' <summary>
49	''' Natural expression builder for AI output
50	''' </summary>
51	Public Module Expression
52
53	<Extension>
54	Public Function Concatenate(list As IEnumerable(Of String), Optional comma$ = ",", Optional andalso$ = "and", Optional etc$ = "etc", Optional joinSpace As Boolean = True) As String
55	Dim space$ = If(joinSpace, " ", "")
56
57	With list.ToArray
58	If .Length = 1 Then
59	Return .ByRef(0)
60	ElseIf .Length < 8 Then
61	Return .Take(.Length - 1).JoinBy(comma & space) & $"{space}{[andalso]}{space}" & .Last
62	Else
63	Return .Take(7).JoinBy(comma & space) & $"{space}{[andalso]}{space}" & .ByRef(7) & $"{comma}{space}{etc}"
64	End If
65	End With
66	End Function
67	End Module
68	End Namespace