MCPcopy
hub / github.com/sqlalchemy/sqlalchemy / scalar_one_or_none

Method scalar_one_or_none

lib/sqlalchemy/engine/result.py:1070–1085  ·  view source on GitHub ↗

Return exactly one scalar result or ``None``. This is equivalent to calling :meth:`_engine.Result.scalars` and then :meth:`_engine.ScalarResult.one_or_none`. .. seealso:: :meth:`_engine.ScalarResult.one_or_none` :meth:`_engine.Result.scalars`

(self: Result[_T, Unpack[TupleAny]])

Source from the content-addressed store, hash-verified

1068 )
1069
1070 def scalar_one_or_none(self: Result[_T, Unpack[TupleAny]]) -> Optional[_T]:
1071 """Return exactly one scalar result or ``None``.
1072
1073 This is equivalent to calling :meth:`_engine.Result.scalars` and
1074 then :meth:`_engine.ScalarResult.one_or_none`.
1075
1076 .. seealso::
1077
1078 :meth:`_engine.ScalarResult.one_or_none`
1079
1080 :meth:`_engine.Result.scalars`
1081
1082 """
1083 return self._only_one_row(
1084 raise_for_second_row=True, raise_for_none=False, scalar=True
1085 )
1086
1087 def one(self) -> Row[Unpack[_Ts]]:
1088 """Return exactly one row or raise an exception.

Callers 6

result_oneFunction · 0.45
test_stream_scalarMethod · 0.45

Calls 1

_only_one_rowMethod · 0.80

Tested by 3

test_stream_scalarMethod · 0.36