python-docs-fr/library/ipaddress.po

# Copyright (C) 2001-2018, Python Software Foundation
# For licence information, see README file.
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-12-17 16:05+0100\n"
"PO-Revision-Date: 2021-04-18 22:57+0200\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Last-Translator: Caliendo Julien <caliendo@hotmail.fr>\n"
"X-Generator: Poedit 2.4.1\n"

#: library/ipaddress.rst:2
msgid ":mod:`ipaddress` --- IPv4/IPv6 manipulation library"
msgstr ""

#: library/ipaddress.rst:9
msgid "**Source code:** :source:`Lib/ipaddress.py`"
msgstr "**Code source :** :source:`Lib/ipaddress.py`"

#: library/ipaddress.rst:13
msgid ""
":mod:`ipaddress` provides the capabilities to create, manipulate and operate "
"on IPv4 and IPv6 addresses and networks."
msgstr ""

#: library/ipaddress.rst:16
msgid ""
"The functions and classes in this module make it straightforward to handle "
"various tasks related to IP addresses, including checking whether or not two "
"hosts are on the same subnet, iterating over all hosts in a particular "
"subnet, checking whether or not a string represents a valid IP address or "
"network definition, and so on."
msgstr ""

#: library/ipaddress.rst:22
msgid ""
"This is the full module API reference—for an overview and introduction, see :"
"ref:`ipaddress-howto`."
msgstr ""

#: library/ipaddress.rst:35
msgid "Convenience factory functions"
msgstr ""

#: library/ipaddress.rst:37
msgid ""
"The :mod:`ipaddress` module provides factory functions to conveniently "
"create IP addresses, networks and interfaces:"
msgstr ""

#: library/ipaddress.rst:42
msgid ""
"Return an :class:`IPv4Address` or :class:`IPv6Address` object depending on "
"the IP address passed as argument.  Either IPv4 or IPv6 addresses may be "
"supplied; integers less than 2**32 will be considered to be IPv4 by default. "
"A :exc:`ValueError` is raised if *address* does not represent a valid IPv4 "
"or IPv6 address."
msgstr ""

#: library/ipaddress.rst:56
msgid ""
"Return an :class:`IPv4Network` or :class:`IPv6Network` object depending on "
"the IP address passed as argument.  *address* is a string or integer "
"representing the IP network.  Either IPv4 or IPv6 networks may be supplied; "
"integers less than 2**32 will be considered to be IPv4 by default.  *strict* "
"is passed to :class:`IPv4Network` or :class:`IPv6Network` constructor.  A :"
"exc:`ValueError` is raised if *address* does not represent a valid IPv4 or "
"IPv6 address, or if the network has host bits set."
msgstr ""

#: library/ipaddress.rst:70
msgid ""
"Return an :class:`IPv4Interface` or :class:`IPv6Interface` object depending "
"on the IP address passed as argument.  *address* is a string or integer "
"representing the IP address.  Either IPv4 or IPv6 addresses may be supplied; "
"integers less than 2**32 will be considered to be IPv4 by default.  A :exc:"
"`ValueError` is raised if *address* does not represent a valid IPv4 or IPv6 "
"address."
msgstr ""

#: library/ipaddress.rst:77
msgid ""
"One downside of these convenience functions is that the need to handle both "
"IPv4 and IPv6 formats means that error messages provide minimal information "
"on the precise error, as the functions don't know whether the IPv4 or IPv6 "
"format was intended. More detailed error reporting can be obtained by "
"calling the appropriate version specific class constructors directly."
msgstr ""

#: library/ipaddress.rst:86
msgid "IP Addresses"
msgstr ""

#: library/ipaddress.rst:89
msgid "Address objects"
msgstr ""

