/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#ifndef mozilla_ErrorNames_h
#define mozilla_ErrorNames_h

#include "nsError.h"
#include "nsStringFwd.h"

namespace mozilla {

// Maps the given nsresult to its symbolic name. For example,
// GetErrorName(NS_OK, name) will result in name == "NS_OK".
// When the symbolic name is unknown, name will be of the form
// "NS_ERROR_GENERATE_SUCCESS(<module>, <code>)" or
// "NS_ERROR_GENERATE_FAILURE(<module>, <code>)".
void GetErrorName(nsresult rv, nsACString& name);

// Same as GetErrorName, except that only nsresult values with statically
// known symbolic names are handled. For all other values, nullptr is
// returned.
const char* GetStaticErrorName(nsresult rv);

}  // namespace mozilla

// Same as calling GetErrorName, but more convenient for {fmt}.
nsCString format_as(nsresult rv);

#endif  // mozilla_ErrorNames_h