class_tcp_server.rst 3.9 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879
  1. :github_url: hide
  2. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  3. .. DO NOT EDIT THIS FILE, but the TCP_Server.xml source instead.
  4. .. The source is found in doc/classes or modules/<name>/doc_classes.
  5. .. _class_TCP_Server:
  6. TCP_Server
  7. ==========
  8. **Inherits:** :ref:`Reference<class_Reference>` **<** :ref:`Object<class_Object>`
  9. **Category:** Core
  10. Brief Description
  11. -----------------
  12. A TCP server.
  13. Methods
  14. -------
  15. +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
  16. | :ref:`bool<class_bool>` | :ref:`is_connection_available<class_TCP_Server_method_is_connection_available>` **(** **)** const |
  17. +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
  18. | :ref:`bool<class_bool>` | :ref:`is_listening<class_TCP_Server_method_is_listening>` **(** **)** const |
  19. +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
  20. | :ref:`Error<enum_@GlobalScope_Error>` | :ref:`listen<class_TCP_Server_method_listen>` **(** :ref:`int<class_int>` port, :ref:`String<class_String>` bind_address="*" **)** |
  21. +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
  22. | void | :ref:`stop<class_TCP_Server_method_stop>` **(** **)** |
  23. +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
  24. | :ref:`StreamPeerTCP<class_StreamPeerTCP>` | :ref:`take_connection<class_TCP_Server_method_take_connection>` **(** **)** |
  25. +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
  26. Description
  27. -----------
  28. A TCP server. Listens to connections on a port and returns a :ref:`StreamPeerTCP<class_StreamPeerTCP>` when it gets an incoming connection.
  29. Method Descriptions
  30. -------------------
  31. .. _class_TCP_Server_method_is_connection_available:
  32. - :ref:`bool<class_bool>` **is_connection_available** **(** **)** const
  33. Returns ``true`` if a connection is available for taking.
  34. .. _class_TCP_Server_method_is_listening:
  35. - :ref:`bool<class_bool>` **is_listening** **(** **)** const
  36. Returns ``true`` if the server is currently listening for connections.
  37. .. _class_TCP_Server_method_listen:
  38. - :ref:`Error<enum_@GlobalScope_Error>` **listen** **(** :ref:`int<class_int>` port, :ref:`String<class_String>` bind_address="*" **)**
  39. Listen on the ``port`` binding to ``bind_address``.
  40. If ``bind_address`` is set as ``"*"`` (default), the server will listen on all available addresses (both IPv4 and IPv6).
  41. If ``bind_address`` is set as ``"0.0.0.0"`` (for IPv4) or ``"::"`` (for IPv6), the server will listen on all available addresses matching that IP type.
  42. If ``bind_address`` is set to any valid address (e.g. ``"192.168.1.101"``, ``"::1"``, etc), the server will only listen on the interface with that addresses (or fail if no interface with the given address exists).
  43. .. _class_TCP_Server_method_stop:
  44. - void **stop** **(** **)**
  45. Stops listening.
  46. .. _class_TCP_Server_method_take_connection:
  47. - :ref:`StreamPeerTCP<class_StreamPeerTCP>` **take_connection** **(** **)**
  48. If a connection is available, returns a StreamPeerTCP with the connection.