HarmonyOS鸿蒙Next中ArkTS怎么实现Python的range函数

效果图：

关键代码：

由于ArkTS不支持生成器函数，所以只能实现返回数组形式的rangeArray。

// 重载1: 只传入结束值，从0开始，步长为1
function rangeArray(stop: number): number[];
// 重载2: 传入起始值和结束值，步长为1
function rangeArray(start: number, stop: number): number[];
// 重载3: 传入起始值、结束值和步长
function rangeArray(start: number, stop: number, step: number): number[];

/**
 * 生成一个数字范围数组
 * @param start - 起始值（当只传一个参数时，表示结束值，起始值默认为0）
 * @param stop - 结束值（不包含在结果中）
 * @param step - 步长，默认为1
 * @returns 从start开始到stop结束（不包含stop）的数字数组
 * @throws 当step为0时抛出错误
 * @throws 当step的方向与start到stop的方向不匹配时抛出错误
 */
function rangeArray(start: number, stop?: number, step: number = 1): number[] {
  // 处理只传入一个参数的情况
  if (stop === undefined) {
    stop = start;
    start = 0;
  }

  // 检查步长是否为0
  if (step === 0) {
    throw new Error("步长不能为0");
  }

  // 合并检查：步长方向必须与start到stop的方向匹配
  if ((step > 0 && start >= stop) || (step < 0 && start <= stop)) {
    throw new Error(
      `无效的范围：步长 ${step} 无法从起始值 ${start} 移动到结束值 ${stop}`
    );
  }

  const result: number[] = [];

  // 正步长：递增序列
  if (step > 0) {
    for (let i = start; i < stop; i += step) {
      result.push(i);
    }
  }
  // 负步长：递减序列
  else {
    for (let i = start; i > stop; i += step) {
      result.push(i);
    }
  }

  return result;
}

完整代码：

// 重载1: 只传入结束值，从0开始，步长为1
function rangeArray(stop: number): number[];
// 重载2: 传入起始值和结束值，步长为1
function rangeArray(start: number, stop: number): number[];
// 重载3: 传入起始值、结束值和步长
function rangeArray(start: number, stop: number, step: number): number[];

/**
 * 生成一个数字范围数组
 * @param start - 起始值（当只传一个参数时，表示结束值，起始值默认为0）
 * @param stop - 结束值（不包含在结果中）
 * @param step - 步长，默认为1
 * @returns 从start开始到stop结束（不包含stop）的数字数组
 * @throws 当step为0时抛出错误
 * @throws 当step的方向与start到stop的方向不匹配时抛出错误
 */
function rangeArray(start: number, stop?: number, step: number = 1): number[] {
  // 处理只传入一个参数的情况
  if (stop === undefined) {
    stop = start;
    start = 0;
  }

  // 检查步长是否为0
  if (step === 0) {
    throw new Error("步长不能为0");
  }

  // 合并检查：步长方向必须与start到stop的方向匹配
  if ((step > 0 && start >= stop) || (step < 0 && start <= stop)) {
    throw new Error(
      `无效的范围：步长 ${step} 无法从起始值 ${start} 移动到结束值 ${stop}`
    );
  }

  const result: number[] = [];

  // 正步长：递增序列
  if (step > 0) {
    for (let i = start; i < stop; i += step) {
      result.push(i);
    }
  }
  // 负步长：递减序列
  else {
    for (let i = start; i > stop; i += step) {
      result.push(i);
    }
  }

  return result;
}

@Entry
@ComponentV2
struct Index {
  @Builder
  RangeCard(index: number, color: string) {
    Row({ space: 16 }) {
      // 左侧颜色标记
      Column()
        .width(6)
        .height(60)
        .backgroundColor(color)
        .borderRadius(3)

      Text(`${index}`)
        .fontSize(20)
        .fontWeight(FontWeight.Bold)
        .fontColor(color)
    }
    .width('100%')
    .padding(20)
    .backgroundColor(Color.White)
    .borderRadius(16)
  }

  build() {
    Column() {
      // 使用 rangeArray 创建的卡片
      List({ space: 16 }) {
        Repeat(rangeArray(66, 55, -2))
          .each((ri: RepeatItem<number>) => {
            ListItem() {
              this.RangeCard(ri.item, this.randomColor())
            }
          })
      }
      .width('100%')
      .height('100%')
      .padding(20)
      .layoutWeight(1)
    }
    .width('100%')
    .height('100%')
    .backgroundColor('#F3F4F6')
  }

  private randomColor(): string {
    // 生成RGB分量，避免过浅（接近白色）或过深（接近黑色）
    const r = Math.floor(Math.random() * 156) + 50; // 50-205
    const g = Math.floor(Math.random() * 156) + 50;
    const b = Math.floor(Math.random() * 156) + 50;

    return `#${r.toString(16).padStart(2, '0')}${g.toString(16).padStart(2, '0')}${b.toString(16).padStart(2, '0')}`;
  }
}