# 5. LIST 명령 List collection에 관한 명령은 아래와 같다. * [List collection 생성: lop create](#lop-create) * List collection 삭제: delete (기존 key-value item의 삭제 명령을 그대로 사용) List element에 관한 명령은 아래와 같다. * [List element 삽입: lop insert](#lop-insert) * [List element 삭제: lop delete](#lop-delete) * [List element 조회: lop get](#lop-get) ## lop create 명령 List collection을 empty 상태로 생성한다. ``` lop create [noreply]\r\n * attributes: [] [unreadable] ``` * \ - 대상 item의 key string * \ - 설정할 item attributes. [Item Attribute 설명](https://jam2in.gitbook.io/arcus-memcached/ascii-protocol/ch03-item-attributes)을 참조 바란다. * unreadable - 명시하면, readable 속성은 off로 설정됩니다. * noreply - 명시하면, response string을 전달받지 않는다. Response string과 그 의미는 아래와 같다. | Response String | 설명 | | --------------------------------------- | ----------------------------- | | "CREATED" | 성공 | | "EXISTS" | 동일 key string을 가진 item이 이미 존재 | | "NOT\_SUPPORTED" | 지원하지 않음 | | "CLIENT\_ERROR bad command line format" | protocol syntax 틀림 | | "SERVER\_ERROR out of memory" | 메모리 부족 | ## lop insert 명령 List collection에 하나의 element를 삽입한다. List collection을 생성하면서 하나의 element를 삽입할 수도 있다. ``` lop insert [create ] [noreply|pipe]\r\n\r\n * attributes: [] [unreadable] ``` * \ - 대상 item의 key string * \ - 삽입 위치를 0-based index로 지정. * 0, 1, 2, ... : list의 앞에서 시작하여 각 element 위치를 나타냄 * -1, -2, -3, ... : list의 뒤에서 시작하여 각 element 위치를 나타냄 * \ - 삽입할 데이터 길이 (trailing 문자인 "\r\n"을 제외한 길이) * create \ - list collection 없을 시에 list 생성 요청. [Item Attribute 설명](https://jam2in.gitbook.io/arcus-memcached/ascii-protocol/ch03-item-attributes)을 참조 바란다. * unreadable - 명시하면, readable 속성은 off로 설정됩니다. * noreply or pipe - 명시하면, response string을 전달받지 않는다. pipe 사용은 [Command Pipelining](https://jam2in.gitbook.io/arcus-memcached/ascii-protocol/ch09-command-pipelining)을 참조 바란다. * \ - 삽입할 데이터 (최대 크기는 [기본제약사항](https://jam2in.gitbook.io/arcus-memcached/ch01-arcus-basic-concept#basic-constraints)을 참고) Response string과 그 의미는 아래와 같다. | Response String | 설명 | | --------------------------------------- | --------------------------------------------------------------------------------- | | "STORED" | 성공 (element만 삽입) | | "CREATED\_STORED" | 성공 (collection 생성하고 element 삽입) | | "NOT\_FOUND" | key miss | | "TYPE\_MISMATCH" | 해당 item이 list collection이 아님 | | "OVERFLOWED" | overflow 발생 | | "OUT\_OF\_RANGE" | 삽입 위치가 list의 현재 element index 범위를 넘어섬. 예를 들어, 10개 element가 있는 상태에서 삽입 위치가 20인 경우임 | | "NOT\_SUPPORTED" | 지원하지 않음 | | "CLIENT\_ERROR bad command line format" | protocol syntax 틀림 | | "CLIENT\_ERROR too large value" | 삽입할 데이터가 element value의 최대 크기보다 큼 | | "CLIENT\_ERROR bad data chunk" | 삽입할 데이터 길이가 \와 다르거나 "\r\n"으로 끝나지 않음 | | "SERVER\_ERROR out of memory" | 메모리 부족 | ## lop delete 명령 List collection에 하나의 index 또는 index range에 해당하는 elements를 삭제한다. ``` lop delete [drop] [noreply|pipe]\r\n lop delete 명령에서 각 인자의 설명은 아래와 같다. ``` * \ - 대상 item의 key string * \ - 삭제할 element의 index or index range. Element index는 "lop insert" 명령에서 소개한 바와 같이 0-based index 형태로 지정하며, index range는 index1..index2 형태로 표현하여, 그 예는 다음과 같다. * 0..-1: 첫째 element부터 마지막 element까지 (forward 순서) * 2..-2: 앞의 3번째 element부터 뒤의 2번째 element까지 (forward 순서) * -3..-1: 뒤의 3번째 element부터 뒤의 1번째 element까지 (forward 순서) * 4..2 : 앞의 5번째 element 부터 앞의 3번째 element까지 (backward 순서) * -1..0: 마지막 element 부터 첫째 element 까지 (backward 순서) * drop - element 삭제로 인해 empty list가 될 경우, 그 list를 drop할 것인지를 지정한다. * noreply or pipe - 명시하면, response string을 전달받지 않는다. pipe 사용은 [Command Pipelining](https://jam2in.gitbook.io/arcus-memcached/ascii-protocol/ch09-command-pipelining)을 참조 바란다. Response string과 그 의미는 아래와 같다. | Response String | 설명 | | --------------------------------------- | ------------------------------------------------------------ | | "DELETED" | 성공 (element만 삭제) | | "DELETED\_DROPPED" | 성공 (element 삭제하고 list를 drop한 상태) | | "NOT\_FOUND" | key miss | | "NOT\_FOUND\_ELEMENT" | element miss (single index or index range에 해당하는 element가 없음) | | "TYPE\_MISMATCH" | 해당 item이 list collection이 아님 | | "NOT\_SUPPORTED" | 지원하지 않음 | | "CLIENT\_ERROR bad command line format" | protocol syntax 틀림 | ## lop get 명령 List collection에 하나의 index 또는 index range에 해당하는 elements를 조회한다. ``` lop get [delete|drop]\r\n ``` * \ - 대상 item의 key string * \ - 조회할 element의 index or index range. "lop delete" 명령의 인자 참조 * delete or drop - element 조회하면서 그 element를 delete할 것인지, 그리고 delete로 인해 empty list가 될 경우 그 list를 drop할 것인지를 지정한다. 성공 시의 response string은 아래와 같다. VALUE 라인의 \는 조회된 element 개수를 의미한다. 마지막 라인은 END, DELETED, DELETED\_DROPPED 중의 하나를 가지며, 각각 element 조회만 수행한 상태, element 조회하고 삭제한 상태, element 조회 및 삭제하고 list를 drop한 상태를 의미한다. ``` VALUE \r\n \r\n \r\n \r\n ... END|DELETED|DELETED_DROPPED\r\n ``` 실패 시의 response string과 그 의미는 아래와 같다. | Response String | 설명 | | ----------------------------------------------------- | ----------------------------------------------------- | | "NOT\_FOUND" | key miss | | "NOT\_FOUND\_ELEMENT" | element miss (index or index range에 해당하는 element가 없음) | | "TYPE\_MISMATCH" | 해당 item이 list collection이 아님 | | "UNREADABLE" | 해당 item이 unreadable item임 | | "NOT\_SUPPORTED" | 지원하지 않음 | | "CLIENT\_ERROR bad command line format" | protocol syntax 틀림 | | "SERVER\_ERROR out of memory \[writing get response]" | 메모리 부족 | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://jam2in.gitbook.io/arcus-memcached/ascii-protocol/ch05-command-list-collection.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.