{ "__type": "IngestedDoc", "__tag": 4010, "_content": { "Notes": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Warns": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Raises": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Yields": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Methods": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Returns": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Summary": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Convert the input to a " }, { "__type": "CrossRef", "__tag": 4002, "value": "chararray", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy.char:chararray" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": ", copying the data only if necessary." } ] } ], "title": [], "level": 0, "target": null }, "Receives": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Warnings": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Attributes": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Parameters": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Parameters", "__tag": 4026, "children": [ { "__type": "DocParam", "__tag": 4016, "name": "obj", "annotation": "array of str or unicode-like", "desc": [] }, { "__type": "DocParam", "__tag": 4016, "name": "itemsize", "annotation": "int, optional", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "ParamRef", "__tag": 4071, "name": "itemsize" }, { "__type": "Text", "__tag": 4046, "value": " is the number of characters per scalar in the resulting array. If " }, { "__type": "ParamRef", "__tag": 4071, "name": "itemsize" }, { "__type": "Text", "__tag": 4046, "value": " is None, and " }, { "__type": "ParamRef", "__tag": 4071, "name": "obj" }, { "__type": "Text", "__tag": 4046, "value": " is an object array or a Python list, the " }, { "__type": "ParamRef", "__tag": 4071, "name": "itemsize" }, { "__type": "Text", "__tag": 4046, "value": " will be automatically determined. If " }, { "__type": "ParamRef", "__tag": 4071, "name": "itemsize" }, { "__type": "Text", "__tag": 4046, "value": " is provided and " }, { "__type": "ParamRef", "__tag": 4071, "name": "obj" }, { "__type": "Text", "__tag": 4046, "value": " is of type str or unicode, then the " }, { "__type": "ParamRef", "__tag": 4071, "name": "obj" }, { "__type": "Text", "__tag": 4046, "value": " string will be chunked into " }, { "__type": "ParamRef", "__tag": 4071, "name": "itemsize" }, { "__type": "Text", "__tag": 4046, "value": " pieces." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "unicode", "annotation": "bool, optional", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "When true, the resulting " }, { "__type": "CrossRef", "__tag": 4002, "value": "chararray", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy.char:chararray" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": " can contain Unicode characters, when false only 8-bit characters. If unicode is None and " }, { "__type": "ParamRef", "__tag": 4071, "name": "obj" }, { "__type": "Text", "__tag": 4046, "value": " is one of the following:" } ] }, { "__type": "BulletList", "__tag": 4053, "ordered": false, "start": 1, "children": [ { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "a " }, { "__type": "CrossRef", "__tag": 4002, "value": "chararray", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy.char:chararray" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": "," } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "an ndarray of type " }, { "__type": "CrossRef", "__tag": 4002, "value": "str_", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy:str_" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": " or " }, { "__type": "InlineRole", "__tag": 4003, "value": "unicode_", "domain": null, "role": null, "inventory": null } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "a Python str or unicode object," } ] } ] } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "then the unicode setting of the output array will be automatically determined." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "order", "annotation": "{'C', 'F'}, optional", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Specify the order of the array. If order is 'C' (default), then the array will be in C-contiguous order (last-index varies the fastest). If order is 'F', then the returned array will be in Fortran-contiguous order (first-index varies the fastest)." } ] } ] } ] } ], "title": [], "level": 0, "target": null }, "Extended Summary": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Versus a NumPy array of dtype " }, { "__type": "CrossRef", "__tag": 4002, "value": "bytes_", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy:bytes_" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": " or " }, { "__type": "CrossRef", "__tag": 4002, "value": "str_", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy:str_" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": ", this class adds the following functionality:" } ] }, { "__type": "BulletList", "__tag": 4053, "ordered": true, "start": 1, "children": [ { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "values automatically have whitespace removed from the end when indexed" } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "comparison operators automatically remove whitespace from the end when comparing values" } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "vectorized string operations are provided as methods (e.g. " }, { "__type": "InlineRole", "__tag": 4003, "value": "chararray.endswith ", "domain": null, "role": null, "inventory": null }, { "__type": "Text", "__tag": 4046, "value": ") and infix operators (e.g. " }, { "__type": "InlineCode", "__tag": 4051, "value": "+" }, { "__type": "Text", "__tag": 4046, "value": ", " }, { "__type": "InlineCode", "__tag": 4051, "value": "*" }, { "__type": "Text", "__tag": 4046, "value": ", " }, { "__type": "InlineCode", "__tag": 4051, "value": "%" }, { "__type": "Text", "__tag": 4046, "value": ")" } ] } ] } ] } ], "title": [], "level": 0, "target": null }, "Other Parameters": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null } }, "_ordered_sections": [ "Summary", "Extended Summary", "Parameters", "Attributes", "Methods", "Returns", "Yields", "Receives", "Other Parameters", "Raises", "Warns", "Warnings", "Notes" ], "item_file": "/numpy/_core/defchararray.py", "item_line": 1356, "item_type": "function", "aliases": [ "numpy.char.asarray" ], "example_section_data": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Code", "__tag": 4050, "value": "import numpy as np\nnp.char.asarray(['hello', 'world'])\n", "execution_status": "success" } ], "title": [], "level": 0, "target": null }, "see_also": [], "signature": { "__type": "SignatureNode", "__tag": 4029, "kind": "function", "parameters": [ { "__type": "SigParam", "__tag": 4030, "name": "obj", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": { "__type": "Empty", "__tag": 4031 } }, { "__type": "SigParam", "__tag": 4030, "name": "itemsize", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": "None" }, { "__type": "SigParam", "__tag": 4030, "name": "unicode", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": "None" }, { "__type": "SigParam", "__tag": 4030, "name": "order", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": "None" } ], "return_annotation": { "__type": "Empty", "__tag": 4031 }, "target_name": "asarray" }, "references": null, "qa": "numpy.char:asarray", "arbitrary": [], "local_refs": [ "itemsize", "obj", "order", "unicode" ] }