#: library/ipaddress.rst:91
msgid ""
"The :class:`IPv4Address` and :class:`IPv6Address` objects share a lot of "
"common attributes.  Some attributes that are only meaningful for IPv6 "
"addresses are also implemented by :class:`IPv4Address` objects, in order to "
"make it easier to write code that handles both IP versions correctly.  "
"Address objects are :term:`hashable`, so they can be used as keys in "
"dictionaries."
msgstr ""

#: library/ipaddress.rst:99
msgid ""
"Construct an IPv4 address.  An :exc:`AddressValueError` is raised if "
"*address* is not a valid IPv4 address."
msgstr ""

#: library/ipaddress.rst:102
msgid "The following constitutes a valid IPv4 address:"
msgstr ""

#: library/ipaddress.rst:104
msgid ""
"A string in decimal-dot notation, consisting of four decimal integers in the "
"inclusive range 0--255, separated by dots (e.g. ``192.168.0.1``). Each "
"integer represents an octet (byte) in the address. Leading zeroes are "
"tolerated only for values less than 8 (as there is no ambiguity between the "
"decimal and octal interpretations of such strings)."
msgstr ""

#: library/ipaddress.rst:109
msgid "An integer that fits into 32 bits."
msgstr ""

#: library/ipaddress.rst:110
msgid ""
"An integer packed into a :class:`bytes` object of length 4 (most significant "
"octet first)."
msgstr ""

#: library/ipaddress.rst:122
msgid "The appropriate version number: ``4`` for IPv4, ``6`` for IPv6."
msgstr ""

#: library/ipaddress.rst:126
msgid ""
"The total number of bits in the address representation for this version: "
"``32`` for IPv4, ``128`` for IPv6."
msgstr ""

#: library/ipaddress.rst:129
msgid ""
"The prefix defines the number of leading bits in an  address that are "
"compared to determine whether or not an address is part of a network."
msgstr ""

#: library/ipaddress.rst:136
msgid ""
"The string representation in dotted decimal notation. Leading zeroes are "
"never included in the representation."
msgstr ""

#: library/ipaddress.rst:139
msgid ""
"As IPv4 does not define a shorthand notation for addresses with octets set "
"to zero, these two attributes are always the same as ``str(addr)`` for IPv4 "
"addresses. Exposing these attributes makes it easier to write display code "
"that can handle both IPv4 and IPv6 addresses."
msgstr ""

#: library/ipaddress.rst:146
msgid ""
"The binary representation of this address - a :class:`bytes` object of the "
"appropriate length (most significant octet first). This is 4 bytes for IPv4 "
"and 16 bytes for IPv6."
msgstr ""

#: library/ipaddress.rst:152
msgid "The name of the reverse DNS PTR record for the IP address, e.g.::"
msgstr ""

#: library/ipaddress.rst:159
msgid ""
"This is the name that could be used for performing a PTR lookup, not the "
"resolved hostname itself."
msgstr ""

#: library/ipaddress.rst:166
msgid ""
"``True`` if the address is reserved for multicast use.  See :RFC:`3171` (for "
"IPv4) or :RFC:`2373` (for IPv6)."
msgstr ""

#: library/ipaddress.rst:171
msgid ""
"``True`` if the address is allocated for private networks.  See iana-ipv4-"
"special-registry_ (for IPv4) or iana-ipv6-special-registry_ (for IPv6)."
msgstr ""

#: library/ipaddress.rst:177
msgid ""
"``True`` if the address is allocated for public networks.  See iana-ipv4-"
"special-registry_ (for IPv4) or iana-ipv6-special-registry_ (for IPv6)."
msgstr ""

#: library/ipaddress.rst:185
msgid ""
"``True`` if the address is unspecified.  See :RFC:`5735` (for IPv4) or :RFC:"
"`2373` (for IPv6)."
msgstr ""

#: library/ipaddress.rst:190
msgid "``True`` if the address is otherwise IETF reserved."
msgstr ""

#: library/ipaddress.rst:194
msgid ""
"``True`` if this is a loopback address.  See :RFC:`3330` (for IPv4) or :RFC:"
"`2373` (for IPv6)."
msgstr ""

