Where is the c tuple layer?

Meai · February 7, 2019, 1:17pm

I am confused, the C api does mention it twice very quickly in a warning but not how to use it or where to find it. It doesnt seem to be its own project like the record and document layer.
It also isnt here: https://github.com/apple/foundationdb/tree/master/layers
It also doesnt seem to be in the fdb c headers. Right?
And when I look at design docs like this, it almost sounds like the tuple layer is more like a data format? I dont get it. https://github.com/apple/foundationdb/blob/master/design/tuple.md

The other language tutorials seem to have docs on how to use their tuple layer but I dont know those languages that well and it takes a lot of effort for me to read them when I dont even want to use them anyway: https://apple.github.io/foundationdb/api-python.html#module-fdb.tuple

The word ‘tuple’ doesnt appear anywhere here: https://github.com/apple/foundationdb/blob/master/bindings/c/foundationdb/fdb_c.h
https://github.com/apple/foundationdb/blob/master/bindings/c/fdb_c.cpp

ajbeamon · February 7, 2019, 4:52pm

The Tuple layer isn’t implemented for the C bindings. The closest thing that I know of is a C++ implementation for the Flow bindings:

github.com

apple/foundationdb/blob/main/bindings/flow/Tuple.h

/*
 * Tuple.h
 *
 * This source file is part of the FoundationDB open source project
 *
 * Copyright 2013-2022 Apple Inc. and the FoundationDB project authors
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

This file has been truncated. show original

github.com

apple/foundationdb/blob/main/bindings/flow/Tuple.cpp

/*
 * Tuple.cpp
 *
 * This source file is part of the FoundationDB open source project
 *
 * Copyright 2013-2022 Apple Inc. and the FoundationDB project authors
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

This file has been truncated. show original

The tuple layer basically defines an encoding from tuples of various data types to keys, and many of the bindings provide an implementation to easily read and write these keys using this encoding.