{
    "content": [
        {
            "type": "text",
            "text": "# Crypt::Digest::SHA512 (perldoc)\n\n## NAME\n\nCrypt::Digest::SHA512 - Hash function SHA-512 [size: 512 bits]\n\n## SYNOPSIS\n\n### Functional interface:\nuse Crypt::Digest::SHA512 qw( sha512 sha512hex sha512b64 sha512b64u\nsha512file sha512filehex sha512fileb64 sha512fileb64u );\n# calculate digest from string/buffer\n$sha512raw  = sha512('data string');\n$sha512hex  = sha512hex('data string');\n$sha512b64  = sha512b64('data string');\n$sha512b64u = sha512b64u('data string');\n# calculate digest from file\n$sha512raw  = sha512file('filename.dat');\n$sha512hex  = sha512filehex('filename.dat');\n$sha512b64  = sha512fileb64('filename.dat');\n$sha512b64u = sha512fileb64u('filename.dat');\n# calculate digest from filehandle\n$sha512raw  = sha512file(*FILEHANDLE);\n$sha512hex  = sha512filehex(*FILEHANDLE);\n$sha512b64  = sha512fileb64(*FILEHANDLE);\n$sha512b64u = sha512fileb64u(*FILEHANDLE);\n### OO interface:\nuse Crypt::Digest::SHA512;\n$d = Crypt::Digest::SHA512->new;\n$d->add('any data');\n$d->addfile('filename.dat');\n$d->addfile(*FILEHANDLE);\n$resultraw  = $d->digest;     # raw bytes\n$resulthex  = $d->hexdigest;  # hexadecimal form\n$resultb64  = $d->b64digest;  # Base64 form\n$resultb64u = $d->b64udigest; # Base64 URL Safe form\n\n## DESCRIPTION\n\nProvides an interface to the SHA512 digest algorithm.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **EXPORT**\n- **FUNCTIONS**\n- **METHODS**\n- **SEE ALSO**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "Crypt::Digest::SHA512",
        "section": "",
        "mode": "perldoc",
        "summary": "Crypt::Digest::SHA512 - Hash function SHA-512 [size: 512 bits]",
        "synopsis": "### Functional interface:\nuse Crypt::Digest::SHA512 qw( sha512 sha512hex sha512b64 sha512b64u\nsha512file sha512filehex sha512fileb64 sha512fileb64u );\n# calculate digest from string/buffer\n$sha512raw  = sha512('data string');\n$sha512hex  = sha512hex('data string');\n$sha512b64  = sha512b64('data string');\n$sha512b64u = sha512b64u('data string');\n# calculate digest from file\n$sha512raw  = sha512file('filename.dat');\n$sha512hex  = sha512filehex('filename.dat');\n$sha512b64  = sha512fileb64('filename.dat');\n$sha512b64u = sha512fileb64u('filename.dat');\n# calculate digest from filehandle\n$sha512raw  = sha512file(*FILEHANDLE);\n$sha512hex  = sha512filehex(*FILEHANDLE);\n$sha512b64  = sha512fileb64(*FILEHANDLE);\n$sha512b64u = sha512fileb64u(*FILEHANDLE);\n### OO interface:\nuse Crypt::Digest::SHA512;\n$d = Crypt::Digest::SHA512->new;\n$d->add('any data');\n$d->addfile('filename.dat');\n$d->addfile(*FILEHANDLE);\n$resultraw  = $d->digest;     # raw bytes\n$resulthex  = $d->hexdigest;  # hexadecimal form\n$resultb64  = $d->b64digest;  # Base64 form\n$resultb64u = $d->b64udigest; # Base64 URL Safe form",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [],
        "examples": [],
        "see_also": [],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 32,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "EXPORT",
                "lines": 11,
                "subsections": []
            },
            {
                "name": "FUNCTIONS",
                "lines": 67,
                "subsections": []
            },
            {
                "name": "METHODS",
                "lines": 45,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 4,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "Crypt::Digest::SHA512 - Hash function SHA-512 [size: 512 bits]\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "### Functional interface:\nuse Crypt::Digest::SHA512 qw( sha512 sha512hex sha512b64 sha512b64u\nsha512file sha512filehex sha512fileb64 sha512fileb64u );\n\n# calculate digest from string/buffer\n$sha512raw  = sha512('data string');\n$sha512hex  = sha512hex('data string');\n$sha512b64  = sha512b64('data string');\n$sha512b64u = sha512b64u('data string');\n# calculate digest from file\n$sha512raw  = sha512file('filename.dat');\n$sha512hex  = sha512filehex('filename.dat');\n$sha512b64  = sha512fileb64('filename.dat');\n$sha512b64u = sha512fileb64u('filename.dat');\n# calculate digest from filehandle\n$sha512raw  = sha512file(*FILEHANDLE);\n$sha512hex  = sha512filehex(*FILEHANDLE);\n$sha512b64  = sha512fileb64(*FILEHANDLE);\n$sha512b64u = sha512fileb64u(*FILEHANDLE);\n\n### OO interface:\nuse Crypt::Digest::SHA512;\n\n$d = Crypt::Digest::SHA512->new;\n$d->add('any data');\n$d->addfile('filename.dat');\n$d->addfile(*FILEHANDLE);\n$resultraw  = $d->digest;     # raw bytes\n$resulthex  = $d->hexdigest;  # hexadecimal form\n$resultb64  = $d->b64digest;  # Base64 form\n$resultb64u = $d->b64udigest; # Base64 URL Safe form\n",
                "subsections": []
            },
            "DESCRIPTION": {
                "content": "Provides an interface to the SHA512 digest algorithm.\n",
                "subsections": []
            },
            "EXPORT": {
                "content": "Nothing is exported by default.\n\nYou can export selected functions:\n\nuse Crypt::Digest::SHA512 qw(sha512 sha512hex sha512b64 sha512b64u\nsha512file sha512filehex sha512fileb64 sha512fileb64u);\n\nOr all of them at once:\n\nuse Crypt::Digest::SHA512 ':all';\n",
                "subsections": []
            },
            "FUNCTIONS": {
                "content": "sha512\nLogically joins all arguments into a single string, and returns its SHA512 digest encoded as a\nbinary string.\n\n$sha512raw = sha512('data string');\n#or\n$sha512raw = sha512('any data', 'more data', 'even more data');\n\nsha512hex\nLogically joins all arguments into a single string, and returns its SHA512 digest encoded as a\nhexadecimal string.\n\n$sha512hex = sha512hex('data string');\n#or\n$sha512hex = sha512hex('any data', 'more data', 'even more data');\n\nsha512b64\nLogically joins all arguments into a single string, and returns its SHA512 digest encoded as a\nBase64 string, with trailing '=' padding.\n\n$sha512b64 = sha512b64('data string');\n#or\n$sha512b64 = sha512b64('any data', 'more data', 'even more data');\n\nsha512b64u\nLogically joins all arguments into a single string, and returns its SHA512 digest encoded as a\nBase64 URL Safe string (see RFC 4648 section 5).\n\n$sha512b64url = sha512b64u('data string');\n#or\n$sha512b64url = sha512b64u('any data', 'more data', 'even more data');\n\nsha512file\nReads file (defined by filename or filehandle) content, and returns its SHA512 digest encoded as\na binary string.\n\n$sha512raw = sha512file('filename.dat');\n#or\n$sha512raw = sha512file(*FILEHANDLE);\n\nsha512filehex\nReads file (defined by filename or filehandle) content, and returns its SHA512 digest encoded as\na hexadecimal string.\n\n$sha512hex = sha512filehex('filename.dat');\n#or\n$sha512hex = sha512filehex(*FILEHANDLE);\n\nBEWARE: You have to make sure that the filehandle is in binary mode before you pass it as\nargument to the addfile() method.\n\nsha512fileb64\nReads file (defined by filename or filehandle) content, and returns its SHA512 digest encoded as\na Base64 string, with trailing '=' padding.\n\n$sha512b64 = sha512fileb64('filename.dat');\n#or\n$sha512b64 = sha512fileb64(*FILEHANDLE);\n\nsha512fileb64u\nReads file (defined by filename or filehandle) content, and returns its SHA512 digest encoded as\na Base64 URL Safe string (see RFC 4648 section 5).\n\n$sha512b64url = sha512fileb64u('filename.dat');\n#or\n$sha512b64url = sha512fileb64u(*FILEHANDLE);\n",
                "subsections": []
            },
            "METHODS": {
                "content": "The OO interface provides the same set of functions as Crypt::Digest.\n\nnew\n$d = Crypt::Digest::SHA512->new();\n\nclone\n$d->clone();\n\nreset\n$d->reset();\n\nadd\n$d->add('any data');\n#or\n$d->add('any data', 'more data', 'even more data');\n\naddfile\n$d->addfile('filename.dat');\n#or\n$d->addfile(*FILEHANDLE);\n\naddbits\n$d->addbits($bitstring);   # e.g. $d->addbits(\"111100001010\");\n#or\n$d->addbits($data, $nbits); # e.g. $d->addbits(\"\\xF0\\xA0\", 16);\n\nhashsize\n$d->hashsize;\n#or\nCrypt::Digest::SHA512->hashsize();\n#or\nCrypt::Digest::SHA512::hashsize();\n\ndigest\n$resultraw = $d->digest();\n\nhexdigest\n$resulthex = $d->hexdigest();\n\nb64digest\n$resultb64 = $d->b64digest();\n\nb64udigest\n$resultb64url = $d->b64udigest();\n",
                "subsections": []
            },
            "SEE ALSO": {
                "content": "*   CryptX, Crypt::Digest\n\n*   <https://en.wikipedia.org/wiki/SHA-2>\n",
                "subsections": []
            }
        }
    }
}