#: library/ipaddress.rst:199
msgid ""
"``True`` if the address is reserved for link-local usage.  See :RFC:`3927`."
msgstr ""

#: library/ipaddress.rst:207
msgid ""
"Returns a string representation of the IP address, controlled by an explicit "
"format string. *fmt* can be one of the following: ``'s'``, the default "
"option, equivalent to :func:`str`, ``'b'`` for a zero-padded binary string, "
"``'X'`` or ``'x'`` for an uppercase or lowercase hexadecimal representation, "
"or ``'n'``, which is equivalent to ``'b'`` for IPv4 addresses and ``'x'`` "
"for IPv6. For binary and hexadecimal representations, the form specifier "
"``'#'`` and the grouping option ``'_'`` are available. ``__format__`` is "
"used by ``format``, ``str.format`` and f-strings."
msgstr ""

#: library/ipaddress.rst:234
msgid ""
"Construct an IPv6 address.  An :exc:`AddressValueError` is raised if "
"*address* is not a valid IPv6 address."
msgstr ""

#: library/ipaddress.rst:237
msgid "The following constitutes a valid IPv6 address:"
msgstr ""

#: library/ipaddress.rst:239
msgid ""
"A string consisting of eight groups of four hexadecimal digits, each group "
"representing 16 bits.  The groups are separated by colons. This describes an "
"*exploded* (longhand) notation.  The string can also be *compressed* "
"(shorthand notation) by various means.  See :RFC:`4291` for details.  For "
"example, ``\"0000:0000:0000:0000:0000:0abc:0007:0def\"`` can be compressed "
"to ``\"::abc:7:def\"``."
msgstr ""

#: library/ipaddress.rst:247
msgid ""
"Optionally, the string may also have a scope zone ID, expressed with a "
"suffix ``%scope_id``. If present, the scope ID must be non-empty, and may "
"not contain ``%``. See :RFC:`4007` for details. For example, "
"``fe80::1234%1`` might identify address ``fe80::1234`` on the first link of "
"the node."
msgstr ""

#: library/ipaddress.rst:252
msgid "An integer that fits into 128 bits."
msgstr ""

#: library/ipaddress.rst:253
msgid ""
"An integer packed into a :class:`bytes` object of length 16, big-endian."
msgstr ""

#: library/ipaddress.rst:263
msgid ""
"The short form of the address representation, with leading zeroes in groups "
"omitted and the longest sequence of groups consisting entirely of zeroes "
"collapsed to a single empty group."
msgstr ""

#: library/ipaddress.rst:267
msgid "This is also the value returned by ``str(addr)`` for IPv6 addresses."
msgstr ""

#: library/ipaddress.rst:271
msgid ""
"The long form of the address representation, with all leading zeroes and "
"groups consisting entirely of zeroes included."
msgstr ""

#: library/ipaddress.rst:275
msgid ""
"For the following attributes and methods, see the corresponding "
"documentation of the :class:`IPv4Address` class:"
msgstr ""

#: library/ipaddress.rst:290
msgid "is_global"
msgstr ""

#: library/ipaddress.rst:295
msgid ""
"``True`` if the address is reserved for site-local usage.  Note that the "
"site-local address space has been deprecated by :RFC:`3879`. Use :attr:"
"`~IPv4Address.is_private` to test if this address is in the space of unique "
"local addresses as defined by :RFC:`4193`."
msgstr ""

#: library/ipaddress.rst:302
msgid ""
"For addresses that appear to be IPv4 mapped addresses (starting with ``::"
"FFFF/96``), this property will report the embedded IPv4 address. For any "
"other address, this property will be ``None``."
msgstr ""

#: library/ipaddress.rst:308
msgid ""
"For scoped addresses as defined by :RFC:`4007`, this property identifies the "
"particular zone of the address's scope that the address belongs to, as a "
"string. When no scope zone is specified, this property will be ``None``."
msgstr ""

