{
    "content": [
        {
            "type": "text",
            "text": "# Internals (man)\n\n## NAME\n\nInternals - Reserved special namespace for internals related functions\n\n## SYNOPSIS\n\n$isro= Internals::SvREADONLY($x)\n$refcnt= Internals::SvREFCNT($x)\nhvclearplaceholders(%hash);\n\n## DESCRIPTION\n\nThe Internals namespace is used by the core Perl development team to expose certain low level\ninternals routines for testing and other purposes.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **AUTHOR**\n- **SEE ALSO**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "Internals",
        "section": "",
        "mode": "man",
        "summary": "Internals - Reserved special namespace for internals related functions",
        "synopsis": "$isro= Internals::SvREADONLY($x)\n$refcnt= Internals::SvREFCNT($x)\nhvclearplaceholders(%hash);",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [],
        "examples": [],
        "see_also": [],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 4,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 43,
                "subsections": []
            },
            {
                "name": "AUTHOR",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 5,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "Internals - Reserved special namespace for internals related functions\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "$isro= Internals::SvREADONLY($x)\n$refcnt= Internals::SvREFCNT($x)\nhvclearplaceholders(%hash);\n",
                "subsections": []
            },
            "DESCRIPTION": {
                "content": "The Internals namespace is used by the core Perl development team to expose certain low level\ninternals routines for testing and other purposes.\n\nIn theory these routines were not and are not intended to be used outside of the perl core,\nand are subject to change and removal at any time.\n\nIn practice people have come to depend on these over the years, despite being historically\nundocumented, so we will provide some level of forward compatibility for some time.\nNevertheless you can assume that any routine documented here is experimental or deprecated\nand you should find alternatives to their use.\n\nFUNCTIONS\nSvREFCNT(THING [, $value])\nHistorically Perl has been a refcounted language. This means that each variable tracks\nhow many things reference it, and when the variable is no longer referenced it will\nautomatically free itself. In theory Perl code should not have to care about this, and in\na future version Perl might change to some other strategy, although in practice this is\nunlikely.\n\nThis function allows one to violate the abstraction of variables and get or set the\nrefcount of a variable, and in generally is really only useful in code that is testing\nrefcount behavior.\n\n*NOTE* You are strongly discouraged from using this function in non-test code and\nespecially discouraged from using the set form of this function.  The results of doing so\nmay result in segmentation faults or other undefined behavior.\n\nSvREADONLY(THING, [, $value])\nSet or get whether a variable is readonly or not. Exactly what the readonly flag means\ndepend on the type of the variable affected and the version of perl used.\n\nYou are strongly discouraged from using this function directly. It is used by various\ncore modules, like \"Hash::Util\", and the \"constant\" pragma to implement higher-level\nbehavior which should be used instead.\n\nSee the core implementation for the exact meaning of the readonly flag for each internal\nvariable type.\n\nhvclearplaceholders(%hash)\nClear any placeholders from a locked hash. Should not be used directly.  You should use\nthe wrapper functions provided by Hash::Util instead.  As of 5.25 also available as \"\nHash::Util::clearplaceholders(%hash) \"\n",
                "subsections": []
            },
            "AUTHOR": {
                "content": "Perl core development team.\n",
                "subsections": []
            },
            "SEE ALSO": {
                "content": "perlguts Hash::Util constant universal.c\n\n\n\nperl v5.34.0                                 2025-07-25                             Internals(3perl)",
                "subsections": []
            }
        }
    }
}