आप सी से गो कोड कह सकते हैं। यह एक भ्रामक प्रस्ताव है।
प्रक्रिया उस ब्लॉग पोस्ट में उल्लिखित है जिसे आपने लिंक किया है। लेकिन मैं देख सकता हूँ कि यह कैसे बहुत उपयोगी नहीं है। यहां बिना किसी अनावश्यक बिट्स के एक छोटा स्निपेट है। इसे चीजों को थोड़ा स्पष्ट करना चाहिए।
package foo
// extern int goCallbackHandler(int, int);
//
// static int doAdd(int a, int b) {
// return goCallbackHandler(a, b);
// }
import "C"
//export goCallbackHandler
func goCallbackHandler(a, b C.int) C.int {
return a + b
}
// This is the public function, callable from outside this package.
// It forwards the parameters to C.doAdd(), which in turn forwards
// them back to goCallbackHandler(). This one performs the addition
// and yields the result.
func MyAdd(a, b int) int {
return int( C.doAdd( C.int(a), C.int(b)) )
}
वह क्रम जिसमें सब कुछ कहा जाता है:
foo.MyAdd(a, b) ->
C.doAdd(a, b) ->
C.goCallbackHandler(a, b) ->
foo.goCallbackHandler(a, b)
यहाँ याद रखने की कुंजी यह है कि एक कॉलबैक फ़ंक्शन को //export
गो साइड extern
पर और सी साइड पर टिप्पणी के साथ चिह्नित किया जाना चाहिए । इसका मतलब यह है कि आप जिस भी कॉलबैक का उपयोग करना चाहते हैं, उसे आपके पैकेज के अंदर परिभाषित किया जाना चाहिए।
कस्टम पैकेजबैक फ़ंक्शन की आपूर्ति करने के लिए आपके पैकेज के उपयोगकर्ता को अनुमति देने के लिए, हम उपरोक्त के समान सटीक दृष्टिकोण का उपयोग करते हैं, लेकिन हम उपयोगकर्ता के कस्टम हैंडलर की आपूर्ति करते हैं (जो कि एक नियमित गो फ़ंक्शन है) सी पर पारित होने वाले पैरामीटर के रूप में। पक्ष के रूप में void*
। यह तब कॉलबैकहैंडलर द्वारा हमारे पैकेज में प्राप्त किया जाता है और कहा जाता है।
आइए एक और अधिक उन्नत उदाहरण का उपयोग करें जो मैं वर्तमान में काम कर रहा हूं। इस मामले में, हमारे पास एक सी फ़ंक्शन है जो एक बहुत भारी कार्य करता है: यह एक यूएसबी डिवाइस से फाइलों की एक सूची पढ़ता है। इसमें कुछ समय लग सकता है, इसलिए हम चाहते हैं कि हमारा ऐप इसकी प्रगति को अधिसूचित करे। हम इसे एक फ़ंक्शन पॉइंटर में पास करके कर सकते हैं जिसे हमने अपने प्रोग्राम में परिभाषित किया था। जब भी इसे कॉल किया जाता है, यह उपयोगकर्ता के लिए कुछ प्रगति जानकारी प्रदर्शित करता है। चूंकि इसमें एक प्रसिद्ध हस्ताक्षर है, हम इसे अपने प्रकार से असाइन कर सकते हैं:
type ProgressHandler func(current, total uint64, userdata interface{}) int
यह हैंडलर इंटरफ़ेस {} मान के साथ कुछ प्रगति की जानकारी (प्राप्त फ़ाइलों की कुल संख्या और फ़ाइलों की कुल संख्या) लेता है, जिसे उपयोगकर्ता को रखने के लिए किसी भी चीज़ की आवश्यकता हो सकती है।
अब हमें इस हैंडलर का उपयोग करने की अनुमति देने के लिए सी और गो प्लंबिंग लिखना होगा। सौभाग्य से C फ़ंक्शन जिसे मैं लाइब्रेरी से कॉल करना चाहता हूं, वह हमें उपयोगकर्ता प्रकार की संरचना में पास करने की अनुमति देता है void*
। इसका मतलब यह है कि हम इसे पकड़ सकते हैं जो हम इसे पकड़ना चाहते हैं, कोई सवाल नहीं पूछा गया है और हम इसे वापस गो-वर्ल्ड में ले जाएंगे। यह सब काम करने के लिए, हम लाइब्रेरी फ़ंक्शन को सीधे गो से नहीं कहते हैं, लेकिन हम इसके लिए एक सी रैपर बनाते हैं जिसे हम नाम देंगे goGetFiles()
। यह एक रैपर है जो वास्तव में सी लाइब्रेरी के लिए हमारे गो कॉलबैक की आपूर्ति करता है, साथ ही एक यूजरडेटा ऑब्जेक्ट भी।
package foo
// #include <somelib.h>
// extern int goProgressCB(uint64_t current, uint64_t total, void* userdata);
//
// static int goGetFiles(some_t* handle, void* userdata) {
// return somelib_get_files(handle, goProgressCB, userdata);
// }
import "C"
import "unsafe"
ध्यान दें कि goGetFiles()
फ़ंक्शन कॉलबैक के लिए किसी भी फ़ंक्शन पॉइंट को पैरामीटर के रूप में नहीं लेता है। इसके बजाय, हमारे उपयोगकर्ता ने जो कॉलबैक दिया है वह कस्टम संरचना में पैक किया गया है जो उस हैंडलर और उपयोगकर्ता के स्वयं के उपयोगकर्ता मूल्य दोनों को रखता है। हम इसे goGetFiles()
userdata पैरामीटर के रूप में पास करते हैं ।
// This defines the signature of our user's progress handler,
type ProgressHandler func(current, total uint64, userdata interface{}) int
// This is an internal type which will pack the users callback function and userdata.
// It is an instance of this type that we will actually be sending to the C code.
type progressRequest struct {
f ProgressHandler // The user's function pointer
d interface{} // The user's userdata.
}
//export goProgressCB
func goProgressCB(current, total C.uint64_t, userdata unsafe.Pointer) C.int {
// This is the function called from the C world by our expensive
// C.somelib_get_files() function. The userdata value contains an instance
// of *progressRequest, We unpack it and use it's values to call the
// actual function that our user supplied.
req := (*progressRequest)(userdata)
// Call req.f with our parameters and the user's own userdata value.
return C.int( req.f( uint64(current), uint64(total), req.d ) )
}
// This is our public function, which is called by the user and
// takes a handle to something our C lib needs, a function pointer
// and optionally some user defined data structure. Whatever it may be.
func GetFiles(h *Handle, pf ProgressFunc, userdata interface{}) int {
// Instead of calling the external C library directly, we call our C wrapper.
// We pass it the handle and an instance of progressRequest.
req := unsafe.Pointer(&progressequest{ pf, userdata })
return int(C.goGetFiles( (*C.some_t)(h), req ))
}
यह हमारे सी बाइंडिंग के लिए है। उपयोगकर्ता का कोड अब बहुत सीधा है:
package main
import (
"foo"
"fmt"
)
func main() {
handle := SomeInitStuff()
// We call GetFiles. Pass it our progress handler and some
// arbitrary userdata (could just as well be nil).
ret := foo.GetFiles( handle, myProgress, "Callbacks rock!" )
....
}
// This is our progress handler. Do something useful like display.
// progress percentage.
func myProgress(current, total uint64, userdata interface{}) int {
fc := float64(current)
ft := float64(total) * 0.01
// print how far along we are.
// eg: 500 / 1000 (50.00%)
// For good measure, prefix it with our userdata value, which
// we supplied as "Callbacks rock!".
fmt.Printf("%s: %d / %d (%3.2f%%)\n", userdata.(string), current, total, fc / ft)
return 0
}
यह सब एक बहुत अधिक जटिल से अधिक लग रहा है। कॉल ऑर्डर हमारे पिछले उदाहरण के विपरीत नहीं बदला गया है, लेकिन हमें श्रृंखला के अंत में दो अतिरिक्त कॉल मिलते हैं:
आदेश इस प्रकार है:
foo.GetFiles(....) ->
C.goGetFiles(...) ->
C.somelib_get_files(..) ->
C.goProgressCB(...) ->
foo.goProgressCB(...) ->
main.myProgress(...)