#: library/ipaddress.rst:314
msgid ""
"For addresses that appear to be 6to4 addresses  (starting with "
"``2002::/16``) as defined by :RFC:`3056`, this property will report the "
"embedded IPv4 address.  For any other address, this property will be "
"``None``."
msgstr ""

#: library/ipaddress.rst:321
msgid ""
"For addresses that appear to be Teredo addresses (starting with "
"``2001::/32``) as defined by :RFC:`4380`, this property will report the "
"embedded ``(server, client)`` IP address pair.  For any other address, this "
"property will be ``None``."
msgstr ""

#: library/ipaddress.rst:328
msgid ""
"Refer to the corresponding method documentation in :class:`IPv4Address`."
msgstr ""

#: library/ipaddress.rst:334
msgid "Conversion to Strings and Integers"
msgstr ""

#: library/ipaddress.rst:336
msgid ""
"To interoperate with networking interfaces such as the socket module, "
"addresses must be converted to strings or integers. This is handled using "
"the :func:`str` and :func:`int` builtin functions::"
msgstr ""

#: library/ipaddress.rst:349
msgid ""
"Note that IPv6 scoped addresses are converted to integers without scope zone "
"ID."
msgstr ""

#: library/ipaddress.rst:737 library/ipaddress.rst:873
msgid "Operators"
msgstr "Opérateurs"

#: library/ipaddress.rst:355
msgid ""
"Address objects support some operators.  Unless stated otherwise, operators "
"can only be applied between compatible objects (i.e. IPv4 with IPv4, IPv6 "
"with IPv6)."
msgstr ""

#: library/ipaddress.rst:361
msgid "Comparison operators"
msgstr ""

#: library/ipaddress.rst:363
msgid ""
"Address objects can be compared with the usual set of comparison operators. "
"Same IPv6 addresses with different scope zone IDs are not equal. Some "
"examples::"
msgstr ""

#: library/ipaddress.rst:380
msgid "Arithmetic operators"
msgstr ""

#: library/ipaddress.rst:382
msgid ""
"Integers can be added to or subtracted from address objects.  Some examples::"
msgstr ""

#: library/ipaddress.rst:395
msgid "IP Network definitions"
msgstr ""

#: library/ipaddress.rst:397
msgid ""
"The :class:`IPv4Network` and :class:`IPv6Network` objects provide a "
"mechanism for defining and inspecting IP network definitions.  A network "
"definition consists of a *mask* and a *network address*, and as such defines "
"a range of IP addresses that equal the network address when masked (binary "
"AND) with the mask.  For example, a network definition with the mask "
"``255.255.255.0`` and the network address ``192.168.1.0`` consists of IP "
"addresses in the inclusive range ``192.168.1.0`` to ``192.168.1.255``."
msgstr ""

#: library/ipaddress.rst:407
msgid "Prefix, net mask and host mask"
msgstr ""

#: library/ipaddress.rst:409
msgid ""
"There are several equivalent ways to specify IP network masks.  A *prefix* "
"``/<nbits>`` is a notation that denotes how many high-order bits are set in "
"the network mask.  A *net mask* is an IP address with some number of high-"
"order bits set.  Thus the prefix ``/24`` is equivalent to the net mask "
"``255.255.255.0`` in IPv4, or ``ffff:ff00::`` in IPv6.  In addition, a *host "
"mask* is the logical inverse of a *net mask*, and is sometimes used (for "
"example in Cisco access control lists) to denote a network mask.  The host "
"mask equivalent to ``/24`` in IPv4 is ``0.0.0.255``."
msgstr ""

#: library/ipaddress.rst:420
msgid "Network objects"
msgstr ""

#: library/ipaddress.rst:422
msgid ""
"All attributes implemented by address objects are implemented by network "
"objects as well.  In addition, network objects implement additional "
"attributes. All of these are common between :class:`IPv4Network` and :class:"
"`IPv6Network`, so to avoid duplication they are only documented for :class:"
"`IPv4Network`. Network objects are :term:`hashable`, so they can be used as "
"keys in dictionaries."
msgstr ""

