class_tcp_server.rst 4.2 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586
  1. :github_url: hide
  2. .. Generated automatically by doc/tools/make_rst.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. A TCP server.
  10. Description
  11. -----------
  12. A TCP server. Listens to connections on a port and returns a :ref:`StreamPeerTCP<class_StreamPeerTCP>` when it gets an incoming connection.
  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. Method Descriptions
  27. -------------------
  28. .. _class_TCP_Server_method_is_connection_available:
  29. - :ref:`bool<class_bool>` **is_connection_available** **(** **)** |const|
  30. Returns ``true`` if a connection is available for taking.
  31. ----
  32. .. _class_TCP_Server_method_is_listening:
  33. - :ref:`bool<class_bool>` **is_listening** **(** **)** |const|
  34. Returns ``true`` if the server is currently listening for connections.
  35. ----
  36. .. _class_TCP_Server_method_listen:
  37. - :ref:`Error<enum_@GlobalScope_Error>` **listen** **(** :ref:`int<class_int>` port, :ref:`String<class_String>` bind_address="*" **)**
  38. Listen on the ``port`` binding to ``bind_address``.
  39. If ``bind_address`` is set as ``"*"`` (default), the server will listen on all available addresses (both IPv4 and IPv6).
  40. 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.
  41. 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).
  42. ----
  43. .. _class_TCP_Server_method_stop:
  44. - void **stop** **(** **)**
  45. Stops listening.
  46. ----
  47. .. _class_TCP_Server_method_take_connection:
  48. - :ref:`StreamPeerTCP<class_StreamPeerTCP>` **take_connection** **(** **)**
  49. If a connection is available, returns a StreamPeerTCP with the connection.
  50. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  51. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  52. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`