gcc/rust/util/rust-punycode.h

   1 // Copyright (C) 2020-2024 Free Software Foundation, Inc.
   2
   3 // This file is part of GCC.
   4
   5 // GCC is free software; you can redistribute it and/or modify it under
   6 // the terms of the GNU General Public License as published by the Free
   7 // Software Foundation; either version 3, or (at your option) any later
   8 // version.
   9
  10 // GCC is distributed in the hope that it will be useful, but WITHOUT ANY
  11 // WARRANTY; without even the implied warranty of MERCHANTABILITY or
  12 // FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  13 // for more details.
  14
  15 // You should have received a copy of the GNU General Public License
  16 // along with GCC; see the file COPYING3.  If not see
  17 // <http://www.gnu.org/licenses/>.
  18
  19 #ifndef RUST_PUNYCODE_H
  20 #define RUST_PUNYCODE_H
  21
  22 #include "rust-unicode.h"
  23 #include "optional.h"
  24
  25 namespace Rust {
  26
  27 /* Encode a string as punycode. Returns a string if encoding is successful.
  28  * Returns nullopt otherwise. Note that a returned string contains only ASCII
  29  * characters and does not start with `xn--`. */
  30 tl::optional<std::string>
  31 encode_punycode (const Utf8String &src);
  32
  33 } // namespace Rust
  34
  35 #if CHECKING_P
  36
  37 namespace selftest {
  38
  39 void
  40 rust_punycode_encode_test ();
  41
  42 } // namespace selftest
  43
  44 #endif // CHECKING_P
  45
  46 #endif