#: library/ipaddress.rst:431
msgid ""
"Construct an IPv4 network definition.  *address* can be one of the following:"
msgstr ""

#: library/ipaddress.rst:433
msgid ""
"A string consisting of an IP address and an optional mask, separated by a "
"slash (``/``).  The IP address is the network address, and the mask can be "
"either a single number, which means it's a *prefix*, or a string "
"representation of an IPv4 address.  If it's the latter, the mask is "
"interpreted as a *net mask* if it starts with a non-zero field, or as a "
"*host mask* if it starts with a zero field, with the single exception of an "
"all-zero mask which is treated as a *net mask*.  If no mask is provided, "
"it's considered to be ``/32``."
msgstr ""

#: library/ipaddress.rst:442
msgid ""
"For example, the following *address* specifications are equivalent: "
"``192.168.1.0/24``, ``192.168.1.0/255.255.255.0`` and "
"``192.168.1.0/0.0.0.255``."
msgstr ""

#: library/ipaddress.rst:446
msgid ""
"An integer that fits into 32 bits.  This is equivalent to a single-address "
"network, with the network address being *address* and the mask being ``/32``."
msgstr ""

#: library/ipaddress.rst:450
msgid ""
"An integer packed into a :class:`bytes` object of length 4, big-endian. The "
"interpretation is similar to an integer *address*."
msgstr ""

#: library/ipaddress.rst:453
msgid ""
"A two-tuple of an address description and a netmask, where the address "
"description is either a string, a 32-bits integer, a 4-bytes packed integer, "
"or an existing IPv4Address object; and the netmask is either an integer "
"representing the prefix length (e.g. ``24``) or a string representing the "
"prefix mask (e.g. ``255.255.255.0``)."
msgstr ""

#: library/ipaddress.rst:459
msgid ""
"An :exc:`AddressValueError` is raised if *address* is not a valid IPv4 "
"address.  A :exc:`NetmaskValueError` is raised if the mask is not valid for "
"an IPv4 address."
msgstr ""

#: library/ipaddress.rst:683
msgid ""
"If *strict* is ``True`` and host bits are set in the supplied address, then :"
"exc:`ValueError` is raised.  Otherwise, the host bits are masked out to "
"determine the appropriate network address."
msgstr ""

#: library/ipaddress.rst:467
msgid ""
"Unless stated otherwise, all network methods accepting other network/address "
"objects will raise :exc:`TypeError` if the argument's IP version is "
"incompatible to ``self``."
msgstr ""

#: library/ipaddress.rst:689
msgid "Added the two-tuple form for the *address* constructor parameter."
msgstr ""

#: library/ipaddress.rst:478
msgid ""
"Refer to the corresponding attribute documentation in :class:`IPv4Address`."
msgstr ""

#: library/ipaddress.rst:488
msgid ""
"These attributes are true for the network as a whole if they are true for "
"both the network address and the broadcast address."
msgstr ""

#: library/ipaddress.rst:493
msgid ""
"The network address for the network. The network address and the prefix "
"length together uniquely define a network."
msgstr ""

#: library/ipaddress.rst:498
msgid ""
"The broadcast address for the network. Packets sent to the broadcast address "
"should be received by every host on the network."
msgstr ""

#: library/ipaddress.rst:503
msgid "The host mask, as an :class:`IPv4Address` object."
msgstr ""

#: library/ipaddress.rst:507
msgid "The net mask, as an :class:`IPv4Address` object."
msgstr ""

#: library/ipaddress.rst:513
msgid ""
"A string representation of the network, with the mask in prefix notation."
msgstr ""

#: library/ipaddress.rst:516
msgid ""
"``with_prefixlen`` and ``compressed`` are always the same as "
"``str(network)``. ``exploded`` uses the exploded form the network address."
msgstr ""

