src/commands/blmovem.json - unstable - githubmirror/redis

src/commands/blmovem.json
159 строк5 KB
Mincho Paskalev
Add LMOVEM/BLMOVEM commands (#15405)
09 июл 2026, 07:55
09 июл 2026, 07:55b48e4ab
{
    "BLMOVEM": {
        "summary": "Moves up to (or exactly) a number of elements from one list to another and returns them. Blocks until the elements are available otherwise. Deletes the source list if it becomes empty.",
        "complexity": "O(N) where N is the number of elements moved.",
        "group": "list",
        "since": "8.10.0",
        "arity": -6,
        "function": "blmovemCommand",
        "command_flags": [
            "WRITE",
            "DENYOOM",
            "BLOCKING"
        ],
        "acl_categories": [
            "LIST"
        ],
        "key_specs": [
            {
                "flags": [
                    "RW",
                    "ACCESS",
                    "DELETE"
                ],
                "begin_search": {
                    "index": {
                        "pos": 1
                    }
                },
                "find_keys": {
                    "range": {
                        "lastkey": 0,
                        "step": 1,
                        "limit": 0
                    }
                }
            },
            {
                "flags": [
                    "RW",
                    "INSERT"
                ],
                "begin_search": {
                    "index": {
                        "pos": 2
                    }
                },
                "find_keys": {
                    "range": {
                        "lastkey": 0,
                        "step": 1,
                        "limit": 0
                    }
                }
            }
        ],
        "reply_schema": {
            "oneOf": [
                {
                    "description": "Operation timed-out.",
                    "type": "null"
                },
                {
                    "description": "The moved elements, in destination order.",
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                }
            ]
        },
        "arguments": [
            {
                "name": "source",
                "type": "key",
                "key_spec_index": 0
            },
            {
                "name": "destination",
                "type": "key",
                "key_spec_index": 1
            },
            {
                "name": "wherefrom",
                "type": "oneof",
                "arguments": [
                    {
                        "name": "left",
                        "type": "pure-token",
                        "token": "LEFT"
                    },
                    {
                        "name": "right",
                        "type": "pure-token",
                        "token": "RIGHT"
                    }
                ]
            },
            {
                "name": "whereto",
                "type": "oneof",
                "arguments": [
                    {
                        "name": "left",
                        "type": "pure-token",
                        "token": "LEFT"
                    },
                    {
                        "name": "right",
                        "type": "pure-token",
                        "token": "RIGHT"
                    }
                ]
            },
            {
                "name": "timeout",
                "type": "double"
            },
            {
                "name": "how-many",
                "type": "block",
                "optional": true,
                "arguments": [
                    {
                        "name": "selector",
                        "type": "oneof",
                        "arguments": [
                            {
                                "name": "count",
                                "type": "integer",
                                "token": "COUNT"
                            },
                            {
                                "name": "exactly",
                                "type": "integer",
                                "token": "EXACTLY"
                            }
                        ]
                    },
                    {
                        "name": "ordering",
                        "type": "oneof",
                        "arguments": [
                            {
                                "name": "obo",
                                "type": "pure-token",
                                "token": "OBO"
                            },
                            {
                                "name": "bulk",
                                "type": "pure-token",
                                "token": "BULK"
                            }
                        ]
                    }
                ]
            }
        ]
    }
}