GeezerVisonThe World Wide Web, restored to 800 pixels of glory. |
| Home|About|Gaming cabinet|Archives|How it works|Starter sites |
GeezerVison is showing github.com — python-docs-ja/library/compression.zstd.po at 3.12 · python/python-docs-ja Expand file tree/ Copy pathcompression.zstd.poMore file actions 1080 lines (920 loc) · 37.8 KB / Copy pathcompression.zstd.poFile metadata and controls1080 lines (920 loc) · 37.8 KB 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 # SOME DESCRIPTIVE TITLE. # Copyright (C) 2001 Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. # # Translators: # 石井明久, 2025 # tomo, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-05-23 14:20+0000\n" "PO-Revision-Date: 2025-05-23 14:22+0000\n" "Last-Translator: tomo, 2025\n" "Language-Team: Japanese (https://app.transifex.com/python-doc/teams/5390/" "ja/)\n" "Language: ja\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=1; plural=0;\n" #: ../../library/compression.zstd.rst:2 msgid "" ":mod:`!compression.zstd` --- Compression compatible with the Zstandard format" msgstr "" #: ../../library/compression.zstd.rst:10 msgid "**Source code:** :source:`Lib/compression/zstd/__init__.py`" msgstr "" #: ../../library/compression.zstd.rst:14 msgid "" "This module provides classes and functions for compressing and decompressing " "data using the Zstandard (or *zstd*) compression algorithm. The `zstd manual " "<https://facebook.github.io/zstd/doc/api_manual_latest.html>`__ describes " "Zstandard as \"a fast lossless compression algorithm, targeting real-time " "compression scenarios at zlib-level and better compression ratios.\" Also " "included is a file interface that supports reading and writing the contents " "of ``.zst`` files created by the :program:`zstd` utility, as well as raw " "zstd compressed streams." msgstr "" #: ../../library/compression.zstd.rst:23 msgid "The :mod:`!compression.zstd` module contains:" msgstr "" #: ../../library/compression.zstd.rst:25 msgid "" "The :func:`.open` function and :class:`ZstdFile` class for reading and " "writing compressed files." msgstr "" #: ../../library/compression.zstd.rst:27 msgid "" "The :class:`ZstdCompressor` and :class:`ZstdDecompressor` classes for " "incremental (de)compression." msgstr "" #: ../../library/compression.zstd.rst:29 msgid "" "The :func:`compress` and :func:`decompress` functions for one-shot " "(de)compression." msgstr "" "一度に圧縮・展開を行う :func:`compress` および :func:`decompress` 関数。" #: ../../library/compression.zstd.rst:31 msgid "" "The :func:`train_dict` and :func:`finalize_dict` functions and the :class:" "`ZstdDict` class to train and manage Zstandard dictionaries." msgstr "" #: ../../library/compression.zstd.rst:33 msgid "" "The :class:`CompressionParameter`, :class:`DecompressionParameter`, and :" "class:`Strategy` classes for setting advanced (de)compression parameters." msgstr "" #: ../../library/compression.zstd.rst:38 msgid "Exceptions" msgstr "例外" #: ../../library/compression.zstd.rst:42 msgid "" "This exception is raised when an error occurs during compression or " "decompression, or while initializing the (de)compressor state." msgstr "" #: ../../library/compression.zstd.rst:47 msgid "Reading and writing compressed files" msgstr "圧縮ファイルへの読み書き" #: ../../library/compression.zstd.rst:52 msgid "" "Open a Zstandard-compressed file in binary or text mode, returning a :term:" "`file object`." msgstr "" #: ../../library/compression.zstd.rst:55 msgid "" "The *file* argument can be either a file name (given as a :class:`str`, :" "class:`bytes` or :term:`path-like <path-like object>` object), in which case " "the named file is opened, or it can be an existing file object to read from " "or write to." msgstr "" #: ../../library/compression.zstd.rst:60 msgid "" "The mode argument can be either ``'rb'`` for reading (default), ``'wb'`` for " "overwriting, ``'ab'`` for appending, or ``'xb'`` for exclusive creation. " "These can equivalently be given as ``'r'``, ``'w'``, ``'a'``, and ``'x'`` " "respectively. You may also open in text mode with ``'rt'``, ``'wt'``, " "``'at'``, and ``'xt'`` respectively." msgstr "" #: ../../library/compression.zstd.rst:66 ../../library/compression.zstd.rst:110 msgid "" "When reading, the *options* argument can be a dictionary providing advanced " "decompression parameters; see :class:`DecompressionParameter` for detailed " "information about supported parameters. The *zstd_dict* argument is a :class:" "`ZstdDict` instance to be used during decompression. When reading, if the " "*level* argument is not None, a :exc:`!TypeError` will be raised." msgstr "" #: ../../library/compression.zstd.rst:73 msgid "" "When writing, the *options* argument can be a dictionary providing advanced " "decompression parameters; see :class:`CompressionParameter` for detailed " "information about supported parameters. The *level* argument is the " "compression level to use when writing compressed data. Only one of *level* " "or *options* may be non-None. The *zstd_dict* argument is a :class:" "`ZstdDict` instance to be used during compression." msgstr "" #: ../../library/compression.zstd.rst:81 msgid "" "In binary mode, this function is equivalent to the :class:`ZstdFile` " "constructor: ``ZstdFile(file, mode, ...)``. In this case, the *encoding*, " "*errors*, and *newline* parameters must not be provided." msgstr "" #: ../../library/compression.zstd.rst:85 msgid "" "In text mode, a :class:`ZstdFile` object is created, and wrapped in an :" "class:`io.TextIOWrapper` instance with the specified encoding, error " "handling behavior, and line endings." msgstr "" #: ../../library/compression.zstd.rst:93 msgid "Open a Zstandard-compressed file in binary mode." msgstr "" #: ../../library/compression.zstd.rst:95 msgid "" "A :class:`ZstdFile` can wrap an already-open :term:`file object`, or operate " "directly on a named file. The *file* argument specifies either the file " "object to wrap, or the name of the file to open (as a :class:`str`, :class:" "`bytes` or :term:`path-like <path-like object>` object). If wrapping an " "existing file object, the wrapped file will not be closed when the :class:" "`ZstdFile` is closed." msgstr "" #: ../../library/compression.zstd.rst:102 msgid "" "The *mode* argument can be either ``'rb'`` for reading (default), ``'wb'`` " "for overwriting, ``'xb'`` for exclusive creation, or ``'ab'`` for appending. " "These can equivalently be given as ``'r'``, ``'w'``, ``'x'`` and ``'a'`` " "respectively." msgstr "" #: ../../library/compression.zstd.rst:107 msgid "" "If *file* is a file object (rather than an actual file name), a mode of " "``'w'`` does not truncate the file, and is instead equivalent to ``'a'``." msgstr "" #: ../../library/compression.zstd.rst:117 msgid "" "When writing, the *options* argument can be a dictionary providing advanced " "decompression parameters; see :class:`CompressionParameter` for detailed " "information about supported parameters. The *level* argument is the " "compression level to use when writing compressed data. Only one of *level* " "or *options* may be passed. The *zstd_dict* argument is a :class:`ZstdDict` " "instance to be used during compression." msgstr "" #: ../../library/compression.zstd.rst:125 msgid "" ":class:`!ZstdFile` supports all the members specified by :class:`io." "BufferedIOBase`, except for :meth:`~io.BufferedIOBase.detach` and :meth:`~io." "IOBase.truncate`. Iteration and the :keyword:`with` statement are supported." msgstr "" #: ../../library/compression.zstd.rst:130 msgid "The following method and attributes are also provided:" msgstr "以下のメソッドと属性も提供されています:" #: ../../library/compression.zstd.rst:134 msgid "" "Return buffered data without advancing the file position. At least one byte " "of data will be returned, unless EOF has been reached. The exact number of " "bytes returned is unspecified (the *size* argument is ignored)." msgstr "" "ファイル上の現在位置を変更せずにバッファのデータを返します。EOF に達しない限" "り、少なくとも 1 バイトが返されます。返される正確なバイト数は規定されていませ" "ん (引数 *size* は無視されます)。" #: ../../library/compression.zstd.rst:138 msgid "" "While calling :meth:`peek` does not change the file position of the :class:" "`ZstdFile`, it may change the position of the underlying file object (for " "example, if the :class:`ZstdFile` was constructed by passing a file object " "for *file*)." msgstr "" #: ../../library/compression.zstd.rst:145 msgid "``'rb'`` for reading and ``'wb'`` for writing." msgstr "``'rb'`` は読み込み用、 ``'wb'`` は書き込み用です。" #: ../../library/compression.zstd.rst:149 msgid "" "The name of the Zstandard file. Equivalent to the :attr:`~io.FileIO.name` " "attribute of the underlying :term:`file object`." msgstr "" #: ../../library/compression.zstd.rst:154 msgid "Compressing and decompressing data in memory" msgstr "メモリ上での圧縮と展開" #: ../../library/compression.zstd.rst:158 msgid "" "Compress *data* (a :term:`bytes-like object`), returning the compressed data " "as a :class:`bytes` object." msgstr "" #: ../../library/compression.zstd.rst:161 #: ../../library/compression.zstd.rst:205 msgid "" "The *level* argument is an integer controlling the level of compression. " "*level* is an alternative to setting :attr:`CompressionParameter." "compression_level` in *options*. Use :meth:`~CompressionParameter.bounds` " "on :attr:`~CompressionParameter.compression_level` to get the values that " "can be passed for *level*. If advanced compression options are needed, the " "*level* argument must be omitted and in the *options* dictionary the :attr:`!" "CompressionParameter.compression_level` parameter should be set." msgstr "" #: ../../library/compression.zstd.rst:170 #: ../../library/compression.zstd.rst:214 msgid "" "The *options* argument is a Python dictionary containing advanced " "compression parameters. The valid keys and values for compression parameters " "are documented as part of the :class:`CompressionParameter` documentation." msgstr "" #: ../../library/compression.zstd.rst:174 msgid "" "The *zstd_dict* argument is an instance of :class:`ZstdDict` containing " "trained data to improve compression efficiency. The function :func:" "`train_dict` can be used to generate a Zstandard dictionary." msgstr "" #: ../../library/compression.zstd.rst:181 msgid "" "Decompress *data* (a :term:`bytes-like object`), returning the uncompressed " "data as a :class:`bytes` object." msgstr "" #: ../../library/compression.zstd.rst:184 #: ../../library/compression.zstd.rst:278 msgid "" "The *options* argument is a Python dictionary containing advanced " "decompression parameters. The valid keys and values for compression " "parameters are documented as part of the :class:`DecompressionParameter` " "documentation." msgstr "" #: ../../library/compression.zstd.rst:189 #: ../../library/compression.zstd.rst:283 msgid "" "The *zstd_dict* argument is an instance of :class:`ZstdDict` containing " "trained data used during compression. This must be the same Zstandard " "dictionary used during compression." msgstr "" #: ../../library/compression.zstd.rst:193 msgid "" "If *data* is the concatenation of multiple distinct compressed frames, " "decompress all of these frames, and return the concatenation of the results." msgstr "" #: ../../library/compression.zstd.rst:199 msgid "" "Create a compressor object, which can be used to compress data incrementally." msgstr "データをインクリメンタルに圧縮する圧縮オブジェクトを作成します。" #: ../../library/compression.zstd.rst:202 msgid "" "For a more convenient way of compressing a single chunk of data, see the " "module-level function :func:`compress`." msgstr "" #: ../../library/compression.zstd.rst:218 msgid "" "The *zstd_dict* argument is an optional instance of :class:`ZstdDict` " "containing trained data to improve compression efficiency. The function :" "func:`train_dict` can be used to generate a Zstandard dictionary." msgstr "" #: ../../library/compression.zstd.rst:225 msgid "" "Compress *data* (a :term:`bytes-like object`), returning a :class:`bytes` " "object with compressed data if possible, or otherwise an empty :class:`!" "bytes` object. Some of *data* may be buffered internally, for use in later " "calls to :meth:`!compress` and :meth:`~.flush`. The returned data should be " "concatenated with the output of any previous calls to :meth:`~.compress`." msgstr "" #: ../../library/compression.zstd.rst:232 msgid "" "The *mode* argument is a :class:`ZstdCompressor` attribute, either :attr:`~." "CONTINUE`, :attr:`~.FLUSH_BLOCK`, or :attr:`~.FLUSH_FRAME`." msgstr "" #: ../../library/compression.zstd.rst:236 msgid "" "When all data has been provided to the compressor, call the :meth:`~.flush` " "method to finish the compression process. If :meth:`~.compress` is called " "with *mode* set to :attr:`~.FLUSH_FRAME`, :meth:`~.flush` should not be " "called, as it would write out a new empty frame." msgstr "" #: ../../library/compression.zstd.rst:244 msgid "" "Finish the compression process, returning a :class:`bytes` object containing " "any data stored in the compressor's internal buffers." msgstr "" "圧縮処理を終了し、コンプレッサの内部バッファにあるあらゆるデータを格納する :" "class:`bytes` オブジェクトを返します。" #: ../../library/compression.zstd.rst:247 msgid "" "The *mode* argument is a :class:`ZstdCompressor` attribute, either :attr:`~." "FLUSH_BLOCK`, or :attr:`~.FLUSH_FRAME`." msgstr "" #: ../../library/compression.zstd.rst:252 msgid "" "Collect more data for compression, which may or may not generate output " "immediately. This mode optimizes the compression ratio by maximizing the " "amount of data per block and frame." msgstr "" #: ../../library/compression.zstd.rst:258 msgid "" "Complete and write a block to the data stream. The data returned so far can " "be immediately decompressed. Past data can still be referenced in future " "blocks generated by calls to :meth:`~.compress`, improving compression." msgstr "" #: ../../library/compression.zstd.rst:265 msgid "" "Complete and write out a frame. Future data provided to :meth:`~.compress` " "will be written into a new frame and *cannot* reference past data." msgstr "" #: ../../library/compression.zstd.rst:272 msgid "" "Create a decompressor object, which can be used to decompress data " "incrementally." msgstr "" "データをインクリメンタルに展開するために使用できる展開オブジェクトを作成しま" "す。" #: ../../library/compression.zstd.rst:275 msgid "" "For a more convenient way of decompressing an entire compressed stream at " "once, see the module-level function :func:`decompress`." msgstr "" #: ../../library/compression.zstd.rst:288 msgid "" "This class does not transparently handle inputs containing multiple " "compressed frames, unlike the :func:`decompress` function and :class:" "`ZstdFile` class. To decompress a multi-frame input, you should use :func:" "`decompress`, :class:`ZstdFile` if working with a :term:`file object`, or " "multiple :class:`!ZstdDecompressor` instances." msgstr "" #: ../../library/compression.zstd.rst:296 msgid "" "Decompress *data* (a :term:`bytes-like object`), returning uncompressed data " "as bytes. Some of *data* may be buffered internally, for use in later calls " "to :meth:`!decompress`. The returned data should be concatenated with the " "output of any previous calls to :meth:`!decompress`." msgstr "" #: ../../library/compression.zstd.rst:302 msgid "" "If *max_length* is non-negative, the method returns at most *max_length* " "bytes of decompressed data. If this limit is reached and further output can " "be produced, the :attr:`~.needs_input` attribute will be set to ``False``. " "In this case, the next call to :meth:`~.decompress` may provide *data* as " "``b''`` to obtain more of the output." msgstr "" #: ../../library/compression.zstd.rst:309 msgid "" "If all of the input data was decompressed and returned (either because this " "was less than *max_length* bytes, or because *max_length* was negative), " "the :attr:`~.needs_input` attribute will be set to ``True``." msgstr "" "入力データの全てが圧縮され返された (*max_length* バイトより少ないためか " "*max_length* が負のため) 場合、\n" ":attr:`~.needs_input` 属性は ``True`` になります。" #: ../../library/compression.zstd.rst:314 msgid "" "Attempting to decompress data after the end of a frame will raise a :exc:" "`ZstdError`. Any data found after the end of the frame is ignored and saved " "in the :attr:`~.unused_data` attribute." msgstr "" #: ../../library/compression.zstd.rst:320 msgid "``True`` if the end-of-stream marker has been reached." msgstr "ストリーム終端記号に到達した場合 ``True`` を返します。" #: ../../library/compression.zstd.rst:324 msgid "Data found after the end of the compressed stream." msgstr "圧縮ストリームの末尾以降に存在したデータを表します。" #: ../../library/compression.zstd.rst:326 msgid "Before the end of the stream is reached, this will be ``b''``." msgstr "" #: ../../library/compression.zstd.rst:330 msgid "" "``False`` if the :meth:`.decompress` method can provide more decompressed " "data before requiring new compressed input." msgstr "" #: ../../library/compression.zstd.rst:335 msgid "Zstandard dictionaries" msgstr "" #: ../../library/compression.zstd.rst:340 msgid "" "Train a Zstandard dictionary, returning a :class:`ZstdDict` instance. " "Zstandard dictionaries enable more efficient compression of smaller sizes of " "data, which is traditionally difficult to compress due to less repetition. " "If you are compressing multiple similar groups of data (such as similar " "files), Zstandard dictionaries can improve compression ratios and speed " "significantly." msgstr "" #: ../../library/compression.zstd.rst:347 msgid "" "The *samples* argument (an iterable of :class:`bytes` objects), is the " "population of samples used to train the Zstandard dictionary." msgstr "" #: ../../library/compression.zstd.rst:350 msgid "" "The *dict_size* argument, an integer, is the maximum size (in bytes) the " "Zstandard dictionary should be. The Zstandard documentation suggests an " "absolute maximum of no more than 100 KB, but the maximum can often be " "smaller depending on the data. Larger dictionaries generally slow down " "compression, but improve compression ratios. Smaller dictionaries lead to " "faster compression, but reduce the compression ratio." msgstr "" #: ../../library/compression.zstd.rst:360 msgid "" "An advanced function for converting a \"raw content\" Zstandard dictionary " "into a regular Zstandard dictionary. \"Raw content\" dictionaries are a " "sequence of bytes that do not need to follow the structure of a normal " "Zstandard dictionary." msgstr "" #: ../../library/compression.zstd.rst:365 msgid "" "The *zstd_dict* argument is a :class:`ZstdDict` instance with the :attr:" "`~ZstdDict.dict_content` containing the raw dictionary contents." msgstr "" #: ../../library/compression.zstd.rst:368 msgid "" "The *samples* argument (an iterable of :class:`bytes` objects), contains " "sample data for generating the Zstandard dictionary." msgstr "" #: ../../library/compression.zstd.rst:371 msgid "" "The *dict_size* argument, an integer, is the maximum size (in bytes) the " "Zstandard dictionary should be. See :func:`train_dict` for suggestions on " "the maximum dictionary size." msgstr "" #: ../../library/compression.zstd.rst:375 msgid "" "The *level* argument (an integer) is the compression level expected to be " "passed to the compressors using this dictionary. The dictionary information " "varies for each compression level, so tuning for the proper compression " "level can make compression more efficient." msgstr "" #: ../../library/compression.zstd.rst:383 msgid "" "A wrapper around Zstandard dictionaries. Dictionaries can be used to improve " "the compression of many small chunks of data. Use :func:`train_dict` if you " "need to train a new dictionary from sample data." msgstr "" #: ../../library/compression.zstd.rst:387 msgid "" "The *dict_content* argument (a :term:`bytes-like object`), is the already " "trained dictionary information." msgstr "" #: ../../library/compression.zstd.rst:390 msgid "" "The *is_raw* argument, a boolean, is an advanced parameter controlling the " "meaning of *dict_content*. ``True`` means *dict_content* is a \"raw " "content\" dictionary, without any format restrictions. ``False`` means " "*dict_content* is an ordinary Zstandard dictionary, created from Zstandard " "functions, for example, :func:`train_dict` or the external :program:`zstd` " "CLI." msgstr "" #: ../../library/compression.zstd.rst:396 msgid "" "When passing a :class:`!ZstdDict` to a function, the :attr:`!" "as_digested_dict` and :attr:`!as_undigested_dict` attributes can control how " "the dictionary is loaded by passing them as the ``zstd_dict`` argument, for " "example, ``compress(data, zstd_dict=zd.as_digested_dict)``. Digesting a " "dictionary is a costly operation that occurs when loading a Zstandard " "dictionary. When making multiple calls to compression or decompression, " "passing a digested dictionary will reduce the overhead of loading the " "dictionary." msgstr "" #: ../../library/compression.zstd.rst:405 msgid "Difference for compression" msgstr "" #: ../../library/compression.zstd.rst:410 msgid "Digested dictionary" msgstr "" #: ../../library/compression.zstd.rst:411 msgid "Undigested dictionary" msgstr "" #: ../../library/compression.zstd.rst:412 msgid "" "Advanced parameters of the compressor which may be overridden by the " "dictionary's parameters" msgstr "" #: ../../library/compression.zstd.rst:414 msgid "" "``window_log``, ``hash_log``, ``chain_log``, ``search_log``, ``min_match``, " "``target_length``, ``strategy``, ``enable_long_distance_matching``, " "``ldm_hash_log``, ``ldm_min_match``, ``ldm_bucket_size_log``, " "``ldm_hash_rate_log``, and some non-public parameters." msgstr "" #: ../../library/compression.zstd.rst:419 msgid "None" msgstr "None" #: ../../library/compression.zstd.rst:420 msgid ":class:`!ZstdDict` internally caches the dictionary" msgstr "" #: ../../library/compression.zstd.rst:421 msgid "" "Yes. It's faster when loading a digested dictionary again with the same " "compression level." msgstr "" #: ../../library/compression.zstd.rst:423 msgid "" "No. If you wish to load an undigested dictionary multiple times, consider " "reusing a compressor object." msgstr "" #: ../../library/compression.zstd.rst:426 msgid "" "If passing a :class:`!ZstdDict` without any attribute, an undigested " "dictionary is passed by default when compressing and a digested dictionary " "is generated if necessary and passed by default when decompressing." msgstr "" #: ../../library/compression.zstd.rst:432 msgid "" "The content of the Zstandard dictionary, a ``bytes`` object. It's the same " "as the *dict_content* argument in the ``__init__`` method. It can be used " "with other programs, such as the ``zstd`` CLI program." msgstr "" #: ../../library/compression.zstd.rst:438 msgid "Identifier of the Zstandard dictionary, a non-negative int value." msgstr "" #: ../../library/compression.zstd.rst:440 msgid "" "Non-zero means the dictionary is ordinary, created by Zstandard functions " "and following the Zstandard format." msgstr "" #: ../../library/compression.zstd.rst:443 msgid "" "``0`` means a \"raw content\" dictionary, free of any format restriction, " "used for advanced users." msgstr "" #: ../../library/compression.zstd.rst:448 msgid "" "The meaning of ``0`` for :attr:`!ZstdDict.dict_id` is different from the " "``dictionary_id`` attribute to the :func:`get_frame_info` function." msgstr "" #: ../../library/compression.zstd.rst:454 msgid "Load as a digested dictionary." msgstr "" #: ../../library/compression.zstd.rst:458 msgid "Load as an undigested dictionary." msgstr "" #: ../../library/compression.zstd.rst:462 msgid "Advanced parameter control" msgstr "" #: ../../library/compression.zstd.rst:466 msgid "" "An :class:`~enum.IntEnum` containing the advanced compression parameter keys " "that can be used when compressing data." msgstr "" #: ../../library/compression.zstd.rst:469 #: ../../library/compression.zstd.rst:674 msgid "" "The :meth:`~.bounds` method can be used on any attribute to get the valid " "values for that parameter." msgstr "" #: ../../library/compression.zstd.rst:472 msgid "" "Parameters are optional; any omitted parameter will have it's value selected " "automatically." msgstr "" #: ../../library/compression.zstd.rst:475 msgid "" "Example getting the lower and upper bound of :attr:`~.compression_level`::" msgstr "" #: ../../library/compression.zstd.rst:477 msgid "lower, upper = CompressionParameter.compression_level.bounds()" msgstr "" #: ../../library/compression.zstd.rst:479 msgid "Example setting the :attr:`~.window_log` to the maximum size::" msgstr "" #: ../../library/compression.zstd.rst:481 msgid "" "_lower, upper = CompressionParameter.window_log.bounds()\n" "options = {CompressionParameter.window_log: upper}\n" "compress(b'venezuelan beaver cheese', options=options)" msgstr "" #: ../../library/compression.zstd.rst:487 msgid "" "Return the tuple of int bounds, ``(lower, upper)``, of a compression " "parameter. This method should be called on the attribute you wish to " "retrieve the bounds of. For example, to get the valid values for :attr:`~." "compression_level`, one may check the result of ``CompressionParameter." "compression_level.bounds()``." msgstr "" #: ../../library/compression.zstd.rst:493 #: ../../library/compression.zstd.rst:692 msgid "Both the lower and upper bounds are inclusive." msgstr "" #: ../../library/compression.zstd.rst:497 msgid "" "A high-level means of setting other compression parameters that affect the " "speed and ratio of compressing data. Setting the level to zero uses :attr:" "`COMPRESSION_LEVEL_DEFAULT`." msgstr "" #: ../../library/compression.zstd.rst:503 msgid "" "Maximum allowed back-reference distance the compressor can use when " "compressing data, expressed as power of two, ``1 << window_log`` bytes. This " "parameter greatly influences the memory usage of compression. Higher values " "require more memory but gain better compression values." msgstr "" #: ../../library/compression.zstd.rst:508 #: ../../library/compression.zstd.rst:517 #: ../../library/compression.zstd.rst:528 #: ../../library/compression.zstd.rst:536 #: ../../library/compression.zstd.rst:547 #: ../../library/compression.zstd.rst:562 #: ../../library/compression.zstd.rst:593 #: ../../library/compression.zstd.rst:600 #: ../../library/compression.zstd.rst:608 #: ../../library/compression.zstd.rst:616 #: ../../library/compression.zstd.rst:652 #: ../../library/compression.zstd.rst:701 msgid "A value of zero causes the value to be selected automatically." msgstr "" #: ../../library/compression.zstd.rst:512 msgid "" "Size of the initial probe table, as a power of two. The resulting memory " "usage is ``1 << (hash_log+2)`` bytes. Larger tables improve compression " "ratio of strategies <= :attr:`~Strategy.dfast`, and improve compression " "speed of strategies > :attr:`~Strategy.dfast`." msgstr "" #: ../../library/compression.zstd.rst:521 msgid "" "Size of the multi-probe search table, as a power of two. The resulting " "memory usage is ``1 << (chain_log+2)`` bytes. Larger tables result in better " "and slower compression. This parameter has no effect for the :attr:" "`~Strategy.fast` strategy. It's still useful when using :attr:`~Strategy." "dfast` strategy, in which case it defines a secondary probe table." msgstr "" #: ../../library/compression.zstd.rst:532 msgid "" "Number of search attempts, as a power of two. More attempts result in better " "and slower compression. This parameter is useless for :attr:`~Strategy.fast` " "and :attr:`~Strategy.dfast` strategies." msgstr "" #: ../../library/compression.zstd.rst:540 msgid "" "Minimum size of searched matches. Larger values increase compression and " "decompression speed, but decrease ratio. Note that Zstandard can still find " "matches of smaller size, it just tweaks its search algorithm to look for " "this size and larger. For all strategies < :attr:`~Strategy.btopt`, the " "effective minimum is ``4``; for all strategies > :attr:`~Strategy.fast`, the " "effective maximum is ``6``." msgstr "" #: ../../library/compression.zstd.rst:551 msgid "The impact of this field depends on the selected :class:`Strategy`." msgstr "" #: ../../library/compression.zstd.rst:553 msgid "" "For strategies :attr:`~Strategy.btopt`, :attr:`~Strategy.btultra` and :attr:" "`~Strategy.btultra2`, the value is the length of a match considered \"good " "enough\" to stop searching. Larger values make compression ratios better, " "but compresses slower." msgstr "" #: ../../library/compression.zstd.rst:558 msgid "" "For strategy :attr:`~Strategy.fast`, it is the distance between match " "sampling. Larger values make compression faster, but with a worse " "compression ratio." msgstr "" #: ../../library/compression.zstd.rst:566 msgid "" "The higher the value of selected strategy, the more complex the compression " "technique used by zstd, resulting in higher compression ratios but slower " "compression." msgstr "" #: ../../library/compression.zstd.rst:570 msgid ":class:`Strategy`" msgstr "" #: ../../library/compression.zstd.rst:574 msgid "" "Long distance matching can be used to improve compression for large inputs " "by finding large matches at greater distances. It increases memory usage and " "window size." msgstr "" #: ../../library/compression.zstd.rst:578 msgid "" "``True`` or ``1`` enable long distance matching while ``False`` or ``0`` " "disable it." msgstr "" #: ../../library/compression.zstd.rst:581 msgid "" "Enabling this parameter increases default :attr:`~CompressionParameter." "window_log` to 128 MiB except when expressly set to a different value. This " "setting is enabled by default if :attr:`!window_log` >= 128 MiB and the " "compression strategy >= :attr:`~Strategy.btopt` (compression level 16+)." msgstr "" #: ../../library/compression.zstd.rst:589 msgid "" "Size of the table for long distance matching, as a power of two. Larger " "values increase memory usage and compression ratio, but decrease compression " "speed." msgstr "" #: ../../library/compression.zstd.rst:597 msgid "" "Minimum match size for long distance matcher. Larger or too small values can " "often decrease the compression ratio." msgstr "" #: ../../library/compression.zstd.rst:604 msgid "" "Log size of each bucket in the long distance matcher hash table for " "collision resolution. Larger values improve collision resolution but " "decrease compression speed." msgstr "" #: ../../library/compression.zstd.rst:612 msgid "" "Frequency of inserting/looking up entries into the long distance matcher " "hash table. Larger values improve compression speed. Deviating far from the " "default value will likely result in a compression ratio decrease." msgstr "" #: ../../library/compression.zstd.rst:620 msgid "" "A four-byte checksum using XXHash64 of the uncompressed content is written " "at the end of each frame. Zstandard's decompression code verifies the " "checksum. If there is a mismatch a :class:`ZstdError` exception is raised." msgstr "" #: ../../library/compression.zstd.rst:625 msgid "" "``True`` or ``1`` enable checksum generation while ``False`` or ``0`` " "disable it." msgstr "" #: ../../library/compression.zstd.rst:630 msgid "" "When compressing with a :class:`ZstdDict`, the dictionary's ID is written " "into the frame header." msgstr "" #: ../../library/compression.zstd.rst:633 msgid "" "``True`` or ``1`` enable storing the dictionary ID while ``False`` or ``0`` " "disable it." msgstr "" #: ../../library/compression.zstd.rst:638 msgid "" "Select how many threads will be spawned to compress in parallel. When :attr:" "`!nb_workers` > 0, enables multi-threaded compression, a value of ``1`` " "means \"one-thread multi-threaded mode\". More workers improve speed, but " "also increase memory usage and slightly reduce compression ratio." msgstr "" #: ../../library/compression.zstd.rst:643 msgid "A value of zero disables multi-threading." msgstr "" #: ../../library/compression.zstd.rst:647 msgid "" "Size of a compression job, in bytes. This value is enforced only when :attr:" "`~CompressionParameter.nb_workers` >= 1. Each compression job is completed " "in parallel, so this value can indirectly impact the number of active " "threads." msgstr "" #: ../../library/compression.zstd.rst:656 msgid "" "Sets how much data is reloaded from previous jobs (threads) for new jobs to " "be used by the look behind window during compression. This value is only " "used when :attr:`~CompressionParameter.nb_workers` >= 1. Acceptable values " "vary from 0 to 9." msgstr "" #: ../../library/compression.zstd.rst:661 msgid "0 means dynamically set the overlap amount" msgstr "" #: ../../library/compression.zstd.rst:662 msgid "1 means no overlap" msgstr "" #: ../../library/compression.zstd.rst:663 msgid "9 means use a full window size from the previous job" msgstr "" #: ../../library/compression.zstd.rst:665 msgid "" "Each increment halves/doubles the overlap size. \"8\" means an overlap of " "``window_size/2``, \"7\" means an overlap of ``window_size/4``, etc." msgstr "" #: ../../library/compression.zstd.rst:670 msgid "" "An :class:`~enum.IntEnum` containing the advanced decompression parameter " "keys that can be used when decompressing data. Parameters are optional; any " "omitted parameter will have it's value selected automatically." msgstr "" #: ../../library/compression.zstd.rst:677 msgid "Example setting the :attr:`~.window_log_max` to the maximum size::" msgstr "" #: ../../library/compression.zstd.rst:679 msgid "" "data = compress(b'Some very long buffer of bytes...')\n" "\n" "_lower, upper = DecompressionParameter.window_log_max.bounds()\n" "\n" "options = {DecompressionParameter.window_log_max: upper}\n" "decompress(data, options=options)" msgstr "" #: ../../library/compression.zstd.rst:688 msgid "" "Return the tuple of int bounds, ``(lower, upper)``, of a decompression " "parameter. This method should be called on the attribute you wish to " "retrieve the bounds of." msgstr "" #: ../../library/compression.zstd.rst:696 msgid "" "The base-two logarithm of the maximum size of the window used during " "decompression. This can be useful to limit the amount of memory used when " "decompressing data. A larger maximum window size leads to faster " "decompression." msgstr "" #: ../../library/compression.zstd.rst:706 msgid "" "An :class:`~enum.IntEnum` containing strategies for compression. Higher-" "numbered strategies correspond to more complex and slower compression." msgstr "" #: ../../library/compression.zstd.rst:712 msgid "" "The values of attributes of :class:`!Strategy` are not necessarily stable " "across zstd versions. Only the ordering of the attributes may be relied " "upon. The attributes are listed below in order." msgstr "" #: ../../library/compression.zstd.rst:716 msgid "The following strategies are available:" msgstr "" #: ../../library/compression.zstd.rst:738 msgid "Miscellaneous" msgstr "その他" #: ../../library/compression.zstd.rst:742 msgid "" "Retrieve a :class:`FrameInfo` object containing metadata about a Zstandard " "frame. Frames contain metadata related to the compressed data they hold." msgstr "" #: ../../library/compression.zstd.rst:748 msgid "Metadata related to a Zstandard frame." msgstr "" #: ../../library/compression.zstd.rst:752 msgid "The size of the decompressed contents of the frame." msgstr "" #: ../../library/compression.zstd.rst:756 msgid "" "An integer representing the Zstandard dictionary ID needed for decompressing " "the frame. ``0`` means the dictionary ID was not recorded in the frame " "header. This may mean that a Zstandard dictionary is not needed, or that the " "ID of a required dictionary was not recorded." msgstr "" #: ../../library/compression.zstd.rst:764 msgid "The default compression level for Zstandard: ``3``." msgstr "" #: ../../library/compression.zstd.rst:769 msgid "" "Version number of the runtime zstd library as a tuple of integers (major, " "minor, release)." msgstr "" #: ../../library/compression.zstd.rst:774 msgid "Examples" msgstr "使用例" #: ../../library/compression.zstd.rst:776 msgid "Reading in a compressed file:" msgstr "" |
| You are visitor 01402520 — GeezerVison does not store the pages you look up. Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required. |