# 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 \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 \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* " "``/`` 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 ""