#: library/ipaddress.rst:522
msgid ""
"A string representation of the network, with the mask in net mask notation."
msgstr ""

#: library/ipaddress.rst:527
msgid ""
"A string representation of the network, with the mask in host mask notation."
msgstr ""

#: library/ipaddress.rst:532
msgid "The total number of addresses in the network."
msgstr ""

#: library/ipaddress.rst:536
msgid "Length of the network prefix, in bits."
msgstr ""

#: library/ipaddress.rst:540
msgid ""
"Returns an iterator over the usable hosts in the network.  The usable hosts "
"are all the IP addresses that belong to the network, except the network "
"address itself and the network broadcast address.  For networks with a mask "
"length of 31, the network address and network broadcast address are also "
"included in the result. Networks with a mask of 32 will return a list "
"containing the single host address."
msgstr ""

#: library/ipaddress.rst:558
msgid ""
"``True`` if this network is partly or wholly contained in *other* or *other* "
"is wholly contained in this network."
msgstr ""

#: library/ipaddress.rst:563
msgid ""
"Computes the network definitions resulting from removing the given *network* "
"from this one.  Returns an iterator of network objects. Raises :exc:"
"`ValueError` if *network* is not completely contained in this network."
msgstr ""

#: library/ipaddress.rst:576
msgid ""
"The subnets that join to make the current network definition, depending on "
"the argument values.  *prefixlen_diff* is the amount our prefix length "
"should be increased by.  *new_prefix* is the desired new prefix of the "
"subnets; it must be larger than our prefix.  One and only one of "
"*prefixlen_diff* and *new_prefix* must be set.  Returns an iterator of "
"network objects."
msgstr ""

#: library/ipaddress.rst:601
msgid ""
"The supernet containing this network definition, depending on the argument "
"values.  *prefixlen_diff* is the amount our prefix length should be "
"decreased by.  *new_prefix* is the desired new prefix of the supernet; it "
"must be smaller than our prefix.  One and only one of *prefixlen_diff* and "
"*new_prefix* must be set.  Returns a single network object."
msgstr ""

#: library/ipaddress.rst:617
msgid "Return ``True`` if this network is a subnet of *other*."
msgstr ""

#: library/ipaddress.rst:628
msgid "Return ``True`` if this network is a supernet of *other*."
msgstr ""

#: library/ipaddress.rst:639
msgid ""
"Compare this network to *other*.  In this comparison only the network "
"addresses are considered; host bits aren't.  Returns either ``-1``, ``0`` or "
"``1``."
msgstr ""

#: library/ipaddress.rst:650
msgid ""
"It uses the same ordering and comparison algorithm as \"<\", \"==\", and \">"
"\""
msgstr ""

#: library/ipaddress.rst:656
msgid ""
"Construct an IPv6 network definition.  *address* can be one of the following:"
msgstr ""

#: library/ipaddress.rst:658
msgid ""
"A string consisting of an IP address and an optional prefix length, "
"separated by a slash (``/``).  The IP address is the network address, and "
"the prefix length must be a single number, the *prefix*.  If no prefix "
"length is provided, it's considered to be ``/128``."
msgstr ""

#: library/ipaddress.rst:663
msgid ""
"Note that currently expanded netmasks are not supported.  That means ``2001:"
"db00::0/24`` is a valid argument while ``2001:db00::0/ffff:ff00::`` not."
msgstr ""

#: library/ipaddress.rst:667
msgid ""
"An integer that fits into 128 bits.  This is equivalent to a single-address "
"network, with the network address being *address* and the mask being "
"``/128``."
msgstr ""

#: library/ipaddress.rst:671
msgid ""
"An integer packed into a :class:`bytes` object of length 16, big-endian. The "
"interpretation is similar to an integer *address*."
msgstr ""

