본문으로 건너뛰기

키-값 복사 (LCC.kvdb.dict.copy_value)

선언​

ok, old_value_or_err = LCC.kvdb.dict.copy_value(src_name, src_key, dst_name?, dst_key?, timeout?)

매개변수​

  • src_name
    문자열 형태, 소스 사전의 이름(빈 값 불가, 최대 길이는 256 바이트)
  • src_key
    문자열 형태, 소스 키의 이름(유효한 UTF-8 형식이어야 하며 빈 값이 아니어야 함)
  • dst_name
    문자열 형태, 선택 사항; 대상 사전의 이름, 기본적으로 소스와 동일함(빈 값 불가, 최대 길이는 256 바이트)
  • dst_key
    문자열 형태, 선택 사항; 대상 키의 이름, 기본적으로 소스 키와 동일함(유효한 UTF-8 형식이어야 하며 빈 값이 아니어야 함)
  • timeout
    수치 형태, 선택 사항; 요청 시간 초과 시간(초), 기본값은 60

반환 값​

  • ok
    부울 형태, 복사에 성공할 경우 true를 반환하고 실패할 경우 false를 반환함
  • old_value_or_err
    문자열 형태 또는 nil; 성공할 경우 대상 위치의 기존 값(존재하지 않을 경우 nil)을 반환하며, 실패할 경우 오류 설명을 반환함

설명​

값은 대상 키로 복사되며 소스 키는 그대로 유지됩니다.
소스와 대상이 완전히 동일한 경우 기존 값을 읽어 true, 이전 값을 반환하는 것과 같습니다.
소스 키가 찾아지지 않을 경우 false를 반환합니다.

예시​

local ok, old = LCC.kvdb.dict.copy_value("템플릿", "기본 설정", "사용자 설정", "기본 설정")
if not ok then
error(old)
end