add tryCreateNetwork()
[folly.git] / folly / IPAddressException.h
index 164d540786b87744d19f304fada5abba2c929034..feb0284cee30f5d6fa2389616f5421c588f3c470 100644 (file)
@@ -1,5 +1,5 @@
 /*
- * Copyright 2015 Facebook, Inc.
+ * Copyright 2014-present Facebook, Inc.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-
 #pragma once
 
 #include <exception>
 #include <string>
+#include <utility>
 
-#include <folly/Conv.h>
+#include <folly/CPortability.h>
 #include <folly/detail/IPAddress.h>
 
 namespace folly {
 
+/**
+ * Error codes for non-throwing interface of IPAddress family of functions.
+ */
+enum class IPAddressFormatError { INVALID_IP, UNSUPPORTED_ADDR_FAMILY };
+
+/**
+ * Wraps error from parsing IP/MASK string
+ */
+enum class CIDRNetworkError {
+  INVALID_DEFAULT_CIDR,
+  INVALID_IP_SLASH_CIDR,
+  INVALID_IP,
+  INVALID_CIDR,
+  CIDR_MISMATCH,
+};
+
 /**
  * Exception for invalid IP addresses.
  */
-class IPAddressFormatException : public std::exception {
+class FOLLY_EXPORT IPAddressFormatException : public std::exception {
  public:
-  explicit IPAddressFormatException(const std::string& msg)
-      : msg_(msg) {}
-  IPAddressFormatException(
-    const IPAddressFormatException&) = default;
-  template<typename... Args>
-  explicit IPAddressFormatException(Args&&... args)
-      : msg_(to<std::string>(std::forward<Args>(args)...)) {}
+  explicit IPAddressFormatException(std::string msg) noexcept
+      : msg_(std::move(msg)) {}
+  IPAddressFormatException(const IPAddressFormatException&) = default;
+  IPAddressFormatException(IPAddressFormatException&&) = default;
+  IPAddressFormatException& operator=(const IPAddressFormatException&) =
+      default;
+  IPAddressFormatException& operator=(IPAddressFormatException&&) = default;
 
-  virtual ~IPAddressFormatException() noexcept {}
-  virtual const char *what(void) const noexcept {
+  ~IPAddressFormatException() noexcept override {}
+  const char* what() const noexcept override {
     return msg_.c_str();
   }
 
  private:
-  const std::string msg_;
+  std::string msg_;
 };
 
-class InvalidAddressFamilyException : public IPAddressFormatException {
+class FOLLY_EXPORT InvalidAddressFamilyException
+    : public IPAddressFormatException {
  public:
-  explicit InvalidAddressFamilyException(const std::string& msg)
-      : IPAddressFormatException(msg) {}
-  InvalidAddressFamilyException(
-    const InvalidAddressFamilyException&) = default;
-  explicit InvalidAddressFamilyException(sa_family_t family)
-      : IPAddressFormatException("Address family " +
-                                 detail::familyNameStr(family) +
-                                 " is not AF_INET or AF_INET6") {}
-  template<typename... Args>
-  explicit InvalidAddressFamilyException(Args&&... args)
-      : IPAddressFormatException(std::forward<Args>(args)...) {}
+  explicit InvalidAddressFamilyException(std::string msg) noexcept
+      : IPAddressFormatException(std::move(msg)) {}
+  explicit InvalidAddressFamilyException(sa_family_t family) noexcept
+      : InvalidAddressFamilyException(
+            "Address family " + detail::familyNameStr(family) +
+            " is not AF_INET or AF_INET6") {}
+  InvalidAddressFamilyException(const InvalidAddressFamilyException&) = default;
+  InvalidAddressFamilyException(InvalidAddressFamilyException&&) = default;
+  InvalidAddressFamilyException& operator=(
+      const InvalidAddressFamilyException&) = default;
+  InvalidAddressFamilyException& operator=(InvalidAddressFamilyException&&) =
+      default;
 };
 
-}  // folly
+} // namespace folly