Back to Seed Clases

Soup

Classes

Interfaces

Structs

Unions

Enums

GObject.Object
parent-child marker Soup.Address

Class Soup.Address

Import line:	Soup = imports.gi.Soup;
GIR File:	Soup-2.4.gir
C documentation:	SoupAddress
Class :	Address
Extends:	GObject.Object
	Show / Hide Inherited methods, properties and signals

Properties
Properties		Defined By
	family : Soup.AddressFamily	Soup.Address
	name : String	Soup.Address
	parent : GObject.Object read only	Soup.Address
	physical : String read only	Soup.Address
	port : Number	Soup.Address
	sockaddr : void*	Soup.Address

Methods / Constructors
Method / Constructor		Defined By
	new Soup.Address (Object *properties) Create a new Soup.Address Create a new Soup.Address Parameters: Object properties*
	new Soup.Address.any (AddressFamily *family, Number port) : Soup.Address Create a new Soup.Address Create a new Soup.Address Parameters: Soup.AddressFamily family* Required (not null) Number port Required (not null) Returns: Soup.Address the new SoupAddress
	new Soup.Address.c_new (String *name, Number port) : Soup.Address Create a new Soup.Address Create a new Soup.Address Parameters: String name* Required (not null) Number port Required (not null) Returns: Soup.Address
	new Soup.Address.from_sockaddr (void* sa, Number *len) : Soup.Address Create a new Soup.Address Create a new Soup.Address Parameters: void sa Required (not null) Number len Required (not null) Returns: Soup.Address the new SoupAddress
	Soup.Address.equal_by_ip (void* *addr1, void *addr2) : Boolean Tests if addr1 and addr2 have the same IP address. Tests if addr1 and addr2 have the same IP address. This method can be used with soup_address_hash_by_ip() to create a GHashTable* that hashes on IP address. This would be used to distinguish hosts in situations where different virtual hosts on the same IP address should be considered the same. Eg, if "www.example.com" and "www.example.net" have the same IP address, then a single SoupConnection can be used to talk to either of them. See also soup_address_equal_by_name(), which compares by name rather than by IP address. address. Parameters: void* addr1 Required (not null) void* addr2 Required (not null) Returns: Boolean	Soup.Address
	Soup.Address.equal_by_name (void* *addr1, void *addr2) : Boolean Tests if addr1 and addr2 have the same "name". Tests if addr1 and addr2 have the same "name". This method can be used with soup_address_hash_by_name() to create a GHashTable* that hashes on address "names". Comparing by name normally means comparing the addresses by their hostnames. But if the address was originally created using an IP address literal, then it will be compared by that instead. In particular, if "www.example.com" has the IP address 10.0.0.1, and addr1 was created with the name "www.example.com" and addr2 was created with the name "10.0.0.1", then they will compare as unequal for purposes of soup_address_equal_by_name(). This would be used to distinguish hosts in situations where different virtual hosts on the same IP address should be considered different. Eg, for purposes of HTTP authentication or cookies, two hosts with the same IP address but different names are considered to be different hosts. See also soup_address_equal_by_ip(), which compares by IP address rather than by name. Parameters: void* addr1 Required (not null) void* addr2 Required (not null) Returns: Boolean	Soup.Address
	Soup.Address.hash_by_ip (void* *addr) : Number A hash function (for GHashTable) that corresponds to soup_address_equal_by_ip(), qv A hash function (for GHashTable) that corresponds to soup_address_equal_by_ip(), qv Parameters: void addr Required (not null) Returns: Number	Soup.Address
	Soup.Address.hash_by_name (void* *addr) : Number A hash function (for GHashTable) that corresponds to soup_address_equal_by_name(), qv A hash function (for GHashTable) that corresponds to soup_address_equal_by_name(), qv Parameters: void addr Required (not null) Returns: Number	Soup.Address
	get_name () : String Returns the hostname associated with addr. Returns the hostname associated with addr. This method is not thread-safe; if you call it while addr is being resolved in another thread, it may return garbage. You can use soup_address_is_resolved() to safely test whether or not an address is resolved before fetching its name or address. Returns: String the hostname, or NULL if it is not known.	Soup.Address
	get_physical () : String Returns the physical address associated with addr as a string. Returns the physical address associated with addr as a string. (Eg, "127.0.0.1"). If the address is not yet known, returns NULL. This method is not thread-safe; if you call it while addr is being resolved in another thread, it may return garbage. You can use soup_address_is_resolved() to safely test whether or not an address is resolved before fetching its name or address. Returns: String the physical address, or NULL	Soup.Address
	get_port () : Number Returns the port associated with addr. Returns the port associated with addr. Returns: Number	Soup.Address
	get_sockaddr (Object *out_values) : void Returns the sockaddr associated with addr, with its length in *len. Returns the sockaddr associated with addr, with its length in *len. If the sockaddr is not yet known, returns NULL. This method is not thread-safe; if you call it while addr is being resolved in another thread, it may return garbage. You can use soup_address_is_resolved() to safely test whether or not an address is resolved before fetching its name or address. Parameters: Object out_values Number len Returns: void* the sockaddr, or NULL	Soup.Address
	is_resolved () : Boolean Tests if addr has already been resolved. Tests if addr has already been resolved. Unlike the other SoupAddress "get" methods, this is safe to call when addr might be being resolved in another thread. Returns: Boolean	Soup.Address
	resolve_async (MainContext *async_context, Cancellable cancellable, Function callback, void *user_data) : none Asynchronously resolves the missing half of addr* (its IP address if it was created with soup_address_new(), or its hostname if it was created with soup_address_new_from_sockaddr() or soup_address_new_any(). Asynchronously resolves the missing half of addr (its IP address if it was created with soup_address_new(), or its hostname if it was created with soup_address_new_from_sockaddr() or soup_address_new_any().) If cancellable is non-NULL, it can be used to cancel the resolution. callback will still be invoked in this case, with a status of SOUP_STATUS_CANCELLED. It is safe to call this more than once on a given address, from the same thread, with the same async_context (and doing so will not result in redundant DNS queries being made). But it is not safe to call from multiple threads, or with different async_contexts, or mixed with calls to soup_address_resolve_sync(). Parameters: GLib.MainContext async_context Required (not null) Gio.Cancellable cancellable Function (Address *addr, Number status, void *data) : none Required (not null) callback to call with the result void user_data Required (not null) Returns: none	Soup.Address
	resolve_sync (Cancellable *cancellable) : Number Synchronously resolves the missing half of addr, as with soup_address_resolve_async(). Synchronously resolves the missing half of addr, as with soup_address_resolve_async(). If cancellable* is non-NULL, it can be used to cancel the resolution. soup_address_resolve_sync() will then return a status of SOUP_STATUS_CANCELLED. It is safe to call this more than once, even from different threads, but it is not safe to mix calls to soup_address_resolve_sync() with calls to soup_address_resolve_async() on the same address. SOUP_STATUS_CANCELLED. Parameters: Gio.Cancellable cancellable Returns: Number	Soup.Address

Events
None

Used by These Methods / Signals / Properties
Class / Namespace	Method / Signal / Properties
Soup.ClientContext Method	get_address () : Soup.Address Retrieves the SoupAddress associated with the remote end of a connection.
Soup.Connection Property	remote_address : Soup.Address
Soup.Connection Property	tunnel_address : Soup.Address
Soup.Connection Method	get_tunnel_addr () : Soup.Address
Soup.Message Method	get_address () : Soup.Address Gets the address msg's URI points to.
Soup.ProxyResolver Method	get_proxy_sync (Message *msg, Cancellable cancellable, Address addr*) : Number
Soup.Server Property	interface : Soup.Address
Soup.Session Method	make_connect_message (Address *server_addr*) : Soup.MessageQueueItem
Soup.Socket Property	local_address : Soup.Address
Soup.Socket Property	remote_address : Soup.Address
Soup.Socket Method	get_local_address () : Soup.Address Returns the SoupAddress corresponding to the local end of sock.
Soup.Socket Method	get_remote_address () : Soup.Address Returns the SoupAddress corresponding to the remote end of sock.

Documentation generated by Introspection Doc Generator Loosely Based on JsDoc Toolkit on Tue Jun 22 2010 16:34:59 GMT+0800 (HKT)