#: library/ipaddress.rst:674
msgid ""
"A two-tuple of an address description and a netmask, where the address "
"description is either a string, a 128-bits integer, a 16-bytes packed "
"integer, or an existing IPv6Address object; and the netmask is an integer "
"representing the prefix length."
msgstr ""

#: library/ipaddress.rst:679
msgid ""
"An :exc:`AddressValueError` is raised if *address* is not a valid IPv6 "
"address.  A :exc:`NetmaskValueError` is raised if the mask is not valid for "
"an IPv6 address."
msgstr ""

#: library/ipaddress.rst:712
msgid ""
"Returns an iterator over the usable hosts in the network.  The usable hosts "
"are all the IP addresses that belong to the network, except the Subnet-"
"Router anycast address.  For networks with a mask length of 127, the Subnet-"
"Router anycast address is also included in the result. Networks with a mask "
"of 128 will return a list containing the single host address."
msgstr ""

#: library/ipaddress.rst:727
msgid ""
"Refer to the corresponding attribute documentation in :class:`IPv4Network`."
msgstr ""

#: library/ipaddress.rst:732
msgid ""
"These attribute is true for the network as a whole if it is true for both "
"the network address and the broadcast address."
msgstr ""

#: library/ipaddress.rst:739
msgid ""
"Network objects support some operators.  Unless stated otherwise, operators "
"can only be applied between compatible objects (i.e. IPv4 with IPv4, IPv6 "
"with IPv6)."
msgstr ""

#: library/ipaddress.rst:881
msgid "Logical operators"
msgstr ""

#: library/ipaddress.rst:747
msgid ""
"Network objects can be compared with the usual set of logical operators. "
"Network objects are ordered first by network address, then by net mask."
msgstr ""

#: library/ipaddress.rst:752
msgid "Iteration"
msgstr "Itération"

#: library/ipaddress.rst:754
msgid ""
"Network objects can be iterated to list all the addresses belonging to the "
"network.  For iteration, *all* hosts are returned, including unusable hosts "
"(for usable hosts, use the :meth:`~IPv4Network.hosts` method).  An example::"
msgstr ""

#: library/ipaddress.rst:781
msgid "Networks as containers of addresses"
msgstr ""

#: library/ipaddress.rst:783
msgid "Network objects can act as containers of addresses.  Some examples::"
msgstr ""

#: library/ipaddress.rst:796
msgid "Interface objects"
msgstr ""

#: library/ipaddress.rst:798
msgid ""
"Interface objects are :term:`hashable`, so they can be used as keys in "
"dictionaries."
msgstr ""

#: library/ipaddress.rst:803
msgid ""
"Construct an IPv4 interface.  The meaning of *address* is as in the "
"constructor of :class:`IPv4Network`, except that arbitrary host addresses "
"are always accepted."
msgstr ""

#: library/ipaddress.rst:807
msgid ""
":class:`IPv4Interface` is a subclass of :class:`IPv4Address`, so it inherits "
"all the attributes from that class.  In addition, the following attributes "
"are available:"
msgstr ""

#: library/ipaddress.rst:813
msgid "The address (:class:`IPv4Address`) without network information."
msgstr ""

#: library/ipaddress.rst:821
msgid "The network (:class:`IPv4Network`) this interface belongs to."
msgstr ""

#: library/ipaddress.rst:829
msgid ""
"A string representation of the interface with the mask in prefix notation."
msgstr ""

#: library/ipaddress.rst:837
msgid ""
"A string representation of the interface with the network as a net mask."
msgstr ""

#: library/ipaddress.rst:845
msgid ""
"A string representation of the interface with the network as a host mask."
msgstr ""

#: library/ipaddress.rst:854
msgid ""
"Construct an IPv6 interface.  The meaning of *address* is as in the "
"constructor of :class:`IPv6Network`, except that arbitrary host addresses "
"are always accepted."
msgstr ""

#: library/ipaddress.rst:858
msgid ""
":class:`IPv6Interface` is a subclass of :class:`IPv6Address`, so it inherits "
"all the attributes from that class.  In addition, the following attributes "
"are available:"
msgstr ""

