Method Value

array.go:163–187

Value returns a new Value instance with array element for given index. If index is out of array bounds, Value reports failure and returns empty (but non-nil) instance. Example: array := NewArray(t, []interface{}{"foo", 123}) array.Value(0).String().IsEqual("foo") array.Value(1).Number().IsEqua

(index int)

//	array.Value(0).String().IsEqual("foo")
//	array.Value(1).Number().IsEqual(123)
func (a *Array) Value(index int) *Value {
	opChain := a.chain.enter("Value(%d)", index)
	defer opChain.leave()

	if opChain.failed() {
		return newValue(opChain, nil)
	}

	if index < 0 || index >= len(a.value) {
		opChain.fail(AssertionFailure{
			Type:   AssertInRange,
			Actual: &AssertionValue{index},
			Expected: &AssertionValue{AssertionRange{
				Min: 0,
				Max: len(a.value) - 1,
			}},
			Errors: []error{
				errors.New("expected: valid element index"),
			},
		})
		return newValue(opChain, nil)
	}

	return newValue(opChain, a.value[index])
}

// Deprecated: use Value instead.
func (a *Array) Element(index int) *Value {