def append(self,
id, # type: str
value, # type: str
*options, # type: Any
**kwargs # type: Any
):
# type: (...)->ResultPrecursor
"""Append a string to an existing value in Couchbase.
:param string value: The data to append to the existing value.
Other parameters follow the same conventions as :meth:`upsert`.
The `format` argument must be one of
:const:`~couchbase_core.FMT_UTF8` or :const:`~couchbase_core.FMT_BYTES`.
If not specified, it will be :const:`~.FMT_UTF8` (overriding the
:attr:`default_format` attribute). This is because JSON or
Pickle formats will be nonsensical when random data is appended
to them. If you wish to modify a JSON or Pickle encoded object,
you will need to retrieve it (via :meth:`get`), modify it, and
then store it again (using :meth:`upsert`).
Additionally, you must ensure the value (and flags) for the
current value is compatible with the data to be appended. For an
example, you may append a :const:`~.FMT_BYTES` value to an
existing :const:`~couchbase_core.FMT_JSON` value, but an error will
be thrown when retrieving the value using :meth:`get` (you may
still use the :attr:`data_passthrough` to overcome this).
:raise: :exc:`.NotStoredError` if the key does not exist
"""
x = _Base.append(self.bucket, id, value, forward_args(kwargs, *options))
return ResultPrecursor(x, options)
def append(self, key, value, *args, **kwargs):
return _Base.append(self, key, value, *args, **kwargs)
