값을 쓰고 이전 값 반환 (LCC.kvdb.dict.put)

선언

old_value, err = LCC.kvdb.dict.put(name, key, value, timeout?)

매개변수

• name
  문자열 형태, 사전의 이름(빈 값 불가능, 최대 길이는 256 바이트)
• key
  문자열 형태, 키 이름(유효한 UTF-8 형식이어야 하며 빈 값이 허용되지 않음)
• value
  문자열 형태, 새로운 값(유효한 UTF-8 형식이어야 함)
• timeout
  수치 형태, 선택 사항; 요청 시간 초과 시간(초), 기본값은 60

반환 값

• old_value
  문자열 형태 또는 nil, 성공할 경우 교체 이전의 기존 값을 반환하며, 새로운 키인 경우에는 nil를 반환함
• err
  문자열 형태 또는 nil, 성공할 경우 nil를 반환하며, 오류가 발생할 경우 오류 설명을 반환함

설명

키와 값을 쓰고 기존 값을 반환함으로써 “값을 설정하고 기존 값을 동시에 가져오는” 원자적인 작업을 구현할 수 있습니다.
요청에 실패할 경우 false, 오류 정보가 반환됩니다.

예시

local old, err = LCC.kvdb.dict.put("설정", "재시도 횟수", "3")
if old == false then
    error(err)
end