> ## Documentation Index
> Fetch the complete documentation index at: https://docs.projectreal.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# getinstancesbyclass

> Gibt instances aus der Instance cache table zurueck, deren ClassName field exakt mit dem angeforderten string uebereinstimmt. Das erste Argument wird mit string type checking gelesen. Ein empty string wirft "ClassName required". Die function erstellt eine neue array table, iteriert die cache unter Instance cache, behaelt nur values mit Lua type object, liest das ClassName field jedes object value und vergleicht es per strcmp mit dem angeforderten className. Treffer werden sequential ab index 1 eingefuegt. Der Match ist exact und case-sensitive. Die function verwendet kein IsA, schliesst keine subclasses ein, macht keinen walk descendants, filtert nicht nach Parent und sortiert das result nicht. getinstancesofclass ist ein alias fuer dieselbe function.

<div className="real-function-page">
  ```lua theme={null}
  getinstancesbyclass(className: string): table
  ```

  ## Aliase

  * `getinstancesofclass`

  ## Argumente

  <ParamField path={"className"} type={"string"} required>
    Exact ClassName string zum Abgleichen. Empty strings werfen "ClassName required".
  </ParamField>

  ## Rückgaben

  <ResponseField name={"instances"} type={"table"}>
    New array table mit matching object values aus der Instance cache table.
  </ResponseField>
</div>