apoc.atomic.concat

Details

Syntax

apoc.atomic.concat(container, propertyName, string [, retryAttempts ]) :: (container, property, oldValue, newValue)

Description

Sets the given property to the concatenation of itself and the STRING value. The procedure then sets the property to the returned STRING.

Input arguments

Name

Type

Description

container

ANY

The node or relationship that contains the property to which the value will be concatenated.

propertyName

STRING

The name of the property to be concatenated.

string

STRING

The string value to concatenate with the property.

retryAttempts

INTEGER

The max retry attempts. The default is: 5.

Return arguments

Name

Type

Description

container

ANY

The updated node or relationship.

property

STRING

The name of the updated property.

oldValue

ANY

The original value on the property.

newValue

ANY

The new value on the property.

Usage examples

The examples in this section are based on the following sample graph:

CREATE (:Person {name:'Tom',age: 40})
CREATE (:Person {name:'Will',age: 35})
CREATE (:Person {name:'David', children: ['Anne','Sam','Paul']})
CREATE (:Person {name:'John', cars: ['Class A','X3','Focus']})
CREATE (:Person {name:'Ryan', salary1:1800, salary2:1500});
The following concatenates iam to the name property for Will:
MATCH (p:Person {name:'Will',age: 35})
CALL apoc.atomic.concat(p,"name",'iam',5)
YIELD oldValue, newValue
RETURN oldValue, newValue;
Results
oldValue newValue

"Will"

"William"