Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://cloud.google.com/cpp/docs/reference/common/2.26.0/classgoogle_1_1cloud_1_1StatusOr below:

Class StatusOr<T> (2.26.0) | C++ Client Libraries

Stay organized with collections Save and categorize content based on your preferences.

• 2.42.0-rc (latest)
• 2.41.0
• 2.40.0
• 2.39.0
• 2.38.0
• 2.37.0
• 2.36.0
• 2.35.0
• 2.34.0
• 2.33.0
• 2.32.0
• 2.31.0
• 2.30.0
• 2.29.0
• 2.28.0
• 2.27.0
• 2.26.0
• 2.25.1
• 2.24.0
• 2.23.0
• 2.22.1
• 2.21.0
• 2.20.0
• 2.19.0
• 2.18.0
• 2.17.0
• 2.16.0
• 2.15.1
• 2.14.0
• 2.13.0
• 2.12.0
• 2.11.0
• 2.10.1

Holds a value or a Status indicating why there is no value.

StatusOr<T> represents either a usable T value or a Status object explaining why a T value is not present. Typical usage of StatusOr<T> looks like usage of a smart pointer, or even a std::optional<T>, in that you first check its validity using a conversion to bool (or by calling StatusOr::ok()), then you may dereference the object to access the contained value.

It is undefined behavior (UB) to dereference a StatusOr<T> that is not "ok". For example:

StatusOr<Foo> foo = FetchFoo();
if (!foo) {  // Same as !foo.ok()
  // handle error and probably look at foo.status()
} else {
  foo->DoSomethingFooey();  // UB if !foo
}

Alternatively, you may call the StatusOr::value() member function, which is defined to: (1) throw an exception if there is no T value, or (2) crash the program if exceptions are disabled. It is never UB to call value().

StatusOr<Foo> foo = FetchFoo();
foo.value().DoSomethingFooey();  // May throw/crash if there is no value

Functions that can fail will often return a StatusOr<T> instead of returning an error code and taking a T out-param, or rather than directly returning the T and throwing an exception on error. StatusOr<T> is used so that callers can choose whether they want to explicitly check for errors, crash the program, or throw exceptions.

Since constructors do not have a return value, they should be designed in such a way that they cannot fail by moving the object's complex initialization logic into a separate factory function that itself can return a StatusOr<T>. For example:

class Bar {
 public:
  Bar(Arg arg);
  ...
};
StatusOr<Bar> MakeBar() {
  ... complicated logic that might fail
  return Bar(std::move(arg));
}

StatusOr<T> supports equality comparisons if the underlying type T does.

Initializes with an error status (StatusCode::kUnknown).

Creates a new StatusOr<T> holding the error condition rhs.

the status to initialize the object.

Creates a new StatusOr<T> holding the value rhs.

the value used to initialize the object.

Creates a new StatusOr<T> holding the value rhs.

the value used to initialize the object.

Dereference operators.

Dereference operators.

Dereference operators.

Dereference operators.

Member access operators.

Member access operators.

Assigns the given non-OK Status to this StatusOr<T>.

Assign a T (or anything convertible to T) into the StatusOr.

This function does not participate in overload resolution if U is equal to StatusOr<T> (or to a cv-ref-qualified StatusOr<T>).

a type convertible to T.

a reference to this object.

Returns true when this holds a value.

Value accessors.

Value accessors.

Value accessors.

Value accessors.

Status accessors.

Status accessors.

Returns true when this holds a value.

Alias Of: T

A value_type member for use in generic programming.

This is analogous to that of std::optional::value_type.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-08-14 UTC.

[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-14 UTC."],[[["`StatusOr\u003cT\u003e` represents either a usable `T` value or a `Status` object, which explains why a `T` value is not available."],["You can check the validity of a `StatusOr\u003cT\u003e` object by converting it to a boolean or using the `ok()` method, and if it is not valid, you can examine the `status()` for details on the error."],["Dereferencing a `StatusOr\u003cT\u003e` that is not \"ok\" is undefined behavior, but calling the `value()` method will throw an exception if there is no `T` value or crash if exceptions are disabled."],["Functions that might fail often return `StatusOr\u003cT\u003e` instead of error codes or exceptions, allowing callers to decide how to handle errors, and constructors that can fail should use a separate factory function that can return a `StatusOr\u003cT\u003e`."],["`StatusOr\u003cT\u003e` objects support equality comparisons if the underlying `T` type also supports equality comparisons."]]],[]]

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4