netwerk/dns/nsIDNSRecord.idlScriptable
This interface represents the result of a DNS lookup. Since a DNS query may return more than one resolved IP address, the record acts like an enumerator, allowing the caller to easily step through the list of IP addresses.
Inherits from: nsISupports Last changed in Gecko 1.7

Method overview

PRNetAddr getNextAddr(in PRUint16 aPort); Native code only!
ACString getNextAddrAsString();
boolean hasMore();
void rewind();

Attributes

Attribute Type Description
canonicalName ACString for example, www.mozilla.org --> rheet.mozilla.org. Read only.

Methods

Native code only!

getNextAddr

This function copies the value of the next IP address into the given PRNetAddr struct and increments the internal address iterator.

PRNetAddr getNextAddr(
  in PRUint16 aPort
);
Parameters
aPort
A port number to initialize the PRNetAddr with.
Return value

The value of the next IP address.

getNextAddrAsString()

This function returns the value of the next IP address as a string and increments the internal address iterator.

ACString getNextAddrAsString();
Parameters

None.

Return value

The value of the next IP address as a string.

hasMore()

This method checks if there is another address in the record.

boolean hasMore();
Parameters

None.

Return value

true if there is another address in the record.

rewind()

This function resets the internal address iterator to the first address in the record.

void rewind();
Parameters

None.