API Reference

PREVIEW DOCUMENTATION - This is a preview of a new format for the AWS SDK for Go API Reference documentation. For the current AWS SDK for Go API Reference, see

We welcome your feedback on this new version of the documentation. Send your comments to


import ""

func Contains(nameBuilder NameBuilder, substr string) ConditionBuilder

Contains returns a ConditionBuilder representing the result of the contains function in DynamoDB Condition Expressions. The resulting ConditionBuilder can be used as a part of other Condition Expressions or as an argument to the WithCondition() method for the Builder struct.


// condition represents the boolean condition of whether the item // attribute "InviteList" has the value "Ben" condition := expression.Contains(expression.Name("InviteList"), expression.Value("Ben")) // Used in another Condition Expression anotherCondition := expression.Not(condition) // Used to make an Builder builder := expression.NewBuilder().WithCondition(condition)

Expression Equivalent:

expression.Contains(expression.Name("InviteList"), expression.Value("Ben")) // Let :ben be an ExpressionAttributeValue representing the value "Ben" "contains (InviteList, :ben)"


NameBuilder represents a name of a top level item attribute or a nested attribute. Since NameBuilder represents a DynamoDB Operand, it implements the OperandBuilder interface. Methods and functions in the package take NameBuilder as an argument and establishes relationships between operands. NameBuilder should only be initialized using the function Name().


// Create a NameBuilder representing the item attribute "aName" nameBuilder := expression.Name("aName")

Type: string


ConditionBuilder represents Condition Expressions and Filter Expressions in DynamoDB. ConditionBuilders are one of the building blocks of the Builder struct. Since Filter Expressions support all the same functions and formats as Condition Expressions, ConditionBuilders represents both types of Expressions. More Information at: More Information on Filter Expressions:

On this page: