/
db_eval.go
767 lines (724 loc) · 18.8 KB
/
db_eval.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
/*
Copyright 2019 Google LLC
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
package spannertest
// This file contains the part of the Spanner fake that evaluates expressions.
import (
"bytes"
"fmt"
"regexp"
"strconv"
"strings"
"time"
"cloud.google.com/go/civil"
"cloud.google.com/go/spanner/spansql"
)
// evalContext represents the context for evaluating an expression.
type evalContext struct {
// cols and row are set during expr evaluation.
cols []colInfo
row row
// If there are visible aliases, they are populated here.
aliases map[spansql.ID]spansql.Expr
params queryParams
}
// coercedValue represents a literal value that has been coerced to a different type.
// This never leaves this package, nor is persisted.
type coercedValue struct {
spansql.Expr // not a real Expr
val interface{} // internal representation
// TODO: type?
orig spansql.Expr
}
func (cv coercedValue) SQL() string { return cv.orig.SQL() }
func (ec evalContext) evalExprList(list []spansql.Expr) ([]interface{}, error) {
var out []interface{}
for _, e := range list {
x, err := ec.evalExpr(e)
if err != nil {
return nil, err
}
out = append(out, x)
}
return out, nil
}
func (ec evalContext) evalBoolExpr(be spansql.BoolExpr) (bool, error) {
switch be := be.(type) {
default:
return false, fmt.Errorf("unhandled BoolExpr %T", be)
case spansql.BoolLiteral:
return bool(be), nil
case spansql.ID, spansql.Paren, spansql.InOp: // InOp is a bit weird.
e, err := ec.evalExpr(be)
if err != nil {
return false, err
}
if e == nil { // NULL is a false boolean.
return false, nil
}
b, ok := e.(bool)
if !ok {
return false, fmt.Errorf("got %T, want bool", e)
}
return b, nil
case spansql.LogicalOp:
var lhs, rhs bool
var err error
if be.LHS != nil {
lhs, err = ec.evalBoolExpr(be.LHS)
if err != nil {
return false, err
}
}
rhs, err = ec.evalBoolExpr(be.RHS)
if err != nil {
return false, err
}
switch be.Op {
case spansql.And:
return lhs && rhs, nil
case spansql.Or:
return lhs || rhs, nil
case spansql.Not:
return !rhs, nil
default:
return false, fmt.Errorf("unhandled LogicalOp %d", be.Op)
}
case spansql.ComparisonOp:
// Per https://cloud.google.com/spanner/docs/operators#comparison_operators,
// "Cloud Spanner SQL will generally coerce literals to the type of non-literals, where present".
// Before evaluating be.LHS and be.RHS, do any necessary coercion.
be, err := ec.coerceComparisonOpArgs(be)
if err != nil {
return false, err
}
var lhs, rhs interface{}
lhs, err = ec.evalExpr(be.LHS)
if err != nil {
return false, err
}
rhs, err = ec.evalExpr(be.RHS)
if err != nil {
return false, err
}
switch be.Op {
default:
return false, fmt.Errorf("TODO: ComparisonOp %d", be.Op)
case spansql.Lt:
return compareVals(lhs, rhs) < 0, nil
case spansql.Le:
return compareVals(lhs, rhs) <= 0, nil
case spansql.Gt:
return compareVals(lhs, rhs) > 0, nil
case spansql.Ge:
return compareVals(lhs, rhs) >= 0, nil
case spansql.Eq:
return compareVals(lhs, rhs) == 0, nil
case spansql.Ne:
return compareVals(lhs, rhs) != 0, nil
case spansql.Like, spansql.NotLike:
left, ok := lhs.(string)
if !ok {
// TODO: byte works here too?
return false, fmt.Errorf("LHS of LIKE is %T, not string", lhs)
}
right, ok := rhs.(string)
if !ok {
// TODO: byte works here too?
return false, fmt.Errorf("RHS of LIKE is %T, not string", rhs)
}
match := evalLike(left, right)
if be.Op == spansql.NotLike {
match = !match
}
return match, nil
case spansql.Between, spansql.NotBetween:
rhs2, err := ec.evalExpr(be.RHS2)
if err != nil {
return false, err
}
b := compareVals(rhs, lhs) <= 0 && compareVals(lhs, rhs2) <= 0
if be.Op == spansql.NotBetween {
b = !b
}
return b, nil
}
case spansql.IsOp:
lhs, err := ec.evalExpr(be.LHS)
if err != nil {
return false, err
}
var b bool
switch rhs := be.RHS.(type) {
default:
return false, fmt.Errorf("unhandled IsOp %T", rhs)
case spansql.BoolLiteral:
if lhs == nil {
// For `X IS TRUE`, X being NULL is okay, and this evaluates
// to false. Same goes for `X IS FALSE`.
lhs = !bool(rhs)
}
lhsBool, ok := lhs.(bool)
if !ok {
return false, fmt.Errorf("non-bool value %T on LHS for %s", lhs, be.SQL())
}
b = (lhsBool == bool(rhs))
case spansql.NullLiteral:
b = (lhs == nil)
}
if be.Neg {
b = !b
}
return b, nil
}
}
func (ec evalContext) evalArithOp(e spansql.ArithOp) (interface{}, error) {
switch e.Op {
case spansql.Neg:
rhs, err := ec.evalExpr(e.RHS)
if err != nil {
return nil, err
}
switch rhs := rhs.(type) {
case float64:
return -rhs, nil
case int64:
return -rhs, nil
}
return nil, fmt.Errorf("RHS of %s evaluates to %T, want FLOAT64 or INT64", e.SQL(), rhs)
case spansql.BitNot:
rhs, err := ec.evalExpr(e.RHS)
if err != nil {
return nil, err
}
switch rhs := rhs.(type) {
case int64:
return ^rhs, nil
case []byte:
b := append([]byte(nil), rhs...) // deep copy
for i := range b {
b[i] = ^b[i]
}
return b, nil
}
return nil, fmt.Errorf("RHS of %s evaluates to %T, want INT64 or BYTES", e.SQL(), rhs)
case spansql.Div:
lhs, err := ec.evalFloat64(e.LHS)
if err != nil {
return nil, err
}
rhs, err := ec.evalFloat64(e.RHS)
if err != nil {
return nil, err
}
if rhs == 0 {
// TODO: Does real Spanner use a specific error code here?
return nil, fmt.Errorf("divide by zero")
}
return lhs / rhs, nil
case spansql.Add, spansql.Sub, spansql.Mul:
lhs, err := ec.evalExpr(e.LHS)
if err != nil {
return nil, err
}
rhs, err := ec.evalExpr(e.RHS)
if err != nil {
return nil, err
}
i1, ok1 := lhs.(int64)
i2, ok2 := rhs.(int64)
if ok1 && ok2 {
switch e.Op {
case spansql.Add:
return i1 + i2, nil
case spansql.Sub:
return i1 - i2, nil
case spansql.Mul:
return i1 * i2, nil
}
}
f1, err := asFloat64(e.LHS, lhs)
if err != nil {
return nil, err
}
f2, err := asFloat64(e.RHS, rhs)
if err != nil {
return nil, err
}
switch e.Op {
case spansql.Add:
return f1 + f2, nil
case spansql.Sub:
return f1 - f2, nil
case spansql.Mul:
return f1 * f2, nil
}
case spansql.BitAnd, spansql.BitXor, spansql.BitOr:
lhs, err := ec.evalExpr(e.LHS)
if err != nil {
return nil, err
}
rhs, err := ec.evalExpr(e.RHS)
if err != nil {
return nil, err
}
i1, ok1 := lhs.(int64)
i2, ok2 := rhs.(int64)
if ok1 && ok2 {
switch e.Op {
case spansql.BitAnd:
return i1 & i2, nil
case spansql.BitXor:
return i1 ^ i2, nil
case spansql.BitOr:
return i1 | i2, nil
}
}
b1, ok1 := lhs.([]byte)
b2, ok2 := rhs.([]byte)
if !ok1 || !ok2 {
return nil, fmt.Errorf("arguments of %s evaluate to (%T, %T), want (INT64, INT64) or (BYTES, BYTES)", e.SQL(), lhs, rhs)
}
if len(b1) != len(b2) {
return nil, fmt.Errorf("arguments of %s evaluate to BYTES of unequal lengths (%d vs %d)", e.SQL(), len(b1), len(b2))
}
var f func(x, y byte) byte
switch e.Op {
case spansql.BitAnd:
f = func(x, y byte) byte { return x & y }
case spansql.BitXor:
f = func(x, y byte) byte { return x ^ y }
case spansql.BitOr:
f = func(x, y byte) byte { return x | y }
}
b := make([]byte, len(b1))
for i := range b1 {
b[i] = f(b1[i], b2[i])
}
return b, nil
}
// TODO: Concat, BitShl, BitShr
return nil, fmt.Errorf("TODO: evalArithOp(%s %v)", e.SQL(), e.Op)
}
// evalFloat64 evaluates an expression and returns its FLOAT64 value.
// If the expression does not yield a FLOAT64 or INT64 it returns an error.
func (ec evalContext) evalFloat64(e spansql.Expr) (float64, error) {
v, err := ec.evalExpr(e)
if err != nil {
return 0, err
}
return asFloat64(e, v)
}
func asFloat64(e spansql.Expr, v interface{}) (float64, error) {
switch v := v.(type) {
default:
return 0, fmt.Errorf("expression %s evaluates to %T, want FLOAT64 or INT64", e.SQL(), v)
case float64:
return v, nil
case int64:
return float64(v), nil
}
}
func (ec evalContext) evalExpr(e spansql.Expr) (interface{}, error) {
switch e := e.(type) {
default:
return nil, fmt.Errorf("TODO: evalExpr(%s %T)", e.SQL(), e)
case coercedValue:
return e.val, nil
case spansql.ID:
return ec.evalID(e)
case spansql.Param:
qp, ok := ec.params[string(e)]
if !ok {
return 0, fmt.Errorf("unbound param %s", e.SQL())
}
return qp.Value, nil
case spansql.IntegerLiteral:
return int64(e), nil
case spansql.FloatLiteral:
return float64(e), nil
case spansql.StringLiteral:
return string(e), nil
case spansql.BytesLiteral:
return []byte(e), nil
case spansql.NullLiteral:
return nil, nil
case spansql.BoolLiteral:
return bool(e), nil
case spansql.Paren:
return ec.evalExpr(e.Expr)
case spansql.ArithOp:
return ec.evalArithOp(e)
case spansql.LogicalOp:
return ec.evalBoolExpr(e)
case spansql.ComparisonOp:
return ec.evalBoolExpr(e)
case spansql.InOp:
// This is implemented here in evalExpr instead of evalBoolExpr
// because it can return FALSE/TRUE/NULL.
// The docs are a bit confusing here, so there's probably some bugs here around NULL handling.
if len(e.RHS) == 0 {
// "IN with an empty right side expression is always FALSE".
return e.Neg, nil
}
lhs, err := ec.evalExpr(e.LHS)
if err != nil {
return false, err
}
if lhs == nil {
// "IN with a NULL left side expression and a non-empty right side expression is always NULL".
return nil, nil
}
var b bool
for _, rhse := range e.RHS {
rhs, err := ec.evalExpr(rhse)
if err != nil {
return false, err
}
if !e.Unnest {
if lhs == rhs {
b = true
}
} else {
if rhs == nil {
// "IN UNNEST(<NULL array>) returns FALSE (not NULL)".
return e.Neg, nil
}
arr, ok := rhs.([]interface{})
if !ok {
return nil, fmt.Errorf("UNNEST argument evaluated as %T, want array", rhs)
}
for _, rhs := range arr {
// == isn't okay here.
if compareVals(lhs, rhs) == 0 {
b = true
}
}
}
}
if e.Neg {
b = !b
}
return b, nil
case spansql.IsOp:
return ec.evalBoolExpr(e)
case aggSentinel:
// Match up e.AggIndex with the column.
// They might have been reordered.
ci := -1
for i, col := range ec.cols {
if col.AggIndex == e.AggIndex {
ci = i
break
}
}
if ci < 0 {
return 0, fmt.Errorf("internal error: did not find aggregate column %d", e.AggIndex)
}
return ec.row[ci], nil
}
}
func (ec evalContext) evalID(id spansql.ID) (interface{}, error) {
for i, col := range ec.cols {
if col.Name == id {
return ec.row.copyDataElem(i), nil
}
}
if e, ok := ec.aliases[id]; ok {
// Make a copy of the context without this alias
// to prevent an evaluation cycle.
innerEC := ec
innerEC.aliases = make(map[spansql.ID]spansql.Expr)
for alias, e := range ec.aliases {
if alias != id {
innerEC.aliases[alias] = e
}
}
return innerEC.evalExpr(e)
}
return nil, fmt.Errorf("couldn't resolve identifier %s", id)
}
func (ec evalContext) coerceComparisonOpArgs(co spansql.ComparisonOp) (spansql.ComparisonOp, error) {
// https://cloud.google.com/spanner/docs/operators#comparison_operators
if co.RHS2 != nil {
// TODO: Handle co.RHS2 for BETWEEN. The rules for that aren't clear.
return co, nil
}
// Look for a string literal on LHS or RHS.
var err error
if slit, ok := co.LHS.(spansql.StringLiteral); ok {
co.LHS, err = ec.coerceString(co.RHS, slit)
return co, err
}
if slit, ok := co.RHS.(spansql.StringLiteral); ok {
co.RHS, err = ec.coerceString(co.LHS, slit)
return co, err
}
// TODO: Other coercion literals. The int64/float64 code elsewhere may be able to be simplified.
return co, nil
}
// coerceString converts a string literal into something compatible with the target expression.
func (ec evalContext) coerceString(target spansql.Expr, slit spansql.StringLiteral) (spansql.Expr, error) {
ci, err := ec.colInfo(target)
if err != nil {
return nil, err
}
if ci.Type.Array {
return nil, fmt.Errorf("unable to coerce string literal %q to match array type", slit)
}
switch ci.Type.Base {
case spansql.String:
return slit, nil
case spansql.Date:
d, err := parseAsDate(string(slit))
if err != nil {
return nil, fmt.Errorf("coercing string literal %q to DATE: %v", slit, err)
}
return coercedValue{
val: d,
orig: slit,
}, nil
case spansql.Timestamp:
t, err := parseAsTimestamp(string(slit))
if err != nil {
return nil, fmt.Errorf("coercing string literal %q to TIMESTAMP: %v", slit, err)
}
return coercedValue{
val: t,
orig: slit,
}, nil
}
// TODO: Any others?
return nil, fmt.Errorf("unable to coerce string literal %q to match %v", slit, ci.Type)
}
func evalLiteralOrParam(lop spansql.LiteralOrParam, params queryParams) (int64, error) {
switch v := lop.(type) {
case spansql.IntegerLiteral:
return int64(v), nil
case spansql.Param:
return paramAsInteger(v, params)
default:
return 0, fmt.Errorf("LiteralOrParam with %T not supported", v)
}
}
func paramAsInteger(p spansql.Param, params queryParams) (int64, error) {
qp, ok := params[string(p)]
if !ok {
return 0, fmt.Errorf("unbound param %s", p.SQL())
}
switch v := qp.Value.(type) {
default:
return 0, fmt.Errorf("can't interpret parameter %s (%s) value of type %T as integer", p.SQL(), qp.Type.SQL(), v)
case int64:
return v, nil
case string:
x, err := strconv.ParseInt(v, 10, 64)
if err != nil {
return 0, fmt.Errorf("bad int64 string %q: %v", v, err)
}
return x, nil
}
}
// compareValLists compares pair-wise elements of a and b.
// If desc is not nil, it indicates which comparisons should be reversed.
func compareValLists(a, b []interface{}, desc []bool) int {
for i := range a {
cmp := compareVals(a[i], b[i])
if cmp == 0 {
continue
}
if desc != nil && desc[i] {
cmp = -cmp
}
return cmp
}
return 0
}
func compareVals(x, y interface{}) int {
// NULL is always the minimum possible value.
if x == nil && y == nil {
return 0
} else if x == nil {
return -1
} else if y == nil {
return 1
}
// TODO: coerce between more comparable types? factor this out for expressions other than comparisons.
switch x := x.(type) {
default:
panic(fmt.Sprintf("unhandled comparison on %T", x))
case bool:
// false < true
y := y.(bool)
if !x && y {
return -1
} else if x && !y {
return 1
}
return 0
case int64:
if s, ok := y.(string); ok {
var err error
y, err = strconv.ParseInt(s, 10, 64)
if err != nil {
panic(fmt.Sprintf("bad int64 string %q: %v", s, err))
}
}
if f, ok := y.(float64); ok {
// Coersion from INT64 to FLOAT64 is allowed.
return compareVals(x, f)
}
y := y.(int64)
if x < y {
return -1
} else if x > y {
return 1
}
return 0
case float64:
// Coersion from INT64 to FLOAT64 is allowed.
if i, ok := y.(int64); ok {
y = float64(i)
}
y := y.(float64)
if x < y {
return -1
} else if x > y {
return 1
}
return 0
case string:
return strings.Compare(x, y.(string))
case civil.Date:
y := y.(civil.Date)
if x.Before(y) {
return -1
} else if x.After(y) {
return 1
}
return 0
case time.Time:
y := y.(time.Time)
if x.Before(y) {
return -1
} else if x.After(y) {
return 1
}
return 0
case []byte:
return bytes.Compare(x, y.([]byte))
}
}
var (
boolType = spansql.Type{Base: spansql.Bool}
int64Type = spansql.Type{Base: spansql.Int64}
float64Type = spansql.Type{Base: spansql.Float64}
stringType = spansql.Type{Base: spansql.String}
)
func (ec evalContext) colInfo(e spansql.Expr) (colInfo, error) {
// TODO: more types
switch e := e.(type) {
case spansql.BoolLiteral:
return colInfo{Type: boolType}, nil
case spansql.IntegerLiteral:
return colInfo{Type: int64Type}, nil
case spansql.StringLiteral:
return colInfo{Type: stringType}, nil
case spansql.BytesLiteral:
return colInfo{Type: spansql.Type{Base: spansql.Bytes}}, nil
case spansql.ArithOp:
t, err := ec.arithColType(e)
if err != nil {
return colInfo{}, err
}
return colInfo{Type: t}, nil
case spansql.LogicalOp, spansql.ComparisonOp, spansql.IsOp:
return colInfo{Type: spansql.Type{Base: spansql.Bool}}, nil
case spansql.ID:
// TODO: support more than only naming a table column.
for _, col := range ec.cols {
if col.Name == e {
return col, nil
}
}
case spansql.Param:
qp, ok := ec.params[string(e)]
if !ok {
return colInfo{}, fmt.Errorf("unbound param %s", e.SQL())
}
return colInfo{Type: qp.Type}, nil
case spansql.Paren:
return ec.colInfo(e.Expr)
case spansql.NullLiteral:
// There isn't necessarily something sensible here.
// Empirically, though, the real Spanner returns Int64.
return colInfo{Type: int64Type}, nil
case aggSentinel:
return colInfo{Type: e.Type, AggIndex: e.AggIndex}, nil
}
return colInfo{}, fmt.Errorf("can't deduce column type from expression [%s]", e.SQL())
}
func (ec evalContext) arithColType(ao spansql.ArithOp) (spansql.Type, error) {
// The type depends on the particular operator and the argument types.
// https://cloud.google.com/spanner/docs/functions-and-operators#arithmetic_operators
var lhs, rhs spansql.Type
var err error
if ao.LHS != nil {
ci, err := ec.colInfo(ao.LHS)
if err != nil {
return spansql.Type{}, err
}
lhs = ci.Type
}
ci, err := ec.colInfo(ao.RHS)
if err != nil {
return spansql.Type{}, err
}
rhs = ci.Type
switch ao.Op {
default:
return spansql.Type{}, fmt.Errorf("can't deduce column type from ArithOp [%s]", ao.SQL())
case spansql.Neg, spansql.BitNot:
return rhs, nil
case spansql.Add, spansql.Sub, spansql.Mul:
if lhs == int64Type && rhs == int64Type {
return int64Type, nil
}
return float64Type, nil
case spansql.Div:
return float64Type, nil
case spansql.Concat:
if !lhs.Array {
return stringType, nil
}
return lhs, nil
case spansql.BitShl, spansql.BitShr, spansql.BitAnd, spansql.BitXor, spansql.BitOr:
// "All bitwise operators return the same type and the same length as the first operand."
return lhs, nil
}
}
func evalLike(str, pat string) bool {
/*
% matches any number of chars.
_ matches a single char.
TODO: handle escaping
*/
// Lean on regexp for simplicity.
pat = regexp.QuoteMeta(pat)
pat = strings.Replace(pat, "%", ".*", -1)
pat = strings.Replace(pat, "_", ".", -1)
match, err := regexp.MatchString(pat, str)
if err != nil {
panic(fmt.Sprintf("internal error: constructed bad regexp /%s/: %v", pat, err))
}
return match
}