StringSetCharacter

지정된 위치에 변경된 문자가 있는 문자열의 복사본을 반환합니다.

bool  StringSetCharacter(
   string&   string_var,       // 문자열
   int       pos,              // 위치
   ushort    character         // 글자
   );

Parameter

string_var

[in][out]  문자열.

pos

[in]  문자열에서의 글자의 위치. 0에서 StringLen(text) 까지 가능.

character

[in]  기호 코드 유니코드.

반환값

성공 시 true를 반환하고, 그렇지 않으면 false를 반환합니다. 오류 코드를 얻으려면, GetLastError() 함수를 호출해야 합니다.

참고

pos가문자열 길이보다 작고 기호 코드 값이 0이면 문자열이 차단됩니다(그러나 버퍼 사이즈, 문자열에 대해 분산되어 있음). 문자열 길이가 pos와 같아집니다.

pos가 문자열 길이와 같으면 문자열 끝에 지정된 기호가 추가되고 길이가 1씩 확대됩니다.

예:

void OnStart()
  {
   string str="0123456789";
   Print("before: str = ",str,",StringBufferLen(str) = ",
         StringBufferLen(str),"  StringLen(str) = ",StringLen(str));
//--- 가운데 0 값 추가
   StringSetCharacter(str,6,0);
   Print("after: str = ",str,",StringBufferLen(str) = ",
         StringBufferLen(str),"  StringLen(str) = ",StringLen(str));
//--- 끝에 기호 추가
   int size=StringLen(str);
   StringSetCharacter(str,size,'+');
   Print("addition: str = ",str,",StringBufferLen(str) = ",
         StringBufferLen(str),"  StringLen(str) = ",StringLen(str));
  }
/* 결과
   before: str = 0123456789 ,StringBufferLen(str) = 0   StringLen(str) = 10
    after: str = 012345 ,StringBufferLen(str) = 16   StringLen(str) = 6
   addition: str = 012345+ ,StringBufferLen(str) = 16   StringLen(str) = 7
*/

참고 항목

StringBufferLen, StringLen, StringFill, StringInit, CharToString, ShortToString, CharArrayToString, ShortArrayToString