#: library/ipaddress.rst:868
msgid ""
"Refer to the corresponding attribute documentation in :class:`IPv4Interface`."
msgstr ""

#: library/ipaddress.rst:875
msgid ""
"Interface objects support some operators.  Unless stated otherwise, "
"operators can only be applied between compatible objects (i.e. IPv4 with "
"IPv4, IPv6 with IPv6)."
msgstr ""

#: library/ipaddress.rst:883
msgid ""
"Interface objects can be compared with the usual set of logical operators."
msgstr ""

#: library/ipaddress.rst:885
msgid ""
"For equality comparison (``==`` and ``!=``), both the IP address and network "
"must be the same for the objects to be equal.  An interface will not compare "
"equal to any address or network object."
msgstr ""

#: library/ipaddress.rst:889
msgid ""
"For ordering (``<``, ``>``, etc) the rules are different.  Interface and "
"address objects with the same IP version can be compared, and the address "
"objects will always sort before the interface objects.  Two interface "
"objects are first compared by their networks and, if those are the same, "
"then by their IP addresses."
msgstr ""

#: library/ipaddress.rst:897
msgid "Other Module Level Functions"
msgstr ""

#: library/ipaddress.rst:899
msgid "The module also provides the following module level functions:"
msgstr ""

#: library/ipaddress.rst:903
msgid ""
"Represent an address as 4 packed bytes in network (big-endian) order. "
"*address* is an integer representation of an IPv4 IP address.  A :exc:"
"`ValueError` is raised if the integer is negative or too large to be an IPv4 "
"IP address."
msgstr ""

#: library/ipaddress.rst:916
msgid ""
"Represent an address as 16 packed bytes in network (big-endian) order. "
"*address* is an integer representation of an IPv6 IP address.  A :exc:"
"`ValueError` is raised if the integer is negative or too large to be an IPv6 "
"IP address."
msgstr ""

#: library/ipaddress.rst:924
msgid ""
"Return an iterator of the summarized network range given the first and last "
"IP addresses.  *first* is the first :class:`IPv4Address` or :class:"
"`IPv6Address` in the range and *last* is the last :class:`IPv4Address` or :"
"class:`IPv6Address` in the range.  A :exc:`TypeError` is raised if *first* "
"or *last* are not IP addresses or are not of the same version.  A :exc:"
"`ValueError` is raised if *last* is not greater than *first* or if *first* "
"address version is not 4 or 6."
msgstr ""

#: library/ipaddress.rst:940
msgid ""
"Return an iterator of the collapsed :class:`IPv4Network` or :class:"
"`IPv6Network` objects.  *addresses* is an iterator of :class:`IPv4Network` "
"or :class:`IPv6Network` objects.  A :exc:`TypeError` is raised if "
"*addresses* contains mixed version objects."
msgstr ""

#: library/ipaddress.rst:953
msgid ""
"Return a key suitable for sorting between networks and addresses.  Address "
"and Network objects are not sortable by default; they're fundamentally "
"different, so the expression::"
msgstr ""

#: library/ipaddress.rst:959
msgid ""
"doesn't make sense.  There are some times however, where you may wish to "
"have :mod:`ipaddress` sort these anyway.  If you need to do this, you can "
"use this function as the *key* argument to :func:`sorted()`."
msgstr ""

#: library/ipaddress.rst:963
msgid "*obj* is either a network or address object."
msgstr ""

#: library/ipaddress.rst:967
msgid "Custom Exceptions"
msgstr ""

#: library/ipaddress.rst:969
msgid ""
"To support more specific error reporting from class constructors, the module "
"defines the following exceptions:"
msgstr ""

#: library/ipaddress.rst:974
msgid "Any value error related to the address."
msgstr ""

#: library/ipaddress.rst:979
msgid "Any value error related to the net mask."
msgstr ""