PortalSetResultFormat

最新推荐文章于 2022-12-16 11:31:36 发布

Thornger

最新推荐文章于 2022-12-16 11:31:36 发布

阅读量474

点赞数

CC 4.0 BY-SA版权

分类专栏： postgresql函数笔记文章标签： PortalSetR 函数

本文链接：https://blog.youkuaiyun.com/akakakak250/article/details/64443717

postgresql函数笔记专栏收录该内容

9 篇文章

订阅专栏

本文详细解析了PortalSetResultFormat函数的功能与实现细节，该函数用于设置门户输出格式，适用于DestRemote或DestRemoteExecute类型的输出目的地。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

文章目录

#函数原型

/*
 * PortalSetResultFormat
 *	Select the format codes for a portal's output.
 *
 * This must be run after PortalStart for a portal that will be read by
 * a DestRemote or DestRemoteExecute destination.  
 * It is not presently needed for other destination types.
 *
 * formats[] is the client format request, as per Bind message conventions.
 */
void
PortalSetResultFormat(Portal portal, int nFormats, int16 *formats)
{
	int			natts;
	int			i;

	/*如果没有tuple返回的话，直接返回*/
	if (portal->tupDesc == NULL)
		return;
	/*natts代表一个表中的属性值个数，也就是列的个数*/
	natts = portal->tupDesc->natts;
	/*在指定的内存块中分配内存*/
	portal->formats = (int16 *)
		MemoryContextAlloc(PortalGetHeapMemory(portal),
						   natts * sizeof(int16));
	/*判断nFormats的个数，由调用函数传入*/
	if (nFormats > 1)
	{
		/* format specified for each column */
		if (nFormats != natts)
			ereport(ERROR,
					(errcode(ERRCODE_PROTOCOL_VIOLATION),
					 errmsg("bind message has %d result formats but query has %d columns",
							nFormats, natts)));
		/*将formats带进来的格式拷贝到结构体portal中的formats指向的内存块中
		*也就是上面分配的内存块（format为1的时候代表是text，为0时代表二进制）
		*/
		memcpy(portal->formats, formats, natts * sizeof(int16));
	}
	else if (nFormats > 0)
	{
		/* single format specified, use for all columns */
		int16		format1 = formats[0];

		for (i = 0; i < natts; i++)
			portal->formats[i] = format1;
	}
	else
	{
		/* use default format for all columns */
		for (i = 0; i < natts; i++)
			portal->formats[i] = 0;
	}
}

综上所述，次函数的作用就是将参数formats数组的值，拷贝到portal内部formats指向的内存块中。
#解释