mxcad_2d API 文档 / 2d / McGeStringArray

Class: McGeStringArray

2d.McGeStringArray

McGeStringArray 表示一组字符串值的数组容器。

Description

该类用于存储和处理字符串集合，常用于图层名、线型名、文本样式名、 布局名等 CAD 字符串信息的批量管理。它支持追加、读取、修改、遍历和清空。

Example

import { McGeStringArray } from "mxcad";

const names = new McGeStringArray();
names.append("Layer1");
names.append("Layer2");

console.log(names.at(0))//获取索引为0的元素值;
console.log(names.length())//获取数组长度;

Table of contents

Constructors

• constructor

Properties

• imp

Methods

• append
• at
• clear
• copy
• forEach
• length
• setAt

Constructors

constructor

• new McGeStringArray(imp?)

构造函数。

Parameters

Name	Type	Description
imp?	object	内部构造函数

Properties

imp

• imp: any

内部实现对象

Methods

append

▸ append(val): void

添加一个值

Parameters

Name	Type	Description
val	string	字符串

Returns

void

---

at

▸ at(index, decodeFromGb2312?): string

根据数组索引得到数据元素的值

Parameters

Name	Type	Default value	Description
index	number	undefined	数组索引
decodeFromGb2312	boolean	true	-

Returns

string

字符串

---

clear

▸ clear(): void

清空数组

Returns

void

Example

import { McGeStringArray } from "mxcad";

  const array = new McGeStringArray();
  array.append("apple");
  array.append("banana");

  array.clear();
  console.log(array.length()); // 输出: 0

---

copy

▸ copy(val): McGeStringArray

复制对象的值

Parameters

Name	Type
val	McGeStringArray

Returns

McGeStringArray

Example

import { McGeStringArray } from "mxcad";

  const array1 = new McGeStringArray();
  const array2 = new McGeStringArray();
  array2.append("apple");
  array2.append("banana");

  // 复制 array2 的值到 array1
  array1.copy(array2);

---

forEach

▸ forEach(call, decodeFromGb2312?): void

遍历数组

Parameters

Name	Type	Default value	Description
call	(val: string, index: number) => void	undefined	回调函数
decodeFromGb2312	boolean	true	-

Returns

void

Example

import { McGeStringArray } from "mxcad";

  const array = new McGeStringArray();
  array.append("apple");
  array.append("banana");

  array.forEach((val, index) => {
    console.log(`Index ${index}: Value ${val}`);
  });
  // 输出:
  // Index 0: Value apple
  // Index 1: Value banana

---

length

▸ length(): number

返回数组长度

Returns

number

数组长度

---

setAt

▸ setAt(index, val, decodeFromGb2312?): void

通过数组索引设置数据元素的值

Parameters

Name	Type	Default value	Description
index	number	undefined	数组索引
val	string	undefined	字符串
decodeFromGb2312	boolean	true	-

Returns

void

Example

import { McGeStringArray } from "mxcad";

  const array = new McGeStringArray();
  array.append("apple");
  array.append("banana");

  array.setAt(0, "orange");
  console.log(array.at(0)); // 输出: "orange"