[ruby-core:120220] [Ruby master Feature#20878] A new C API to create a String by adopting a pointer: `rb_enc_str_adopt(const char *ptr, long len, long capa, rb_encoding *enc)`
From:
"byroot (Jean Boussier) via ruby-core" <ruby-core@...>
Date:
2024-12-12 17:07:14 UTC
List:
ruby-core #120220
SXNzdWUgIzIwODc4IGhhcyBiZWVuIHVwZGF0ZWQgYnkgYnlyb290IChKZWFuIEJvdXNzaWVyKS4N Cg0KDQo+IE5vLCBydWJ5X3hmcmVlIGlzIG5vdCBhIHNpbXBsZSBkZWxlZ2F0b3IgdG8gc3lzdGVt IGZyZWUsIGRlcGVuZGluZyBvbiBlbnZpcm9ubWVudCBhbmQgY29uZmlndXJhdGlvbi4NCg0KSSBz ZWUsIEkgZGlkbid0IGtub3cgYWJvdXQgdGhhdCBjb21waWxhdGlvbiBmbGFnLCB0aGFua3MgZm9y IGxldHRpbmcgbWUga25vdyB0aGF0Lg0KDQpPbmUgc29sdXRpb24gSSBzZWUgKGJ1dCB0aGF0IEkn bSBub3QgdmVyeSBmb25kIG9mKSBpcyB0byBwYXNzIHRoZSBgZnJlZWAgZnVuY3Rpb24gdGhhdCBt dXN0IGJlIHVzZWQgdG8gYGFkb3B0YCwgZS5nLg0KDQpgYGBjDQpzdHIgPSByYl9lbmNfc3RyX2Fk b3B0KGJ1Zi0+cHRyLCBidWYtPmxlbiwgYnVmLT5jYXBhLCByYl91dGY4X2VuY29kaW5nKCksIHJ1 YnlfeGZyZWUpOw0KLy8gb3INCnN0ciA9IHJiX2VuY19zdHJfYWRvcHQoYnVmLT5wdHIsIGJ1Zi0+ bGVuLCBidWYtPmNhcGEsIHJiX3V0ZjhfZW5jb2RpbmcoKSwgZnJlZSk7DQpgYGANCg0KVGhpcyB3 YXkgYHJiX2VuY19zdHJfYWRvcHRgIGNhbiBjaGVjayBpZiBhZG9wdGluZyB0aGUgc3RyaW5nIGlz IGxlZ2FsLCBhbmQgaWYgaXQgaXNuJ3QgZGVvcHRpbWl6ZSBpdCBpbnRvIGEgY29weT8NCg0KDQot LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tDQpGZWF0dXJlICMyMDg3ODog QSBuZXcgQyBBUEkgdG8gY3JlYXRlIGEgU3RyaW5nIGJ5IGFkb3B0aW5nIGEgcG9pbnRlcjogYHJi X2VuY19zdHJfYWRvcHQoY29uc3QgY2hhciAqcHRyLCBsb25nIGxlbiwgbG9uZyBjYXBhLCByYl9l bmNvZGluZyAqZW5jKWANCmh0dHBzOi8vYnVncy5ydWJ5LWxhbmcub3JnL2lzc3Vlcy8yMDg3OCNj aGFuZ2UtMTEwOTg0DQoNCiogQXV0aG9yOiBieXJvb3QgKEplYW4gQm91c3NpZXIpDQoqIFN0YXR1 czogT3Blbg0KLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLQ0KIyMjIENv bnRleHQNCg0KQSBjb21tb24gdXNlIGNhc2Ugd2hlbiB3cml0aW5nIEMgZXh0ZW5zaW9ucyBpcyB0 byBnZW5lcmF0ZSB0ZXh0IG9yIGJ5dGVzIGludG8gYSBidWZmZXIsIGFuZCB0byByZXR1cm4gaXQg YmFjaw0Kd3JhcHBlZCBpbnRvIGEgUnVieSBTdHJpbmcuIEV4YW1wbGVzIGFyZSBgSlNPTi5nZW5l cmF0ZShvYmopIC0+IFN0cmluZ2AsIGFuZCBhbGwgb3RoZXIgZm9ybWF0IHNlcmlhbGl6ZXJzLA0K Y29tcHJlc3Npb24gbGlicmFyaWVzIHN1Y2ggYXMgYFpMaWIuZGVmbGF0ZWAsIGV0YywgYnV0IGFs c28gbWV0aG9kcyBzdWNoIGFzIGBUaW1lLnN0cmZ0aW1lYCwgDQoNCiMjIyBDdXJyZW50IFNvbHV0 aW9uDQoNCiMjIyMgV29yayBpbiBhIGJ1ZmZlciBhbmQgY29weSB0aGUgcmVzdWx0DQoNClRoZSBt b3N0IG9mdGVuIHVzZWQgc29sdXRpb24gaXMgdG8gd29yayB3aXRoIGEgbmF0aXZlIGJ1ZmZlciBh bmQgdG8gbWFuYWdlIGEgbmF0aXZlIGFsbG9jYXRlZCBidWZmZXIsDQphbmQgb25jZSB0aGUgZ2Vu ZXJhdGlvbiBpcyBkb25lLCBjYWxsIGByYl9zdHJfbmV3KmAgdG8gY29weSB0aGUgcmVzdWx0IGlu c2lkZSBtZW1vcnkgbWFuYWdlZCBieSBSdWJ5Lg0KDQpJdCB3b3JrcywgYnV0IGlzbid0IHZlcnkg ZWZmaWNpZW50IGJlY2F1c2UgaXQgY2F1c2UgYW4gZXh0cmEgY29weSBhbmQgYW4gZXh0cmEgYGZy ZWUoKWAuDQoNCk9uIGBydWJ5L2pzb25gIG1hY3JvLWJlbmNobWFya3MsIHRoaXMgcmVwcmVzZW50 IGFyb3VuZCA1JSBvZiB0aGUgdGltZSBzcGVudCBpbiBgSlNPTi5nZW5lcmF0ZWAuDQoNCmBgYGMN CnN0YXRpYyB2b2lkIGZidWZmZXJfZnJlZShGQnVmZmVyICpmYikNCnsNCiAgICBpZiAoZmItPnB0 ciAmJiBmYi0+dHlwZSA9PSBGQlVGRkVSX0hFQVBfQUxMT0NBVEVEKSB7DQogICAgICAgIHJ1Ynlf eGZyZWUoZmItPnB0cik7DQogICAgfQ0KfQ0KDQpzdGF0aWMgVkFMVUUgZmJ1ZmZlcl90b19zKEZC dWZmZXIgKmZiKQ0Kew0KICAgIFZBTFVFIHJlc3VsdCA9IHJiX3V0Zjhfc3RyX25ldyhGQlVGRkVS X1BUUihmYiksIEZCVUZGRVJfTEVOKGZiKSk7DQogICAgZmJ1ZmZlcl9mcmVlKGZiKTsNCiAgICBy ZXR1cm4gcmVzdWx0Ow0KfQ0KYGBgDQoNCiMjIyMgV29yayBpbnNpZGUgUlN0cmluZyBhbGxvY2F0 ZWQgbWVtb3J5DQoNCkFub3RoZXIgd2F5IHRoaXMgaXMgY3VycmVudGx5IGRvbmUsIGlzIHRvIGFs bG9jYXRlIGFuIGBSU3RyaW5nYCB1c2luZyBgcmJfc3RyX2J1Zl9uZXdgLA0KYW5kIHdyaXRlIGlu dG8gaXQgd2l0aCB2YXJpb3VzIGZ1bmN0aW9ucyBzdWNoIGFzIGByYl9zdHJfY2F0ZmAsDQpvciB3 cml0aW5nIHBhc3QgYFJTdHJpbmcubGVuYCB0aHJvdWdoIGBSU1RSSU5HX1BUUmAgYW5kIHRoZW4g cmVzaXplIGl0IHdpdGggYHJiX3N0cl9zZXRfbGVuYC4NCg0KVGhlIGRvd25zaWRlIHdpdGggdGhp cyBhcHByb2FjaCBpcyB0aGF0IGl0IGNvbnRhaW5zIGEgbG90IG9mIGluZWZmaWNpZW5jaWVzLCBh cyBgcmJfc3RyX3NldF9sZW5gIHdpbGwgcGVyZm9ybQ0KbnVtZXJvdXMgc2FmZXR5IGNoZWNrcywg Y29tcHV0ZSBjb2RlcmFuZ2UsIGFuZCB3cml0ZSB0aGUgc3RyaW5nIHRlcm1pbmF0b3Igb24gZXZl cnkgaW52b2NhdGlvbi4NCg0KQW5vdGhlciBtYWpvciBpbm5lZmljaWVuY3kgaXMgdGhhdCB0aGlz IEFQSSBtYWtlIGl0IGhhcmQgdG8gYmUgaW4gY29udHJvbCBvZiB0aGUgYnVmZmVyDQpncm93dGgs IHNvIGl0IGNhbiByZXN1bHQgaW4gYSBsb3QgbW9yZSBgcmVhbGxvYygpYCBjYWxscyB0aGFuIG1h bnVhbGx5IG1hbmFnaW5nIHRoZSBidWZmZXIuDQoNClRoaXMgbWV0aG9kIGlzIHVzZWQgYnkgYEtl cm5lbCNzcHJpbnRmYCwgYFRpbWUjc3RyZnRpbWVgIGV0YywgYW5kIHdoZW4gSSBhdHRlbXB0ZWQg dG8gaW1wcm92ZSBgVGltZSNzdHJmdGltZWANCnBlcmZvcm1hbmNlLCB0aGlzIHByb2JsZW0gc2hv d2VkIHVwIGFzIHRoZSBiaWdnZXN0IGJvdHRsZW5lY2s6DQoNCiAgLSBodHRwczovL2dpdGh1Yi5j b20vcnVieS9ydWJ5L3B1bGwvMTE1NDcNCiAgLSBodHRwczovL2dpdGh1Yi5jb20vcnVieS9ydWJ5 L3B1bGwvMTE1NDQNCiAgLSBodHRwczovL2dpdGh1Yi5jb20vcnVieS9ydWJ5L3B1bGwvMTE1NDIN Cg0KIyMjIFByb3Bvc2VkIEFQSQ0KDQpJIHRoaW5rIGEgbW9yZSBlZmZjaWVudCB3YXkgdG8gZG8g dGhpcyB3b3VsZCBiZSB0byB3b3JrIHdpdGggYSBuYXRpdmUgYnVmZmVyLCBhbmQgdGhlbiBidWls ZCBhIFJTdHJpbmcNCnRoYXQgImFkb3B0IiB0aGUgbWVtb3J5IHJlZ2lvbi4NCg0KVGVjaG5pY2Fs bHksIHlvdSBjYW4gY3VycmVudGx5IGRvIHRoaXMgYnkgcmVhY2hpbmcgZGlyZWN0bHkgaW50byBg UlN0cmluZ2AgbWVtYmVycywgYnV0IEkgZG9uJ3QgdGhpbmsgaXQncyBjbGVhbiwNCmFuZCBhIGRl ZGljYXRlZCBBUEkgd291bGQgYmUgcHJlZmVyYWJsZToNCg0KYGBgYw0KLyoqDQogKiBTaW1pbGFy IHRvIHJiX3N0cl9uZXcoKSwgYnV0IGl0IGFkb3B0cyB0aGUgcG9pbnRlciBpbnN0ZWFkIG9mIGNv cHlpbmcuDQogKg0KICogQHBhcmFtW2luXSAgcHRyICAgICAgICAgICAgIEEgbWVtb3J5IHJlZ2lv biBvZiBgY2FwYWAgYnl0ZXMgbGVuZ3RoLiBNVVNUIGhhdmUgYmVlbiBhbGxvY2F0ZWQgd2l0aCBg cnVieV94bWFsbG9jYA0KICogQHBhcmFtW2luXSAgbGVuICAgICAgICAgICAgIExlbmd0aCAgb2Yg dGhlIHN0cmluZywgIGluIGJ5dGVzLCAgbm90IGluY2x1ZGluZyAgdGhlDQogKiAgICAgICAgICAg ICAgICAgICAgICAgICAgICAgdGVybWluYXRpbmcgTlVMIGNoYXJhY3Rlciwgbm90IGluY2x1ZGlu ZyBleHRyYSBjYXBhY2l0eS4NCiAqIEBwYXJhbVtpbl0gIGNhcGEgICAgICAgICAgICBUaGUgdXNh YmxlIGxlbmd0aCBvZiBgcHRyYCwgaW4gYnl0ZXMsICBpbmNsdWRpbmcgIHRoZQ0KICogICAgICAg ICAgICAgICAgICAgICAgICAgICAgIHRlcm1pbmF0aW5nIE5VTCBjaGFyYWN0ZXIuDQogKiBAcGFy YW1baW5dICBlbmMgICAgICAgICAgICAgRW5jb2Rpbmcgb2YgYHB0cmAuDQogKiBAZXhjZXB0aW9u ICByYl9lQXJnRXJyb3IgICAgYGxlbmAgaXMgbmVnYXRpdmUuDQogKiBAcmV0dXJuICAgICBBbiBp bnN0YW5jZSAgb2YgOjpyYl9jU3RyaW5nLCAgb2YgYGxlbmAgIGJ5dGVzIGxlbmd0aCwgYGNhcGEg LSAxYCBieXRlcyBjYXBhY2l0eSwNCiAqICAgICAgICAgICAgIGFuZCBvZiBgZW5jYCBlbmNvZGlu Zy4NCiAqIEBwcmUgICAgICAgIEF0ICBsZWFzdCAgYGNhcGFgIGJ5dGVzICBvZiAgY29udGludW91 cyAgbWVtb3J5IHJlZ2lvbiAgc2hhbGwgIGJlDQogKiAgICAgICAgICAgICBhY2Nlc3NpYmxlIHZp YSBgcHRyYC4NCiAqIEBwcmUgICAgICAgIGBwdHJgIE1VU1QgaGF2ZSBiZWVuIGFsbG9jYXRlZCB3 aXRoIGBydWJ5X3htYWxsb2NgLg0KICogQHByZSAgICAgICAgYHB0cmAgTVVTVCBub3QgYmUgbWFu dWFsbHkgZnJlZWQgYWZ0ZXIgYHJiX2VuY19zdHJfYWRvcHRgIGhhcyBiZWVuIGNhbGxlZC4NCiAq IEBub3RlICAgICAgIGBlbmNgIGNhbiBiZSBhICBudWxsIHBvaW50ZXIuICBJdCBjYW4gYWxzbyBi ZSAgc2VlbiBhcyBhIHJvdXRpbmUNCiAqICAgICAgICAgICAgIGlkZW50aWNhbCB0byByYl91c2Fz Y2lpX3N0cl9uZXcoKSB0aGVuLg0KICovDQpyYl9lbmNfc3RyX2Fkb3B0KGNvbnN0IGNoYXIgKnB0 ciwgbG9uZyBsZW4sIGxvbmcgY2FwYSwgcmJfZW5jb2RpbmcgKmVuYyk7DQpgYGANCg0KQW4gYWx0 ZXJuYXRpdmUgdG8gdGhlIGBhZG9wdGAgdGVybSwgY291bGQgYmUgYG1vdmVgLg0KDQoNCi0tLUZp bGVzLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0NCkNhcHR1cmUgZOKAmWXMgWNyYW4g MjAyNC0xMi0xMSBhzIAgMTEuMDMuMDgucG5nICgyNTAgS0IpDQoNCg0KLS0gDQpodHRwczovL2J1 Z3MucnVieS1sYW5nLm9yZy8NCiBfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fCiBydWJ5LWNvcmUgbWFpbGluZyBsaXN0IC0tIHJ1YnktY29yZUBtbC5ydWJ5LWxh bmcub3JnCiBUbyB1bnN1YnNjcmliZSBzZW5kIGFuIGVtYWlsIHRvIHJ1YnktY29yZS1sZWF2ZUBt bC5ydWJ5LWxhbmcub3JnCiBydWJ5LWNvcmUgaW5mbyAtLSBodHRwczovL21sLnJ1YnktbGFuZy5v cmcvbWFpbG1hbjMvbGlzdHMvcnVieS1jb3JlLm1sLnJ1YnktbGFuZy5vcmcv