키-값 복사 (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