CAPL getProfileArray 사용법

CAPL에서 getProfileArray 함수를 사용하여 INI 파일로부터 배열 데이터를 읽으려면, INI 파일에 배열 형식의 데이터를 적절히 구성해야 합니다. 다음은 Test.Ini 파일의 예제 구성과 설명입니다.

---

1. Test.Ini 파일 구성 예시

[Parameter]
String = TestString
Float = 1.7845
Integer = 8
Array = 10, 20, 30, 40, 50, 60

구성 설명:

1. [Parameter]:

   • INI 파일에서 섹션을 정의하는 부분입니다. 여기서 CAPL 코드의 writeProfile... 및 getProfile... 함수에서 사용하는 섹션 이름입니다.

2. String, Float, Integer:

   • 각각 문자열, 실수, 정수를 저장하는 키와 값입니다.

3. Array:

   • 배열은 쉼표(,)로 구분된 값들로 저장합니다. 위 예제에서는 10, 20, 30, 40, 50, 60과 같은 정수 배열을 사용합니다.

---

2. CAPL 코드와의 연계

Test.Ini 파일을 위와 같이 구성하면, CAPL 코드의 getProfileArray 함수가 이 배열 데이터를 제대로 읽을 수 있습니다.

// 배열 데이터를 읽어와 buffarray에 저장
returnArray = getProfileArray("Parameter", "Array", buffarray, elcount(buffarray), "Test.Ini");

if (returnArray == 0)
{
    write("Non array content!");
}
else
{
    for (counter = 0; counter < returnArray; counter++)
    {
        write("Array: %d", buffarray[counter]);
    }
}

---

3. 주의할 점

• INI 파일에서 배열 데이터는 쉼표로 구분된 형식이어야 하며, 데이터 타입이 일관성 있게 구성되어야 합니다.
• elcount(buffarray): 배열의 크기를 계산하는 함수입니다. 이 값을 잘못 지정하면 배열이 제대로 읽히지 않을 수 있습니다.
• getProfileArray 함수는 배열 데이터를 읽어 buffarray에 저장하고, 배열의 길이를 반환합니다. 만약 반환 값이 0이면 배열이 없거나 잘못된 형식으로 저장된 것입니다.

---

4. 실행 예시 출력

위의 Test.Ini 파일을 사용하면 다음과 같이 출력됩니다:

Integer: 8
Float: 1.784500
String: TestString
Array: 10
Array: 20
Array: 30
Array: 40
Array: 50
Array: 60

---

5. 결론

Test.Ini 파일에서 배열을 읽기 위해서는 배열 데이터를 쉼표로 구분된 형식으로 작성해야 합니다. 이와 같은 형식을 사용하면 CAPL 코드에서 배열을 성공적으로 읽고 처리할 수 있습니다.